moodle-cli 0.9.2 → 0.9.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/moodle.js CHANGED
@@ -11,7 +11,10 @@ var fields = (keys) => Object.fromEntries(keys.map((key) => [key, s]));
11
11
  var file = z.object({ name: s, url: s, requires_authentication: z.boolean().optional() });
12
12
  var activityFields = { id, name: s, type: s, unit_id: n, section_id: n, hidden: z.boolean().optional(), due: s, due_at: n, files: z.array(file).optional() };
13
13
  var activityListSchema = z.object({ ...activityFields, section: s, unit_code: s, description: s });
14
- var activitySchema = z.object({ ...activityFields, ...fields(["url", "target_url", "section", "unit_code", "description", "submission_status", "grading_status", "grade", "due_pretty", "opens_pretty", "closes_pretty", "attempts_allowed", "availability", "time_remaining", "content_text"]), files: z.array(file).optional() });
14
+ var criterion = z.object({ name: s, level: s, score: s, remark: s });
15
+ var attemptSummary = { id, status: s, started: s, completed: s, duration: s, marks: s, grade: s };
16
+ var question = z.object({ number: id, type: s, state: s, mark: s, text: s, response: s, correct: s, feedback: s });
17
+ var activitySchema = z.object({ ...activityFields, ...fields(["url", "target_url", "section", "unit_code", "description", "submission_status", "grading_status", "grade", "graded_on", "graded_by", "feedback_comments", "due_pretty", "opens_pretty", "closes_pretty", "attempts_allowed", "time_limit", "availability", "time_remaining", "content_text"]), criteria: z.array(criterion).optional(), attempts: z.array(z.object({ ...attemptSummary, number: id })).optional(), files: z.array(file).optional() });
15
18
  var sectionSchema = z.object({ id, name: s, activity_count: id, hidden: z.boolean().optional(), positional: z.boolean().optional(), activities: z.array(activityListSchema).optional() });
16
19
  var current = z.object({ id, name: s, estimated: z.boolean().optional() });
17
20
  var unitSchema = z.object({ id, code: s, name: s, start: s, end: s, start_at: n, end_at: n, hidden: z.boolean().optional(), current_section: current.optional() });
@@ -25,25 +28,30 @@ var receiptSchema = z.object({ id, name: s, unit_id: n, url: s, action: z.enum([
25
28
  var input = (shape) => z.object(shape).strict();
26
29
  var list = (key, value) => z.object({ [key]: z.array(value).optional(), total: id });
27
30
  var intentContracts = {
28
- home: { when: "dashboard", command: "moodle", what: "Today, timezone, due items and unread counts.", instead: "due for longer deadline lists", refs: "days defaults to 14", then: "unit or item", cost: "small dashboard", input: input({ days: z.number().int().min(1).max(365).default(14) }), output: z.object({ home: z.object({ today: z.string(), timezone: z.string(), timezone_source: s, name: s, siteurl: s, units: z.array(unitSchema).optional(), due: z.array(dueSchema).optional(), total: id, unread: counts.optional(), errors: z.array(z.string()).optional() }) }) },
31
+ home: { when: "dashboard", command: "moodle", what: "Today's date and timezone, items due soon, unread counts and the current section of each unit.", instead: "due for longer deadline lists", refs: "days defaults to 14", then: "unit or item", cost: "small dashboard", input: input({ days: z.number().int().min(1).max(365).default(14) }), output: z.object({ home: z.object({ today: z.string(), timezone: z.string(), timezone_source: s, name: s, siteurl: s, units: z.array(unitSchema).optional(), due: z.array(dueSchema).optional(), total: id, unread: counts.optional(), errors: z.array(z.string()).optional() }) }) },
29
32
  due: { when: "deadlines", command: "moodle due [UNIT] --days 14", what: "Items due in a date window.", instead: "item for submission details", refs: "unit code, name, id or URL", then: "item with activity_id", cost: "up to 20 rows by default", input: input({ unit: ref.optional(), days: z.number().int().min(1).max(365).default(14), limit }), output: list("due", dueSchema) },
30
33
  units: { when: "unit names", command: "moodle units", what: "Enrolled units with ids, codes and names.", instead: "unit for sections", refs: "none", then: "unit with a name or id", cost: "small list", input: input({ limit: limit.default(200) }), output: list("units", unitSchema) },
31
34
  unit: { when: "a unit or section", command: "moodle UNIT [SECTION]", what: "Section index and current section; section argument returns activities and files.", instead: "find for a named item", refs: "unit code, name, id or URL; section number or name", then: "item or file with activity id", cost: "index about 4 KB; section about 0.5 KB", input: input({ unit: ref, section: ref.optional() }), output: z.object({ unit: unitSchema, sections: z.array(sectionSchema).optional(), total: id }) },
32
35
  find: { when: "find slides or a task", command: 'moodle find "QUERY" [UNIT]', what: "Ranked sections, activities and discussion subjects.", instead: "search_forums for post text; due for deadlines", refs: "query and optional unit code, name, id or URL", then: "item or file with id", cost: "up to 20 rows by default", input: input({ query: z.string().trim().min(1), unit: ref.optional(), types: z.array(z.string()).optional(), limit }), output: list("results", activityListSchema) },
33
- item: { when: "submission or item detail", command: 'moodle UNIT "TASK"', what: "Activity due dates, status, grades, files, or latest forum threads.", instead: "file for binary content", refs: "id, same-site URL, or UNIT TASK phrase", then: "file with id or files URL", cost: "one item", input: input({ ref }), output: z.object({ item: activitySchema, threads: z.array(z.object({ id, name: s })).optional(), total: n }) },
34
- grades: { when: "my grades", command: "moodle grades [UNIT]", what: "Grades across units or in one unit.", instead: "item for submission status", refs: "optional unit code, name, id or URL", then: "item for an ungraded task", cost: "graded_only narrows output", input: input({ unit: ref.optional(), graded_only: z.boolean().default(false) }), output: list("grades", gradeSchema) },
36
+ item: { when: "submission or item detail", command: 'moodle UNIT "TASK"', what: "One activity in full: due date, status, grade, marker feedback with rubric or marking-guide rows and feedback files, attached files, quiz attempts, or a forum's latest threads.", instead: "file for binary content; attempt for quiz answers", refs: "id, same-site URL, or UNIT TASK phrase", then: "file with a file id, or attempt with an attempt id", cost: "one item", input: input({ ref }), output: z.object({ item: activitySchema, threads: z.array(z.object({ id, name: s })).optional(), total: n }) },
37
+ attempt: { when: "a quiz attempt", command: "moodle attempt ID", what: "Each question with your response, and mark, correct answer and feedback when the site shows them.", instead: "item for the attempt list", refs: "attempt id or review URL", then: "item with quiz_id", cost: "one attempt", input: input({ attempt: ref }), output: z.object({ attempt: z.object({ ...attemptSummary, quiz_id: n, unit_id: n, url: s, questions: z.array(question).optional() }) }) },
38
+ grades: { when: "my grades", command: "moodle grades [UNIT]", what: "Gradebook rows across units or in one unit, with grade, range, percentage and grader feedback.", instead: "item for submission status and rubric detail", refs: "optional unit code, name, id or URL", then: "item for an ungraded task", cost: "graded_only narrows output", input: input({ unit: ref.optional(), graded_only: z.boolean().default(false) }), output: list("grades", gradeSchema) },
35
39
  news: { when: "announcements", command: "moodle news [UNIT]", what: "Latest announcement threads with first-post text.", instead: "search_forums for other discussions", refs: "optional unit code, name, id or URL", then: "thread with discussion id", cost: "up to 5 announcements by default", input: input({ unit: ref.optional(), limit: limit.default(5) }), output: list("news", z.object({ id, name: s, unit_id: id, unit_code: s, forum_id: id, post: postSchema.optional() })) },
36
40
  thread: { when: "discussion posts", command: "moodle threads show ID", what: "A discussion and a page of compact posts, with attachment links.", instead: "news for announcements", refs: "discussion_id; offset and limit", then: "increase offset while posts_total exceeds returned", cost: "up to 20 posts by default", input: input({ discussion_id: z.number().int().positive(), limit, offset: z.number().int().nonnegative().default(0) }), output: z.object({ thread: z.object({ id, name: s, unit_id: id, forum_id: id, url: s, posts: z.array(postSchema).optional(), posts_total: id, offset: id }) }) },
37
41
  search_forums: { when: "forum post text", command: 'moodle forums search "QUERY" --unit UNIT', what: "Matching posts with unit and forum name maps.", instead: "find for activity names", refs: "query, optional unit or courseId and forumId", then: "thread with discussion_id", cost: "bounded forum scan; total covers scanned scope", input: input({ query: z.string().trim().min(1), unit: ref.optional(), courseId: z.number().int().positive().optional(), forumId: z.number().int().positive().optional(), limit, includePostText: z.boolean().default(true), titlesOnly: z.boolean().default(false), unreadOnly: z.boolean().default(false), sortBy: z.enum(["relevance", "recent"]).default("relevance"), maxForums: limit.default(20), maxDiscussionsPerForum: limit.default(50) }), output: z.object({ results: z.array(searchSchema).optional(), total: id, forums: z.record(z.string(), z.string()).optional(), units: z.record(z.string(), z.string()).optional(), scope: z.object({ max_forums: id, max_discussions_per_forum: id }) }) },
38
42
  submit: { when: "upload assignment files", command: 'moodle submit "UNIT TASK" FILE... [--final]', what: "Upload local files into an assignment; returns the receipt Moodle shows afterwards.", instead: "item for status only", refs: "assignment id, same-site URL or UNIT TASK phrase; local file paths", then: "dry_run (default) only plans; show the plan to the person, then rerun with dry_run false; final submits for grading and cannot be undone", cost: "writes to Moodle", input: input({ ref, files: z.array(z.string().trim().min(1)).max(20).default([]), final: z.boolean().default(false), replace: z.boolean().default(false), accept_statement: z.boolean().default(false), dry_run: z.boolean().default(true) }), output: z.object({ submission: receiptSchema }) },
39
- file: { when: "download a file", command: 'moodle get "UNIT TASK" --to DIR', what: "One authenticated file as embedded content, at most 16 MiB.", instead: "item for file choices", refs: "resource id, same-site URL, or UNIT TASK phrase", then: "read the returned resource", cost: "binary content up to 16 MiB", input: input({ ref }), output: z.object({ file: z.object({ name: z.string(), mime_type: z.string(), bytes: id, uri: z.string() }) }) }
43
+ file: { when: "download a file", command: 'moodle get "UNIT TASK" --to DIR', what: "One authenticated file: an image as image content, anything else as embedded binary, at most 16 MiB.", instead: "item for file choices", refs: "resource id, same-site URL, or UNIT TASK phrase", then: "read the returned image or resource", cost: "binary content up to 16 MiB", input: input({ ref }), output: z.object({ file: z.object({ name: z.string(), mime_type: z.string(), bytes: id, uri: z.string() }) }) }
40
44
  };
41
45
  function humanDescription(name) {
42
46
  return intentContracts[name].what;
43
47
  }
44
48
  function intentDescription(name) {
45
49
  const c = intentContracts[name];
46
- return `${c.what} Use when: ${c.when}. Not for: ${c.instead}. Refs: ${c.refs}. Then: ${c.then}. Cost: ${c.cost}.`;
50
+ const alternatives = c.instead.split("; ").map((rule) => {
51
+ const [tool, ...purpose] = rule.split(" for ");
52
+ return `for ${purpose.join(" for ")} call ${tool}`;
53
+ }).join("; ");
54
+ return `${c.what} Use it for ${c.when}; ${alternatives}. Input: ${c.refs}. Next: ${c.then}. Cost: ${c.cost}.`;
47
55
  }
48
56
 
49
57
  // src/results.ts
@@ -182,11 +190,17 @@ import { join as join5 } from "path";
182
190
  // src/constants.ts
183
191
  var PACKAGE_NAME = "moodle-cli";
184
192
  var NPM_LATEST_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
193
+ var GITHUB_RELEASES_URL = "https://github.com/bunizao/moodle-cli/releases/latest";
185
194
  var AJAX_SERVICE_PATH = "/lib/ajax/service.php";
186
195
  var DASHBOARD_PATH = "/my/";
187
196
  var COURSE_PATH = "/course/view.php";
188
197
  var ASSIGN_VIEW_PATH = "/mod/assign/view.php";
189
198
  var QUIZ_VIEW_PATH = "/mod/quiz/view.php";
199
+ var QUIZ_REVIEW_PATH = "/mod/quiz/review.php";
200
+ var QUIZ_START_PATH = "/mod/quiz/startattempt.php";
201
+ var QUIZ_ATTEMPT_PATH = "/mod/quiz/attempt.php";
202
+ var QUIZ_SUMMARY_PATH = "/mod/quiz/summary.php";
203
+ var QUIZ_PROCESS_PATH = "/mod/quiz/processattempt.php";
190
204
  var RESOURCE_VIEW_PATH = "/mod/resource/view.php";
191
205
  var URL_VIEW_PATH = "/mod/url/view.php";
192
206
  var PAGE_VIEW_PATH = "/mod/page/view.php";
@@ -381,16 +395,16 @@ async function findChromiumBrowser(options = {}) {
381
395
  if (options.browserPath) {
382
396
  return { name: "Chromium", path: options.browserPath };
383
397
  }
384
- const platform = options.platform ?? process.platform;
398
+ const platform2 = options.platform ?? process.platform;
385
399
  const env = options.env ?? process.env;
386
- if (platform === "linux") {
400
+ if (platform2 === "linux") {
387
401
  for (const candidate of LINUX_BROWSERS) {
388
- const resolved = resolveFromPath(candidate.path, env, platform);
402
+ const resolved = resolveFromPath(candidate.path, env, platform2);
389
403
  if (resolved) return { name: candidate.name, path: resolved };
390
404
  }
391
405
  return null;
392
406
  }
393
- const candidates = platform === "win32" ? windowsBrowsers(env) : MAC_BROWSERS;
407
+ const candidates = platform2 === "win32" ? windowsBrowsers(env) : MAC_BROWSERS;
394
408
  for (const candidate of candidates) {
395
409
  if (await isExecutable(candidate.path)) return candidate;
396
410
  }
@@ -547,9 +561,9 @@ async function isExecutable(path5) {
547
561
  return false;
548
562
  }
549
563
  }
550
- function resolveFromPath(name, env, platform) {
564
+ function resolveFromPath(name, env, platform2) {
551
565
  if (name.includes("/")) return null;
552
- const separator = platform === "win32" ? ";" : ":";
566
+ const separator = platform2 === "win32" ? ";" : ":";
553
567
  for (const dir of (env.PATH ?? "").split(separator).filter(Boolean)) {
554
568
  const candidate = join2(dir, name);
555
569
  try {
@@ -841,6 +855,14 @@ function createDeploymentCredentials(createToken) {
841
855
  function isUnavailable(error) {
842
856
  return error instanceof CredentialBackendUnavailableError;
843
857
  }
858
+ async function readCredentialsForReport(read) {
859
+ try {
860
+ return { value: await read(), available: true };
861
+ } catch (error) {
862
+ if (!isUnavailable(error)) throw error;
863
+ return { value: null, available: false };
864
+ }
865
+ }
844
866
 
845
867
  // src/mcp/credentials/node-store.ts
846
868
  var SERVICE = "moodle-cli-mcp";
@@ -1252,13 +1274,13 @@ var PrivateFileCredentialBackend = class {
1252
1274
  }
1253
1275
  };
1254
1276
  function createDefaultCredentialStore(options = {}) {
1255
- const platform = options.platform ?? process.platform;
1277
+ const platform2 = options.platform ?? process.platform;
1256
1278
  const runner = options.runner ?? new NodeCredentialCommandRunner();
1257
- const preferred = platform === "darwin" ? new MacOSKeychainCredentialBackend(runner) : platform === "linux" ? new LinuxSecretServiceCredentialBackend(runner) : platform === "win32" ? new WindowsCredentialManagerBackend(runner) : new UnavailableCredentialBackend(`${platform} credential store`);
1279
+ const preferred = platform2 === "darwin" ? new MacOSKeychainCredentialBackend(runner) : platform2 === "linux" ? new LinuxSecretServiceCredentialBackend(runner) : platform2 === "win32" ? new WindowsCredentialManagerBackend(runner) : new UnavailableCredentialBackend(`${platform2} credential store`);
1258
1280
  const home = options.homeDirectory ?? homedir3();
1259
- const fallbackDirectory = platform === "win32" ? windowsPath.join(home, "AppData", "Local", "moodle-cli", "credentials") : join3(home, ".config", "moodle-cli", "mcp", "credentials");
1260
- const fallback = platform === "win32" ? new WindowsDpapiFileCredentialBackend(fallbackDirectory, runner) : new PrivateFileCredentialBackend(fallbackDirectory);
1261
- return new SafeCredentialStore(preferred, fallback, platform !== "win32");
1281
+ const fallbackDirectory = platform2 === "win32" ? windowsPath.join(home, "AppData", "Local", "moodle-cli", "credentials") : join3(home, ".config", "moodle-cli", "mcp", "credentials");
1282
+ const fallback = platform2 === "win32" ? new WindowsDpapiFileCredentialBackend(fallbackDirectory, runner) : new PrivateFileCredentialBackend(fallbackDirectory);
1283
+ return new SafeCredentialStore(preferred, fallback, platform2 !== "win32");
1262
1284
  }
1263
1285
  function parseCredentials(value) {
1264
1286
  const parsed = JSON.parse(value);
@@ -1764,11 +1786,11 @@ async function defaultBrowserCookieProvider(baseUrl, options = {}) {
1764
1786
  }
1765
1787
  async function braveProfilePaths(options = {}) {
1766
1788
  const home = options.homeDir ?? homedir5();
1767
- const platform = options.platform ?? process.platform;
1768
- const roots = platform === "linux" ? [
1789
+ const platform2 = options.platform ?? process.platform;
1790
+ const roots = platform2 === "linux" ? [
1769
1791
  join5(home, ".config/BraveSoftware/Brave-Browser"),
1770
1792
  join5(home, ".var/app/com.brave.Browser/config/BraveSoftware/Brave-Browser")
1771
- ] : platform === "win32" ? [join5(home, "AppData/Local/BraveSoftware/Brave-Browser/User Data")] : platform === "darwin" ? [join5(home, "Library/Application Support/BraveSoftware/Brave-Browser")] : [];
1793
+ ] : platform2 === "win32" ? [join5(home, "AppData/Local/BraveSoftware/Brave-Browser/User Data")] : platform2 === "darwin" ? [join5(home, "Library/Application Support/BraveSoftware/Brave-Browser")] : [];
1772
1794
  const profiles = [];
1773
1795
  for (const root of roots) {
1774
1796
  try {
@@ -1802,8 +1824,8 @@ var MINIMUM_NODE_FOR_BROWSER_COOKIES = "22.13.0";
1802
1824
  function cookieAccessBlocked(warnings) {
1803
1825
  return warnings.some((warning) => COOKIE_ACCESS_DENIED.test(warning) || COOKIE_SQLITE_UNAVAILABLE.test(warning));
1804
1826
  }
1805
- function cookieAccessHint(warnings, platform = process.platform, unreadable = [], env = process.env) {
1806
- const grant = platform === "darwin" ? [
1827
+ function cookieAccessHint(warnings, platform2 = process.platform, unreadable = [], env = process.env) {
1828
+ const grant = platform2 === "darwin" ? [
1807
1829
  `Grant Full Disk Access to ${hostApplicationName(env) ?? "the application running this command"}, then restart it:`,
1808
1830
  ` open "${FULL_DISK_ACCESS_PANE}"`
1809
1831
  ].join("\n") : "Run this command as the user that owns the browser profile, or grant it read access to the browser cookie store.";
@@ -1835,9 +1857,9 @@ function cookieDiagnostics(warnings, unreadable) {
1835
1857
  ];
1836
1858
  return lines.length ? ["", "Cookie store diagnostics:", ...lines] : [];
1837
1859
  }
1838
- function authFailureHint(baseUrl, cookieWarnings = [], platform = process.platform, unreadable = [], env = process.env) {
1860
+ function authFailureHint(baseUrl, cookieWarnings = [], platform2 = process.platform, unreadable = [], env = process.env) {
1839
1861
  if (cookieAccessBlocked(cookieWarnings) || unreadable.length) {
1840
- return cookieAccessHint(cookieWarnings, platform, unreadable, env);
1862
+ return cookieAccessHint(cookieWarnings, platform2, unreadable, env);
1841
1863
  }
1842
1864
  return [
1843
1865
  `Log in to ${loginUrl(baseUrl)} in your browser, then rerun the command.`,
@@ -2444,8 +2466,8 @@ function buildKeepalivePlist(programArguments2, intervalMinutes, logPath) {
2444
2466
  ].join("\n");
2445
2467
  }
2446
2468
  async function installKeepalive(options = {}) {
2447
- const platform = options.platform ?? process.platform;
2448
- if (platform !== "darwin") {
2469
+ const platform2 = options.platform ?? process.platform;
2470
+ if (platform2 !== "darwin") {
2449
2471
  throw new Error(
2450
2472
  "Automatic keepalive install requires macOS launchd. Add a cron entry instead: */30 * * * * moodle auth keepalive --json"
2451
2473
  );
@@ -2556,8 +2578,8 @@ async function doctor(options = {}) {
2556
2578
  }
2557
2579
 
2558
2580
  // src/cli.ts
2559
- import { rm as rm7, readdir as readdir4 } from "fs/promises";
2560
- import { homedir as homedir15 } from "os";
2581
+ import { readFile as readFile11, rm as rm8, readdir as readdir4 } from "fs/promises";
2582
+ import { homedir as homedir16 } from "os";
2561
2583
 
2562
2584
  // src/mcp/renewal/decision.ts
2563
2585
  function decideRenewal(snapshot) {
@@ -2674,6 +2696,19 @@ var RenewalInstaller = class {
2674
2696
  }
2675
2697
  }
2676
2698
  };
2699
+ function describeRenewalJob(platform2, homeDirectory, profile, intervalMinutes = 30) {
2700
+ const schedule = `silent check every ${intervalMinutes} minutes`;
2701
+ if (platform2 === "darwin") {
2702
+ const label2 = `com.moodle-cli.mcp-renewal.${profile}`;
2703
+ return { scheduler: "launchd agent", label: label2, schedule, log: `${trimEnd(homeDirectory, "/")}/Library/Logs/${label2}.log` };
2704
+ }
2705
+ if (platform2 === "linux") {
2706
+ const label2 = `moodle-cli-mcp-renewal-${profile}`;
2707
+ return { scheduler: "systemd user timer", label: label2, schedule, log: `journalctl --user -u ${label2}` };
2708
+ }
2709
+ const label = `Moodle CLI MCP Renewal (${profile})`;
2710
+ return { scheduler: "Task Scheduler task", label, schedule, log: "Task Scheduler history" };
2711
+ }
2677
2712
  function buildRenewalInstallPlan(options) {
2678
2713
  validateOptions(options);
2679
2714
  const intervalMinutes = options.intervalMinutes ?? 30;
@@ -2883,13 +2918,13 @@ var NodeRenewalInstallerIO = class {
2883
2918
  }
2884
2919
  };
2885
2920
  function createDefaultRenewalInstaller(profile, options = {}) {
2886
- const platform = options.platform ?? process.platform;
2887
- if (!isSupportedPlatform(platform)) {
2888
- throw new Error(`Moodle MCP renewal is not supported on ${platform}`);
2921
+ const platform2 = options.platform ?? process.platform;
2922
+ if (!isSupportedPlatform(platform2)) {
2923
+ throw new Error(`Moodle MCP renewal is not supported on ${platform2}`);
2889
2924
  }
2890
2925
  const runtime = runtimeCommand(options.executable, options.executableArgs);
2891
2926
  const plan = buildRenewalInstallPlan({
2892
- platform,
2927
+ platform: platform2,
2893
2928
  profile,
2894
2929
  executable: runtime.command,
2895
2930
  executableArgs: runtime.args,
@@ -2915,8 +2950,8 @@ var DefaultRenewalIntegration = class {
2915
2950
  }
2916
2951
  };
2917
2952
  var NodeRenewalNotificationSender = class {
2918
- constructor(platform = process.platform) {
2919
- this.platform = platform;
2953
+ constructor(platform2 = process.platform) {
2954
+ this.platform = platform2;
2920
2955
  }
2921
2956
  platform;
2922
2957
  async send(notification) {
@@ -2960,11 +2995,11 @@ var NodeRenewalNotificationSender = class {
2960
2995
  }
2961
2996
  }
2962
2997
  };
2963
- function notifyRenewalSignInRequired(platform = process.platform) {
2964
- return sendRenewalNotification("sign_in_required", new NodeRenewalNotificationSender(platform));
2998
+ function notifyRenewalSignInRequired(platform2 = process.platform) {
2999
+ return sendRenewalNotification("sign_in_required", new NodeRenewalNotificationSender(platform2));
2965
3000
  }
2966
- function isSupportedPlatform(platform) {
2967
- return platform === "darwin" || platform === "linux" || platform === "win32";
3001
+ function isSupportedPlatform(platform2) {
3002
+ return platform2 === "darwin" || platform2 === "linux" || platform2 === "win32";
2968
3003
  }
2969
3004
  function isMissing2(error) {
2970
3005
  return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
@@ -3006,6 +3041,7 @@ function createMoodleGateway(client, hooks = {}) {
3006
3041
  return limit2 === void 0 ? activities : activities.slice(0, limit2);
3007
3042
  },
3008
3043
  getActivity: ({ activityId }) => client.getActivity(activityId),
3044
+ ...client.getQuizAttempt ? { getQuizAttempt: (attemptId) => client.getQuizAttempt(attemptId) } : {},
3009
3045
  getGrades: ({ courseId }) => client.getCourseGrades(courseId),
3010
3046
  async listForums({ courseId, limit: limit2 }) {
3011
3047
  const forums = await client.getForums(courseId);
@@ -3046,7 +3082,9 @@ function createMoodleGateway(client, hooks = {}) {
3046
3082
  name,
3047
3083
  mimeType: contentType(response),
3048
3084
  bytes: content.byteLength,
3049
- uri: publicFileUrl(response.url || target.url),
3085
+ // The Moodle-origin URL, never the post-redirect CDN one: stripping query parameters from
3086
+ // a signed CDN link leaves an address that can only ever answer MissingKey.
3087
+ uri: publicFileUrl(target.url),
3050
3088
  blob: encodeBase64(content)
3051
3089
  };
3052
3090
  }
@@ -3411,6 +3449,15 @@ function createIntentService(gateway, now = () => Date.now()) {
3411
3449
  result = { item: { ...itemRow(activity), ...due }, threads: threads?.slice(0, 20).map((t) => ({ id: t.id, name: t.subject })), total: threads?.length };
3412
3450
  break;
3413
3451
  }
3452
+ case "attempt": {
3453
+ if (!gateway.getQuizAttempt) throw new ReferenceError("not_found", "This gateway cannot read quiz attempts.", []);
3454
+ const raw = String(input2.attempt);
3455
+ const id2 = raw.includes("://") ? Number(new URL(raw).searchParams.get("attempt")) : Number(raw);
3456
+ if (!Number.isInteger(id2) || id2 <= 0) throw new ReferenceError("not_found", "Use a quiz attempt id or a review URL with ?attempt=.", []);
3457
+ const { course_id, questions, ...attempt } = await gateway.getQuizAttempt(id2);
3458
+ result = { attempt: { ...attempt, unit_id: course_id || void 0, questions } };
3459
+ break;
3460
+ }
3414
3461
  case "home":
3415
3462
  case "due": {
3416
3463
  const data = name === "due" && gateway.getDue ? { user: await user(), courses: await courses(), todo: await gateway.getDue(Number(input2.days)), errors: [] } : await overview(Number(input2.days));
@@ -3541,12 +3588,12 @@ function renderTerminalTable(columns, rows, options = {}) {
3541
3588
  const minimum = widths.reduce((n2, w, i) => n2 + (flexible.includes(i) ? 8 : w), 0) + columns.length * 3 + 1;
3542
3589
  const title = options.title ? [theme.subject(sanitizeTerminalText(options.title))] : [];
3543
3590
  if (width < 60 || minimum > width) {
3544
- const wrap = (line2) => Array.from(line2).reduce((lines, char) => {
3591
+ const wrap2 = (line2) => Array.from(line2).reduce((lines, char) => {
3545
3592
  if (!lines.length || Array.from(lines.at(-1)).length >= width) lines.push("");
3546
3593
  lines[lines.length - 1] += char;
3547
3594
  return lines;
3548
3595
  }, []);
3549
- return [...title, ...clean.flatMap((row) => [...columns.flatMap((c, i) => wrap(`${c.label}: ${row[i]}`)), ""])].join("\n").trimEnd();
3596
+ return [...title, ...clean.flatMap((row) => [...columns.flatMap((c, i) => wrap2(`${c.label}: ${row[i]}`)), ""])].join("\n").trimEnd();
3550
3597
  }
3551
3598
  while (widths.reduce((n2, v) => n2 + v, 0) + columns.length * 3 + 1 > width) {
3552
3599
  const index = flexible.reduce((best, i) => widths[i] > (widths[best] ?? 0) ? i : best, -1);
@@ -3670,9 +3717,20 @@ function renderScreen(data, options = {}) {
3670
3717
  const i = record(data.item);
3671
3718
  lines.push(`${text(i.name)} \xB7 ${text(i.type)} \xB7 #${i.id}`);
3672
3719
  for (const [k, v] of Object.entries(i)) if (!["id", "name", "type", "files"].includes(k) && !k.endsWith("_at") && typeof v !== "object") lines.push(`${k.replaceAll("_", " ")}: ${moment(v, now)}`);
3720
+ for (const a of array(i.attempts)) lines.push(`Attempt ${a.number} \xB7 #${a.id} ${[a.status, a.marks, a.grade, a.completed].map(text).filter(Boolean).join(" \xB7 ")}`);
3721
+ for (const c of array(i.criteria)) lines.push(`${text(c.name)} ${[c.score, c.level, c.remark].map(text).filter(Boolean).join(" \xB7 ")}`);
3673
3722
  for (const f of array(i.files)) lines.push(`File ${text(f.name)} ${text(f.url)}`);
3674
3723
  if (data.threads) rows(array(data.threads), "Threads");
3675
3724
  next = [`moodle get ${i.id} --to DIR`];
3725
+ } else if (data.attempt) {
3726
+ const a = record(data.attempt);
3727
+ lines.push(`Attempt #${a.id} \xB7 ${[a.status, a.marks, a.grade].map(text).filter(Boolean).join(" \xB7 ")}`);
3728
+ for (const q of array(a.questions)) {
3729
+ lines.push("", `Q${q.number} \xB7 ${[q.type, q.state, q.mark].map(text).filter(Boolean).join(" \xB7 ")}`, text(q.text), `You: ${text(q.response)}`);
3730
+ if (q.correct) lines.push(`Correct: ${text(q.correct)}`);
3731
+ if (q.feedback) lines.push(`Feedback: ${text(q.feedback)}`);
3732
+ }
3733
+ next = [`moodle item ${a.quiz_id}`];
3676
3734
  } else if (data.thread) {
3677
3735
  const t = record(data.thread);
3678
3736
  lines.push(text(t.name));
@@ -3713,7 +3771,7 @@ function renderScreen(data, options = {}) {
3713
3771
  }
3714
3772
 
3715
3773
  // src/cli.ts
3716
- import { spawn as spawn4 } from "child_process";
3774
+ import { spawn as spawn5 } from "child_process";
3717
3775
  import {
3718
3776
  banner,
3719
3777
  colorEnabled as colorEnabled2,
@@ -3734,7 +3792,7 @@ import {
3734
3792
  mutating,
3735
3793
  writeOutput
3736
3794
  } from "@bunizao/cli-kit";
3737
- import { realpathSync as realpathSync3 } from "fs";
3795
+ import { realpathSync as realpathSync4 } from "fs";
3738
3796
  import path4 from "path";
3739
3797
  import { fileURLToPath as fileURLToPath2 } from "url";
3740
3798
 
@@ -4038,6 +4096,8 @@ function parseGradeOverviewRows(html, baseUrl) {
4038
4096
  return rows;
4039
4097
  }
4040
4098
  function parseAssignmentHtml(html, assignmentId, baseUrl) {
4099
+ const root = parse3(html);
4100
+ const feedback = root.querySelector(".feedback");
4041
4101
  return {
4042
4102
  id: assignmentId,
4043
4103
  name: pageTitle(html),
@@ -4047,9 +4107,39 @@ function parseAssignmentHtml(html, assignmentId, baseUrl) {
4047
4107
  grading_status: findTableValue(html, "Grading status"),
4048
4108
  time_remaining: findTableValue(html, "Time remaining"),
4049
4109
  grade: findTableValue(html, "Grade"),
4110
+ graded_on: feedback ? findTableValue(feedback.toString(), "Graded on") : "",
4111
+ graded_by: feedback ? findTableValue(feedback.toString(), "Graded by") : "",
4112
+ feedback_comments: feedback ? findTableValue(feedback.toString(), "Feedback comments") : "",
4113
+ criteria: feedback ? parseFeedbackCriteria(feedback) : [],
4114
+ file_entries: feedback ? parseFeedbackFiles(feedback, baseUrl) : [],
4050
4115
  url: `${baseUrl.replace(/\/$/, "")}/mod/assign/view.php?id=${assignmentId}`
4051
4116
  };
4052
4117
  }
4118
+ function parseFeedbackCriteria(feedback) {
4119
+ const criteria = [];
4120
+ for (const row of feedback.querySelectorAll("tr.criterion")) {
4121
+ const level = row.querySelector("td.level.checked");
4122
+ const name = cleanNodeText(row.querySelector(".criterionshortname") ?? row.querySelector("td.description"));
4123
+ if (!name) continue;
4124
+ criteria.push({
4125
+ name,
4126
+ level: cleanNodeText(level?.querySelector(".definition")),
4127
+ score: cleanNodeText(row.querySelector("td.score") ?? level?.querySelector(".score")),
4128
+ remark: cleanTableCell(row.querySelector("td.remark"))
4129
+ });
4130
+ }
4131
+ return criteria;
4132
+ }
4133
+ function parseFeedbackFiles(feedback, baseUrl) {
4134
+ const entries = [];
4135
+ for (const link2 of feedback.querySelectorAll('a[href*="pluginfile.php"]')) {
4136
+ const url = resolveUrl(baseUrl, link2.getAttribute("href") ?? "");
4137
+ const label = cleanNodeText(link2);
4138
+ const name = /\.\w{1,5}$/u.test(label) ? label : decodeURIComponent(new URL(url).pathname.split("/").at(-1) || "file");
4139
+ if (!entries.some((entry) => entry.url === url)) entries.push(fileEntry(name, url, baseUrl));
4140
+ }
4141
+ return entries;
4142
+ }
4053
4143
  function parseQuizHtml(html, quizId, baseUrl) {
4054
4144
  const root = parse3(html);
4055
4145
  return {
@@ -4058,12 +4148,85 @@ function parseQuizHtml(html, quizId, baseUrl) {
4058
4148
  ...activityContext(html),
4059
4149
  opens_pretty: extractLabeledText(html, "Opens:"),
4060
4150
  closes_pretty: extractLabeledText(html, "Closes:"),
4061
- attempts_allowed: cleanText(root.textContent.match(/Attempts allowed:\s*([^\n]+)/i)?.[1] ?? ""),
4151
+ attempts_allowed: labeledParagraph(root, "Attempts allowed:"),
4152
+ time_limit: labeledParagraph(root, "Time limit:"),
4062
4153
  availability: cleanText(root.textContent.match(/This quiz is currently[^\n]+/i)?.[0] ?? ""),
4063
4154
  grade: findTableValue(html, "Grade"),
4155
+ attempts: parseQuizAttempts(root, baseUrl),
4064
4156
  url: `${baseUrl.replace(/\/$/, "")}/mod/quiz/view.php?id=${quizId}`
4065
4157
  };
4066
4158
  }
4159
+ function labeledParagraph(root, label) {
4160
+ for (const p of root.querySelectorAll("p")) {
4161
+ const line = cleanNodeText(p);
4162
+ if (line.startsWith(label)) return cleanText(line.slice(label.length));
4163
+ }
4164
+ return "";
4165
+ }
4166
+ function parseQuizAttempts(root, baseUrl) {
4167
+ const attempts = [];
4168
+ for (const table of root.querySelectorAll("table.quizreviewsummary")) {
4169
+ const card = table.closest(".card") ?? table.parentNode;
4170
+ const link2 = card?.querySelector('a[href*="/mod/quiz/review.php"]');
4171
+ const reviewUrl = link2 ? resolveUrl(baseUrl, link2.getAttribute("href") ?? "") : "";
4172
+ const id2 = numberQueryValue(reviewUrl, "attempt");
4173
+ if (!link2 || id2 === null) continue;
4174
+ const summary = tableValues(table);
4175
+ const number = Number(cleanNodeText(card?.querySelector(".card-title")).match(/\d+/)?.[0] ?? attempts.length + 1);
4176
+ attempts.push({ id: id2, number, status: summary.Status ?? "", started: summary.Started ?? "", completed: summary.Completed ?? "", duration: summary.Duration ?? "", marks: summary.Marks ?? "", grade: summary.Grade ?? "", review_url: reviewUrl });
4177
+ }
4178
+ return attempts;
4179
+ }
4180
+ function parseQuizReviewHtml(html, attemptId, baseUrl) {
4181
+ const root = parse3(html);
4182
+ const summary = tableValues(root.querySelector("table.quizreviewsummary"));
4183
+ const form = root.querySelector("form.questionflagsaveform");
4184
+ const url = `${baseUrl.replace(/\/$/, "")}/mod/quiz/review.php?attempt=${attemptId}`;
4185
+ return {
4186
+ id: attemptId,
4187
+ quiz_id: numberQueryValue(form?.getAttribute("action") ?? "", "cmid") ?? 0,
4188
+ course_id: parseCourseIdFromPageHtml(html) ?? 0,
4189
+ status: summary.Status ?? "",
4190
+ started: summary.Started ?? "",
4191
+ completed: summary.Completed ?? "",
4192
+ duration: summary.Duration ?? "",
4193
+ marks: summary.Marks ?? "",
4194
+ grade: summary.Grade ?? "",
4195
+ questions: root.querySelectorAll("div.que").map(parseQuizQuestion),
4196
+ url
4197
+ };
4198
+ }
4199
+ function parseQuizQuestion(que) {
4200
+ const answer = que.querySelector(".answer");
4201
+ const picked = answer?.querySelectorAll("input:checked, input[checked]").map((input2) => {
4202
+ const label = input2.getAttribute("aria-labelledby");
4203
+ return cleanTableCell(label ? que.querySelector(`[id="${label}"]`) : input2.parentNode);
4204
+ }).filter(Boolean) ?? [];
4205
+ const typed = cleanText(que.querySelector('input[type="text"], input[type="number"]')?.getAttribute("value") ?? "");
4206
+ const response = picked.length ? picked.join("; ") : typed || blockText(answer?.querySelector(".qtype_essay_response") ?? answer);
4207
+ return {
4208
+ number: Number(cleanNodeText(que.querySelector(".qno")) || 0),
4209
+ type: que.classList.value[1] ?? "",
4210
+ state: cleanNodeText(que.querySelector(".info .state")),
4211
+ mark: cleanNodeText(que.querySelector(".info .grade")).replace(/^Mark\s+/u, ""),
4212
+ text: blockText(que.querySelector(".qtext")),
4213
+ response: response.replace(/\s*Word count: \d+$/u, ""),
4214
+ correct: blockText(que.querySelector(".rightanswer")).replace(/^The correct answers? (?:is|are):?\s*/iu, "").replace(/^'(.*)'\.?$/u, "$1"),
4215
+ feedback: blockText(que.querySelector(".outcome .feedback"))
4216
+ };
4217
+ }
4218
+ function blockText(node) {
4219
+ if (!node) return "";
4220
+ return cleanTableCell(parse3(node.toString().replace(/<br\s*\/?>|<\/(?:p|div|li|h\d|tr)>/giu, "$& ")));
4221
+ }
4222
+ function tableValues(table) {
4223
+ const values = {};
4224
+ for (const row of table?.querySelectorAll("tr") ?? []) {
4225
+ const cells = row.querySelectorAll("th, td");
4226
+ if (cells.length >= 2) values[cleanNodeText(cells[0])] = cleanTableCell(cells[1]);
4227
+ }
4228
+ return values;
4229
+ }
4067
4230
  function parseResourceHtml(html, resourceId, baseUrl) {
4068
4231
  const root = parse3(html);
4069
4232
  const link2 = root.querySelector(".resourceworkaround a[href], .resourcecontent a[href], a.resourceworkaround[href]");
@@ -4243,12 +4406,12 @@ function parseForumGroupsHtml(html) {
4243
4406
  }
4244
4407
  const groups = [];
4245
4408
  const seen = /* @__PURE__ */ new Set();
4246
- for (const option of select.querySelectorAll("option")) {
4247
- const groupId = safeInt(option.getAttribute("value"));
4409
+ for (const option2 of select.querySelectorAll("option")) {
4410
+ const groupId = safeInt(option2.getAttribute("value"));
4248
4411
  if (!groupId) {
4249
4412
  continue;
4250
4413
  }
4251
- const groupName = cleanNodeText(option);
4414
+ const groupName = cleanNodeText(option2);
4252
4415
  const key = `${groupId}:${groupName}`;
4253
4416
  if (seen.has(key)) {
4254
4417
  continue;
@@ -4268,9 +4431,9 @@ function selectedGroupName(root, groupId) {
4268
4431
  return "";
4269
4432
  }
4270
4433
  for (const selector of ["select[name='groupinfo']", "select[name='group']"]) {
4271
- const option = root.querySelector(selector)?.querySelector(`option[value='${groupId}']`) ?? null;
4272
- if (option) {
4273
- return cleanNodeText(option);
4434
+ const option2 = root.querySelector(selector)?.querySelector(`option[value='${groupId}']`) ?? null;
4435
+ if (option2) {
4436
+ return cleanNodeText(option2);
4274
4437
  }
4275
4438
  }
4276
4439
  return "";
@@ -4386,7 +4549,7 @@ function cleanTableCell(node) {
4386
4549
  return "";
4387
4550
  }
4388
4551
  const clone = parse3(node.toString());
4389
- for (const unwanted of clone.querySelectorAll(".action-menu, .dropdown, script, style")) {
4552
+ for (const unwanted of clone.querySelectorAll(".action-menu, .dropdown, .hidden, .accesshide, script, style")) {
4390
4553
  unwanted.remove();
4391
4554
  }
4392
4555
  return cleanText(clone.textContent.replace("( Empty )", "(Empty)"));
@@ -4604,7 +4767,7 @@ function formFields(form) {
4604
4767
  }
4605
4768
  if (tag === "select") {
4606
4769
  const options = element.querySelectorAll("option");
4607
- const chosen = options.find((option) => option.hasAttribute("selected")) ?? options[0];
4770
+ const chosen = options.find((option2) => option2.hasAttribute("selected")) ?? options[0];
4608
4771
  if (chosen) fields2.push([name, chosen.getAttribute("value") ?? cleanText(chosen.textContent)]);
4609
4772
  continue;
4610
4773
  }
@@ -4778,6 +4941,292 @@ function record2(value) {
4778
4941
  return isRecord4(value) ? value : {};
4779
4942
  }
4780
4943
 
4944
+ // src/moodle-quiz-core.ts
4945
+ import { parse as parse5 } from "node-html-parser";
4946
+ async function startQuizAttempt(deps, quizId, options = {}) {
4947
+ if (!Number.isSafeInteger(quizId) || quizId <= 0) throw deps.usage("The quiz id must be a positive integer.");
4948
+ const viewUrl = `${deps.baseUrl}${QUIZ_VIEW_PATH}?id=${quizId}`;
4949
+ const viewHtml = await pageText2(deps, viewUrl);
4950
+ const root = parse5(viewHtml);
4951
+ if (/safeexambrowser|Safe Exam Browser/iu.test(viewHtml)) throw deps.usage("This quiz requires the Safe Exam Browser, which the CLI cannot provide.", "Open it in the browser Moodle asks for.");
4952
+ const resume = formWithAction2(root, QUIZ_ATTEMPT_PATH) ?? root.querySelector(`a[href*="${QUIZ_ATTEMPT_PATH}?"]`);
4953
+ if (resume) {
4954
+ const target = resume.tagName.toLowerCase() === "form" ? `${resolveUrl(deps.baseUrl, resume.getAttribute("action") ?? "")}?${new URLSearchParams(formFields2(resume)).toString()}` : resolveUrl(deps.baseUrl, resume.getAttribute("href") ?? "");
4955
+ const attempt = numberParam(target, "attempt");
4956
+ if (attempt) return getAttemptPage(deps, attempt, quizId, 0);
4957
+ }
4958
+ const start = formWithAction2(root, QUIZ_START_PATH);
4959
+ if (!start) {
4960
+ const reason = cleanText(root.querySelector(".quizattempt, .quizinfo")?.textContent) || "the quiz page shows no attempt button";
4961
+ throw deps.usage(`Moodle offers no new attempt: ${reason}`, `See ${viewUrl}`);
4962
+ }
4963
+ let response = await deps.request(resolveUrl(deps.baseUrl, start.getAttribute("action") ?? ""), postInit(formFields2(start)));
4964
+ let html = await response.text();
4965
+ if (!onPath(response.url, QUIZ_ATTEMPT_PATH)) {
4966
+ const preflight = formWithAction2(parse5(html), QUIZ_START_PATH);
4967
+ if (!preflight) throw deps.fail(`Moodle did not start the attempt: ${noticesOf2(html) || "it returned an unexpected page"}`);
4968
+ const fields2 = [...formFields2(preflight).filter(([name]) => name !== "quizpassword"), ["submitbutton", "Start attempt"]];
4969
+ if (preflight.querySelector("input[name=quizpassword]")) {
4970
+ const password = options.password ? await options.password() : null;
4971
+ if (!password) throw deps.usage("This quiz needs its access password to start.", "Run moodle quiz start again at a terminal to be asked for it, or pass --password.");
4972
+ fields2.push(["quizpassword", password]);
4973
+ }
4974
+ response = await deps.request(resolveUrl(deps.baseUrl, preflight.getAttribute("action") ?? ""), postInit(fields2));
4975
+ html = await response.text();
4976
+ if (!onPath(response.url, QUIZ_ATTEMPT_PATH)) throw deps.fail(`Moodle did not start the attempt: ${noticesOf2(html) || "it returned the pre-flight form again"}`);
4977
+ }
4978
+ return withoutForm(parseAttemptPage(html, response.url, deps));
4979
+ }
4980
+ async function getAttemptPage(deps, attemptId, quizId, page) {
4981
+ return withoutForm(await loadAttemptPage(deps, attemptId, quizId, page));
4982
+ }
4983
+ async function loadAttemptPage(deps, attemptId, quizId, page) {
4984
+ const url = attemptUrl(deps.baseUrl, attemptId, quizId, page);
4985
+ const response = await deps.request(url);
4986
+ const html = await response.text();
4987
+ if (onPath(response.url, QUIZ_REVIEW_PATH)) throw deps.usage(`Attempt ${attemptId} is already finished.`, `Its review is at ${response.url}`);
4988
+ if (!onPath(response.url, QUIZ_ATTEMPT_PATH)) throw deps.fail(`Moodle did not show attempt ${attemptId}: ${noticesOf2(html) || "it redirected elsewhere"}`);
4989
+ return parseAttemptPage(html, response.url, deps);
4990
+ }
4991
+ function withoutForm({ form: _form, ...page }) {
4992
+ return page;
4993
+ }
4994
+ async function answerQuizQuestion(deps, request) {
4995
+ const first2 = await loadAttemptPage(deps, request.attemptId, request.quizId, 0);
4996
+ const entry = first2.navigation.find((item) => item.number === request.question.trim());
4997
+ if (!entry) throw deps.usage(`Attempt ${request.attemptId} has no question ${request.question}.`, `Questions: ${first2.navigation.map((item) => item.number).join(", ")}`);
4998
+ const page = entry.page === first2.page ? first2 : await loadAttemptPage(deps, request.attemptId, request.quizId, entry.page);
4999
+ const question2 = page.questions.find((item) => item.slot === entry.slot);
5000
+ if (!question2) throw deps.fail(`Page ${entry.page + 1} does not contain question ${request.question}.`);
5001
+ const fields2 = encodeAnswer(deps, page.form, question2, request.value);
5002
+ const replay = fields2.map(([name, value]) => name === "nextpage" ? [name, String(page.page)] : [name, value]);
5003
+ const response = await deps.request(page.form.action, postInit(replay));
5004
+ const html = await response.text();
5005
+ if (!onPath(response.url, QUIZ_ATTEMPT_PATH)) throw deps.fail(`Moodle did not save the answer: ${noticesOf2(html) || "it left the attempt page"}`);
5006
+ const after = parseAttemptPage(html, response.url, deps);
5007
+ const saved = after.questions.find((item) => item.slot === question2.slot);
5008
+ if (!saved || /not yet answered|not answered/iu.test(saved.state)) throw deps.fail(`Moodle accepted the post but still reports question ${request.question} as "${saved?.state || "missing"}".`);
5009
+ return withoutForm(after);
5010
+ }
5011
+ async function getAttemptSummary(deps, attemptId, quizId) {
5012
+ const { form: _form, ...summary } = await loadAttemptSummary(deps, attemptId, quizId);
5013
+ return summary;
5014
+ }
5015
+ async function loadAttemptSummary(deps, attemptId, quizId) {
5016
+ const url = `${deps.baseUrl}${QUIZ_SUMMARY_PATH}?attempt=${attemptId}&cmid=${quizId}`;
5017
+ const response = await deps.request(url);
5018
+ const html = await response.text();
5019
+ if (onPath(response.url, QUIZ_REVIEW_PATH)) throw deps.usage(`Attempt ${attemptId} is already finished.`, `Its review is at ${response.url}`);
5020
+ const root = parse5(html);
5021
+ const rows = root.querySelectorAll("table.quizsummaryofattempt tbody tr").flatMap((row) => {
5022
+ const cells = row.querySelectorAll("td");
5023
+ if (cells.length < 2) return [];
5024
+ const link2 = cells[0].querySelector("a")?.getAttribute("href") ?? "";
5025
+ return [{ number: cleanText(cells[0].textContent), state: cleanText(cells[1].textContent), page: numberParam(link2, "page") ?? 0 }];
5026
+ });
5027
+ const finish = root.querySelector("form#frm-finishattempt") ?? formWithAction2(root, QUIZ_PROCESS_PATH);
5028
+ if (!finish || !rows.length) throw deps.fail(`Moodle did not show the summary of attempt ${attemptId}: ${noticesOf2(html) || "the page has no finish button"}`);
5029
+ const form = { action: resolveUrl(deps.baseUrl, finish.getAttribute("action") ?? ""), fields: formFields2(finish) };
5030
+ return { attempt: attemptId, quiz_id: quizId, name: pageHeading(root), rows, url, form };
5031
+ }
5032
+ async function finishQuizAttempt(deps, attemptId, quizId) {
5033
+ const summary = await loadAttemptSummary(deps, attemptId, quizId);
5034
+ const response = await deps.request(summary.form.action, postInit(summary.form.fields));
5035
+ const html = await response.text();
5036
+ const receipt = { attempt: attemptId, quiz_id: quizId, name: summary.name, summary: summary.rows, url: response.url };
5037
+ if (onPath(response.url, QUIZ_REVIEW_PATH)) {
5038
+ receipt.review = parseQuizReviewHtml(html, attemptId, deps.baseUrl);
5039
+ return receipt;
5040
+ }
5041
+ const quiz = parseQuizHtml(onPath(response.url, QUIZ_VIEW_PATH) ? html : await pageText2(deps, `${deps.baseUrl}${QUIZ_VIEW_PATH}?id=${quizId}`), quizId, deps.baseUrl);
5042
+ const row = quiz.attempts.find((attempt) => attempt.id === attemptId);
5043
+ if (row && /in progress/iu.test(row.status)) throw deps.fail(`Moodle accepted the finish request but still lists attempt ${attemptId} as ${row.status}; check the quiz in a browser.`);
5044
+ receipt.url = quiz.url;
5045
+ if (row) {
5046
+ receipt.result = { status: row.status, marks: row.marks, grade: row.grade, completed: row.completed };
5047
+ return receipt;
5048
+ }
5049
+ const probe2 = await deps.request(attemptUrl(deps.baseUrl, attemptId, quizId, 0));
5050
+ if (onPath(probe2.url, QUIZ_ATTEMPT_PATH) && parse5(await probe2.text()).querySelector("form#responseform")) throw deps.fail(`Moodle accepted the finish request but attempt ${attemptId} is still open; check the quiz in a browser.`);
5051
+ return receipt;
5052
+ }
5053
+ function parseAttemptPage(html, url, deps) {
5054
+ const root = parse5(html);
5055
+ const form = root.querySelector("form#responseform");
5056
+ if (!form) throw deps.fail(`Moodle did not render an attempt page: ${noticesOf2(html) || "no response form found"}`);
5057
+ const attempt = numberParam(url, "attempt") ?? Number(form.querySelector("input[name=attempt]")?.getAttribute("value"));
5058
+ const quizId = numberParam(form.getAttribute("action") ?? "", "cmid") ?? numberParam(url, "cmid") ?? 0;
5059
+ const page = Number(form.querySelector("input[name=thispage]")?.getAttribute("value") ?? numberParam(url, "page") ?? 0);
5060
+ const navigation = root.querySelectorAll("a.qnbutton").map((button) => {
5061
+ const title = button.getAttribute("title") ?? "";
5062
+ const match = title.match(/^(?:Question|Information)?\s*(\S+)\s*-\s*(.+)$/u);
5063
+ return {
5064
+ slot: Number(button.getAttribute("id")?.replace(/^quiznavbutton/u, "") ?? 0),
5065
+ number: match?.[1] ?? cleanText(button.textContent),
5066
+ page: Number(button.getAttribute("data-quiz-page") ?? 0),
5067
+ state: match?.[2] ?? ""
5068
+ };
5069
+ });
5070
+ const questions = form.querySelectorAll("div.que").map(parseAttemptQuestion);
5071
+ return {
5072
+ attempt,
5073
+ quiz_id: quizId,
5074
+ name: pageHeading(root),
5075
+ page,
5076
+ pages: Math.max(page + 1, ...navigation.map((entry) => entry.page + 1)),
5077
+ questions,
5078
+ navigation,
5079
+ url: attemptUrl(deps.baseUrl, attempt, quizId, page),
5080
+ form: { action: resolveUrl(deps.baseUrl, form.getAttribute("action") ?? ""), fields: formFields2(form) }
5081
+ };
5082
+ }
5083
+ function parseAttemptQuestion(que) {
5084
+ const slot = Number(que.getAttribute("id")?.split("-").at(-1) ?? 0);
5085
+ const base = {
5086
+ slot,
5087
+ number: cleanText(que.querySelector(".info .qno, .info .no")?.textContent).replace(/^Question\s*/iu, "") || "i",
5088
+ type: que.classList.value[1] ?? "",
5089
+ kind: "unsupported",
5090
+ state: cleanText(que.querySelector(".info .state")?.textContent),
5091
+ text: blockText(que.querySelector(".qtext"))
5092
+ };
5093
+ if (que.classList.contains("description")) return { ...base, number: "i", kind: "info" };
5094
+ const inputs = que.querySelectorAll("input, textarea, select").filter((input2) => {
5095
+ const name = input2.getAttribute("name") ?? "";
5096
+ return name.startsWith("q") && !/_:(?:flagged|sequencecheck)$|_-seen$|_answerformat$/u.test(name) && !/^(?:hidden|submit)$/u.test(input2.getAttribute("type") ?? "");
5097
+ });
5098
+ const tag = (input2) => input2.tagName.toLowerCase();
5099
+ const type = (input2) => tag(input2) === "input" ? (input2.getAttribute("type") ?? "text").toLowerCase() : tag(input2);
5100
+ const isClearChoice = (input2) => type(input2) === "radio" && (input2.closest(".qtype_multichoice_clearchoice") !== null || input2.getAttribute("aria-hidden") === "true");
5101
+ const radios = inputs.filter((input2) => type(input2) === "radio" && !isClearChoice(input2));
5102
+ const boxes = inputs.filter((input2) => type(input2) === "checkbox");
5103
+ const texts = inputs.filter((input2) => ["textarea", "text", "number"].includes(type(input2)));
5104
+ const selects = inputs.filter((input2) => type(input2) === "select");
5105
+ const others = inputs.length - radios.length - boxes.length - texts.length - selects.length - inputs.filter(isClearChoice).length;
5106
+ const radioNames = new Set(radios.map((input2) => input2.getAttribute("name")));
5107
+ const only = (group) => group.length === inputs.length - inputs.filter(isClearChoice).length && others === 0;
5108
+ if (radios.length && radioNames.size === 1 && only(radios)) {
5109
+ return { ...base, kind: "choice", field: radios[0].getAttribute("name"), options: radios.map((input2, index) => option(que, input2, index)) };
5110
+ }
5111
+ if (boxes.length && only(boxes)) return { ...base, kind: "multi", options: boxes.map((input2, index) => option(que, input2, index)) };
5112
+ if (selects.length === 1 && only(selects)) {
5113
+ const select = selects[0];
5114
+ const name = select.getAttribute("name");
5115
+ const choices = select.querySelectorAll("option").filter((item) => (item.getAttribute("value") ?? "") !== "");
5116
+ return { ...base, kind: "choice", field: name, options: choices.map((item, index) => ({ key: String.fromCharCode(97 + index), field: name, value: item.getAttribute("value") ?? "", text: cleanText(item.textContent), chosen: item.hasAttribute("selected") })) };
5117
+ }
5118
+ if (texts.length === 1 && only(texts)) {
5119
+ const text2 = texts[0];
5120
+ const html = tag(text2) === "textarea";
5121
+ return { ...base, kind: "text", field: text2.getAttribute("name"), answer: html ? blockText(parse5(text2.textContent)) : cleanText(text2.getAttribute("value") ?? "") };
5122
+ }
5123
+ return base;
5124
+ }
5125
+ function option(que, input2, index) {
5126
+ const labelId = input2.getAttribute("aria-labelledby");
5127
+ const id2 = input2.getAttribute("id");
5128
+ const label = (labelId ? que.querySelector(`[id="${labelId}"]`) : null) ?? (id2 ? que.querySelector(`label[for="${id2}"]`) : null) ?? input2.parentNode;
5129
+ const text2 = blockText(label) || label?.querySelectorAll("img").map((img) => cleanText(img.getAttribute("alt"))).filter(Boolean).join(" ") || "(image; see the quiz in a browser)";
5130
+ return { key: String.fromCharCode(97 + index), field: input2.getAttribute("name") ?? "", value: input2.getAttribute("value") ?? "", text: text2, chosen: input2.hasAttribute("checked") };
5131
+ }
5132
+ function encodeAnswer(deps, form, question2, value) {
5133
+ const raw = value.trim();
5134
+ if (question2.kind === "info") throw deps.usage(`Question ${question2.number} is an information block; it takes no answer.`);
5135
+ if (question2.kind === "unsupported" || !question2.field && question2.kind !== "multi") throw deps.usage(`Question ${question2.number} is a ${question2.type || "question"} type the CLI cannot answer.`, "Answer it in a browser; other questions can still be answered here.");
5136
+ if (question2.kind === "text") {
5137
+ if (!raw) throw deps.usage(`Question ${question2.number} needs a written answer.`);
5138
+ const format = form.fields.find(([name]) => name === `${question2.field}format`)?.[1];
5139
+ return [...form.fields.filter(([name]) => name !== question2.field), [question2.field, format === "1" ? paragraphs(value) : raw]];
5140
+ }
5141
+ const options = question2.options ?? [];
5142
+ const picks = raw.split(",").map((part) => part.trim()).filter(Boolean).map((part) => {
5143
+ const match = options.find((item) => item.key === part.toLowerCase()) ?? options.find((item) => cleanText(item.text).toLowerCase() === part.toLowerCase());
5144
+ if (!match) throw deps.usage(`Question ${question2.number} has no option '${part}'.`, `Choose from ${options.map((item) => item.key).join(", ")}.`);
5145
+ return match;
5146
+ });
5147
+ if (!picks.length) throw deps.usage(`Question ${question2.number} needs an option letter.`, `Choose from ${options.map((item) => item.key).join(", ")}.`);
5148
+ if (question2.kind === "choice") {
5149
+ if (picks.length > 1) throw deps.usage(`Question ${question2.number} takes one option, not ${picks.length}.`);
5150
+ return [...form.fields.filter(([name]) => name !== question2.field), [question2.field, picks[0].value]];
5151
+ }
5152
+ const chosen = new Set(picks.map((pick) => pick.key));
5153
+ const boxNames = new Set(options.map((item) => item.field));
5154
+ return [
5155
+ ...form.fields.filter(([name]) => !boxNames.has(name)),
5156
+ ...options.map((item) => [item.field, chosen.has(item.key) ? "1" : "0"])
5157
+ ];
5158
+ }
5159
+ function noticesOf2(html) {
5160
+ const root = parse5(html);
5161
+ const texts = [];
5162
+ for (const node of root.querySelectorAll(".alert, .errorbox, .error, #notice")) {
5163
+ for (const junk of node.querySelectorAll("button, .close")) junk.remove();
5164
+ const text2 = cleanText(node.textContent);
5165
+ if (text2 && !texts.includes(text2)) texts.push(text2);
5166
+ }
5167
+ return texts.join(" ");
5168
+ }
5169
+ function formWithAction2(root, path5) {
5170
+ return root.querySelectorAll("form").find((form) => onPath(form.getAttribute("action") ?? "", path5)) ?? null;
5171
+ }
5172
+ function formFields2(form) {
5173
+ const fields2 = [];
5174
+ for (const element of form.querySelectorAll("input, textarea, select")) {
5175
+ const name = element.getAttribute("name");
5176
+ if (!name) continue;
5177
+ const tag = element.tagName.toLowerCase();
5178
+ if (tag === "textarea") {
5179
+ fields2.push([name, element.textContent]);
5180
+ continue;
5181
+ }
5182
+ if (tag === "select") {
5183
+ const options = element.querySelectorAll("option");
5184
+ const chosen = options.find((item) => item.hasAttribute("selected")) ?? options[0];
5185
+ if (chosen) fields2.push([name, chosen.getAttribute("value") ?? cleanText(chosen.textContent)]);
5186
+ continue;
5187
+ }
5188
+ const type = (element.getAttribute("type") ?? "text").toLowerCase();
5189
+ if (["submit", "button", "image", "file", "reset"].includes(type)) continue;
5190
+ if ((type === "checkbox" || type === "radio") && !element.hasAttribute("checked")) continue;
5191
+ fields2.push([name, element.getAttribute("value") ?? (type === "checkbox" ? "on" : "")]);
5192
+ }
5193
+ return fields2;
5194
+ }
5195
+ function postInit(fields2) {
5196
+ return { method: "POST", headers: { "content-type": "application/x-www-form-urlencoded" }, body: new URLSearchParams(fields2).toString() };
5197
+ }
5198
+ async function pageText2(deps, url) {
5199
+ return (await deps.request(url)).text();
5200
+ }
5201
+ function attemptUrl(baseUrl, attempt, quizId, page) {
5202
+ return `${baseUrl}${QUIZ_ATTEMPT_PATH}?attempt=${attempt}&cmid=${quizId}${page ? `&page=${page}` : ""}`;
5203
+ }
5204
+ function pageHeading(root) {
5205
+ const heading = cleanText(root.querySelector(".page-header-headings h1, #page-header h1")?.textContent);
5206
+ if (heading) return heading;
5207
+ const title = cleanText(root.querySelector("title")?.textContent).replace(/\s*\(page \d+ of \d+\)/iu, "").split(" | ")[0].trim();
5208
+ return title || cleanText(root.querySelector("h2")?.textContent);
5209
+ }
5210
+ function onPath(url, path5) {
5211
+ try {
5212
+ return new URL(url, "https://moodle.invalid").pathname.endsWith(path5);
5213
+ } catch {
5214
+ return false;
5215
+ }
5216
+ }
5217
+ function numberParam(url, key) {
5218
+ try {
5219
+ const value = Number(new URL(url, "https://moodle.invalid").searchParams.get(key));
5220
+ return Number.isSafeInteger(value) && value > 0 ? value : key === "page" && value === 0 ? 0 : null;
5221
+ } catch {
5222
+ return null;
5223
+ }
5224
+ }
5225
+ function paragraphs(text2) {
5226
+ const escaped = text2.trim().replace(/&/gu, "&amp;").replace(/</gu, "&lt;").replace(/>/gu, "&gt;");
5227
+ return escaped.split(/\n\s*\n/u).map((block) => `<p>${block.trim().replace(/\n/gu, "<br>")}</p>`).join("");
5228
+ }
5229
+
4781
5230
  // src/parsers.ts
4782
5231
  function schema(parser) {
4783
5232
  return { parse: parser };
@@ -5778,6 +6227,10 @@ var MoodleClientCore = class {
5778
6227
  async getQuiz(id2) {
5779
6228
  return parseQuizHtml(await this.get(QUIZ_VIEW_PATH, { id: id2 }), id2, this.baseUrl);
5780
6229
  }
6230
+ async getQuizAttempt(attemptId) {
6231
+ await this.ensureSession();
6232
+ return parseQuizReviewHtml(await this.get(QUIZ_REVIEW_PATH, { attempt: attemptId, showall: 1 }), attemptId, this.baseUrl);
6233
+ }
5781
6234
  async getResource(id2) {
5782
6235
  const url = `${this.baseUrl}${RESOURCE_VIEW_PATH}?id=${id2}`;
5783
6236
  const response = await this.requestAbsolute(url);
@@ -5826,6 +6279,32 @@ var MoodleClientCore = class {
5826
6279
  usage: (message, hint) => this.errors.usage ? this.errors.usage(message, hint) : new MoodleClientCoreError("usage", message, hint)
5827
6280
  }, request);
5828
6281
  }
6282
+ /** Starts a new attempt, or resumes the one already in progress, and returns its first page. */
6283
+ async startQuizAttempt(quizId, options = {}) {
6284
+ return startQuizAttempt(await this.quizDeps(), quizId, options);
6285
+ }
6286
+ async getQuizAttemptPage(attemptId, quizId, page = 0) {
6287
+ return getAttemptPage(await this.quizDeps(), attemptId, quizId, page);
6288
+ }
6289
+ async getQuizAttemptSummary(attemptId, quizId) {
6290
+ return getAttemptSummary(await this.quizDeps(), attemptId, quizId);
6291
+ }
6292
+ async answerQuizQuestion(request) {
6293
+ return answerQuizQuestion(await this.quizDeps(), request);
6294
+ }
6295
+ /** Submits the attempt for grading. Moodle treats this as final. */
6296
+ async finishQuizAttempt(attemptId, quizId) {
6297
+ return finishQuizAttempt(await this.quizDeps(), attemptId, quizId);
6298
+ }
6299
+ async quizDeps() {
6300
+ await this.ensureSession();
6301
+ return {
6302
+ baseUrl: this.baseUrl,
6303
+ request: (url, init, options) => this.requestAbsolute(url, init, options),
6304
+ fail: (message, moodleErrorCode) => this.errors.api(message, moodleErrorCode),
6305
+ usage: (message, hint) => this.errors.usage ? this.errors.usage(message, hint) : new MoodleClientCoreError("usage", message, hint)
6306
+ };
6307
+ }
5829
6308
  async getNewsForums(courseId) {
5830
6309
  const units = courseId === void 0 ? await this.getCourses() : (await this.getCourses()).filter((c) => c.id === courseId);
5831
6310
  const forums = [];
@@ -6294,6 +6773,202 @@ function authToClientSession(auth) {
6294
6773
  };
6295
6774
  }
6296
6775
 
6776
+ // src/update-check.ts
6777
+ import { spawn as spawn3, spawnSync as spawnSync3 } from "child_process";
6778
+ import { chmod as chmod4, mkdir as mkdir7, readFile as readFile7, rename as rename2, rm as rm5, writeFile as writeFile6 } from "fs/promises";
6779
+ import { realpathSync as realpathSync3 } from "fs";
6780
+ import { arch, homedir as homedir11, platform } from "os";
6781
+ import { join as join10 } from "path";
6782
+
6783
+ // src/update-core.ts
6784
+ var PACKAGE_NAME2 = "moodle-cli";
6785
+ var LATEST_VERSION_URL = `https://registry.npmjs.org/-/package/${PACKAGE_NAME2}/dist-tags`;
6786
+ var UPDATE_CHECK_TTL_MS = 24 * 60 * 60 * 1e3;
6787
+ var UPDATE_RETRY_MS = 60 * 60 * 1e3;
6788
+ var GITHUB_REPOSITORY = "bunizao/moodle-cli";
6789
+ function compareVersions(a, b) {
6790
+ const [aMain, aPre] = a.split("-", 2);
6791
+ const [bMain, bPre] = b.split("-", 2);
6792
+ const left = aMain.split(".").map(Number);
6793
+ const right = bMain.split(".").map(Number);
6794
+ for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
6795
+ const diff = (left[index] ?? 0) - (right[index] ?? 0);
6796
+ if (diff !== 0) return Math.sign(diff);
6797
+ }
6798
+ if (Boolean(aPre) === Boolean(bPre)) return (aPre ?? "").localeCompare(bPre ?? "");
6799
+ return aPre ? -1 : 1;
6800
+ }
6801
+ function isNewerVersion(candidate, current2) {
6802
+ return Boolean(candidate) && /^\d+\.\d+\.\d+/u.test(candidate) && compareVersions(candidate, current2) > 0;
6803
+ }
6804
+ async function fetchLatestVersion(fetchImpl = fetch, timeoutMs = 5e3) {
6805
+ try {
6806
+ const response = await fetchImpl(LATEST_VERSION_URL, { headers: { accept: "application/json" }, signal: AbortSignal.timeout(timeoutMs) });
6807
+ if (!response.ok) return null;
6808
+ const tags = await response.json();
6809
+ return typeof tags.latest === "string" ? tags.latest : null;
6810
+ } catch {
6811
+ return null;
6812
+ }
6813
+ }
6814
+ function updateHint(current2, latest) {
6815
+ return `moodle-cli ${latest} is available (running ${current2}). Run: moodle update`;
6816
+ }
6817
+ function standaloneUpdateHint(current2, latest) {
6818
+ return `moodle-cli ${latest} is available (running ${current2}). Run: moodle update`;
6819
+ }
6820
+ var STANDALONE_TARGETS = /* @__PURE__ */ new Set(["darwin-arm64", "linux-x64"]);
6821
+ function standaloneAssetUrl(version, platform2, arch2) {
6822
+ const target = `${platform2}-${arch2}`;
6823
+ if (!STANDALONE_TARGETS.has(target)) return null;
6824
+ return `https://github.com/${GITHUB_REPOSITORY}/releases/download/v${version}/moodle-${target}`;
6825
+ }
6826
+
6827
+ // src/version.ts
6828
+ var VERSION = "0.9.3";
6829
+
6830
+ // src/update-check.ts
6831
+ var UPDATE_CACHE_FILENAME = "update-check.json";
6832
+ var ENV_NO_UPDATE_CHECK = "MOODLE_NO_UPDATE_CHECK";
6833
+ function updateCachePath(homeDir = homedir11()) {
6834
+ return join10(homeDir, CONFIG_DIR_NAME, UPDATE_CACHE_FILENAME);
6835
+ }
6836
+ async function readUpdateCache(homeDir) {
6837
+ try {
6838
+ const parsed = JSON.parse(await readFile7(updateCachePath(homeDir), "utf8"));
6839
+ return parsed && typeof parsed === "object" ? parsed : {};
6840
+ } catch {
6841
+ return {};
6842
+ }
6843
+ }
6844
+ async function writeUpdateCache(cache, homeDir) {
6845
+ const file2 = updateCachePath(homeDir);
6846
+ await mkdir7(join10(file2, ".."), { recursive: true });
6847
+ await writeFile6(file2, `${JSON.stringify(cache)}
6848
+ `, { mode: 384 });
6849
+ }
6850
+ async function refreshLatestVersion(options = {}) {
6851
+ const latest = await fetchLatestVersion(options.fetchImpl);
6852
+ const now = (options.now ?? Date.now)();
6853
+ const cache = await readUpdateCache(options.homeDir);
6854
+ await writeUpdateCache(latest ? { ...cache, latest, checked_at: now, failed_at: void 0 } : { ...cache, failed_at: now }, options.homeDir);
6855
+ return latest;
6856
+ }
6857
+ function refreshDue(cache, now) {
6858
+ if (now - (cache.checked_at ?? 0) < UPDATE_CHECK_TTL_MS) return false;
6859
+ return now - (cache.failed_at ?? 0) >= UPDATE_RETRY_MS;
6860
+ }
6861
+ var QUIET_COMMANDS = /* @__PURE__ */ new Set(["update", "dev", "completion", "commands", "skills", "mcp", "doctor"]);
6862
+ function startupCheckApplies(args, env = process.env) {
6863
+ if (env[ENV_NO_UPDATE_CHECK] || env.CI) return false;
6864
+ const first2 = args.find((arg) => !arg.startsWith("-"));
6865
+ return first2 === void 0 || !QUIET_COMMANDS.has(first2);
6866
+ }
6867
+ async function startupUpdateNotice(args, stderr, options = {}) {
6868
+ const env = options.env ?? process.env;
6869
+ if (!startupCheckApplies(args, env)) return;
6870
+ const now = (options.now ?? Date.now)();
6871
+ const cache = await readUpdateCache(options.homeDir);
6872
+ if (isNewerVersion(cache.latest, VERSION) && now - (cache.notified_at ?? 0) >= UPDATE_CHECK_TTL_MS) {
6873
+ stderr.write(`${selfCommand().args.length ? updateHint(VERSION, cache.latest) : standaloneUpdateHint(VERSION, cache.latest)}
6874
+ `);
6875
+ await writeUpdateCache({ ...cache, notified_at: now }, options.homeDir);
6876
+ }
6877
+ if (refreshDue(cache, now)) spawnRefresh(env);
6878
+ }
6879
+ function spawnRefresh(env) {
6880
+ const self = selfCommand();
6881
+ try {
6882
+ const child = spawn3(self.command, [...self.args, "update", "--check", "--quiet"], { detached: true, stdio: "ignore", env: { ...env, [ENV_NO_UPDATE_CHECK]: "1" } });
6883
+ child.unref();
6884
+ } catch {
6885
+ }
6886
+ }
6887
+ function detectInstallKind(argv = process.argv, execPath = process.execPath) {
6888
+ const self = selfCommand(argv, execPath);
6889
+ if (!self.args.length) return "standalone";
6890
+ let script = self.args[0];
6891
+ try {
6892
+ script = realpathSync3(script);
6893
+ } catch {
6894
+ }
6895
+ return /[\\/]\.bun[\\/]/u.test(script) || /[\\/]bun[\\/]install[\\/]global[\\/]/u.test(script) ? "bun" : "npm";
6896
+ }
6897
+ function installCommand(kind) {
6898
+ if (kind === "bun") return { command: findExecutable("bun") ?? "bun", args: ["add", "--global", "moodle-cli@latest"] };
6899
+ if (kind === "npm") return { command: findExecutable("npm") ?? "npm", args: ["install", "-g", "moodle-cli@latest"] };
6900
+ return null;
6901
+ }
6902
+ async function replaceStandalone(execPath, version, fetchImpl = fetch, host = { platform: platform(), arch: arch() }) {
6903
+ const url = standaloneAssetUrl(version, host.platform, host.arch);
6904
+ if (!url) return `No standalone build is published for ${host.platform}-${host.arch}. See ${GITHUB_RELEASES_URL}`;
6905
+ const staging = `${execPath}.${process.pid}.download`;
6906
+ try {
6907
+ const response = await fetchImpl(url, { redirect: "follow" });
6908
+ if (!response.ok) return `Download failed with HTTP ${response.status} for ${url}`;
6909
+ await writeFile6(staging, new Uint8Array(await response.arrayBuffer()), { mode: 493 });
6910
+ await chmod4(staging, 493);
6911
+ await rename2(staging, execPath);
6912
+ return null;
6913
+ } catch (error) {
6914
+ await rm5(staging, { force: true });
6915
+ return `Could not replace ${execPath}: ${error instanceof Error ? error.message : String(error)}`;
6916
+ }
6917
+ }
6918
+ function readOutput(command, args) {
6919
+ const result = spawnSync3(command, args, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
6920
+ return result.status === 0 ? result.stdout : null;
6921
+ }
6922
+ async function runUpdate(options) {
6923
+ const run = options.runCommand ?? ((command, args) => spawnSync3(command, args, { stdio: ["inherit", 2, "inherit"], env: options.env }));
6924
+ const install = detectInstallKind(options.argv, options.execPath);
6925
+ const latest = await refreshLatestVersion(options);
6926
+ const report = { current: VERSION, latest, install, updated: false, deployed: false, ok: true, note: "" };
6927
+ const newer = isNewerVersion(latest ?? void 0, VERSION);
6928
+ const self = selfCommand(options.argv, options.execPath);
6929
+ if (newer) {
6930
+ const command = installCommand(install);
6931
+ if (command) {
6932
+ const result2 = run(command.command, command.args);
6933
+ if (result2.status !== 0) {
6934
+ report.ok = false;
6935
+ report.note = `${command.command} exited with ${result2.status ?? "a signal"}; the package was not updated.`;
6936
+ return report;
6937
+ }
6938
+ } else {
6939
+ const failure = await replaceStandalone(options.execPath ?? process.execPath, latest, options.fetchImpl);
6940
+ if (failure) {
6941
+ report.ok = false;
6942
+ report.note = `${standaloneUpdateHint(VERSION, latest)} ${failure}`;
6943
+ return report;
6944
+ }
6945
+ }
6946
+ const installed = (options.readOutput ?? readOutput)(self.command, [...self.args, "--version"])?.trim();
6947
+ if (installed !== latest) {
6948
+ report.ok = false;
6949
+ report.note = `The installer finished but ${self.args[0] ?? self.command} reports ${installed || "no version"} instead of ${latest}; another moodle install may be on PATH.`;
6950
+ return report;
6951
+ }
6952
+ report.updated = true;
6953
+ }
6954
+ const unreachable = latest === null ? "The npm registry could not be reached, so the installed version was not checked." : "";
6955
+ if (options.workerBehind === void 0) {
6956
+ report.ok = !unreachable;
6957
+ report.note = unreachable || (newer ? `Updated to ${latest}.` : "Already up to date.");
6958
+ return report;
6959
+ }
6960
+ if (!newer && !options.workerBehind) {
6961
+ report.ok = !unreachable;
6962
+ report.note = unreachable ? `${unreachable} The Worker is current.` : "Package and Worker are up to date.";
6963
+ return report;
6964
+ }
6965
+ const result = run(self.command, [...self.args, "mcp", "deploy", "--yes"]);
6966
+ report.deployed = result.status === 0;
6967
+ report.ok = report.deployed && !unreachable;
6968
+ report.note = [unreachable, report.deployed ? `Worker redeployed from ${newer ? latest : VERSION}.` : "Worker deploy failed; run moodle mcp deploy to retry."].filter(Boolean).join(" ");
6969
+ return report;
6970
+ }
6971
+
6297
6972
  // src/formatters.ts
6298
6973
  function formatUser(user) {
6299
6974
  return renderKeyValueTable([
@@ -6479,15 +7154,58 @@ function formatTimestamp(value) {
6479
7154
  const pad = (part) => String(part).padStart(2, "0");
6480
7155
  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
6481
7156
  }
7157
+ function formatAttemptPage(page) {
7158
+ const lines = [`${page.name} attempt ${page.attempt} page ${page.page + 1} of ${page.pages}`, ""];
7159
+ for (const question2 of page.questions) lines.push(...attemptQuestionLines(question2), "");
7160
+ const elsewhere = page.navigation.filter((entry) => entry.page !== page.page && entry.number !== "i");
7161
+ if (elsewhere.length) lines.push(`Other pages: ${elsewhere.map((entry) => `Q${entry.number} p${entry.page + 1} (${entry.state.toLowerCase()})`).join(", ")}`);
7162
+ return lines.join("\n").trimEnd();
7163
+ }
7164
+ function attemptQuestionLines(question2) {
7165
+ const head = question2.kind === "info" ? "Information" : `Question ${question2.number} ${question2.state}`;
7166
+ const lines = [head, ...wrap(question2.text)];
7167
+ for (const option2 of question2.options ?? []) {
7168
+ const [first2, ...rest] = wrap(option2.text, 88);
7169
+ lines.push(` ${option2.chosen ? "[x]" : "[ ]"} ${option2.key})${first2.slice(1)}`, ...rest.map((line) => ` ${line}`));
7170
+ }
7171
+ if (question2.kind === "text") lines.push(` Answer: ${question2.answer || "(empty)"}`);
7172
+ if (question2.kind === "unsupported") lines.push(` (${question2.type} questions can only be answered in a browser)`);
7173
+ return lines;
7174
+ }
7175
+ function wrap(text2, width = 96) {
7176
+ const lines = [];
7177
+ let line = "";
7178
+ for (const word of text2.split(/\s+/u).filter(Boolean)) {
7179
+ if (line && line.length + word.length + 1 > width) {
7180
+ lines.push(` ${line}`);
7181
+ line = word;
7182
+ } else line = line ? `${line} ${word}` : word;
7183
+ }
7184
+ if (line || !lines.length) lines.push(` ${line}`);
7185
+ return lines;
7186
+ }
7187
+ function formatAttemptSummary(summary) {
7188
+ return renderTerminalTable([{ label: "Question" }, { label: "Status" }], summary.rows.map((row) => [row.number, row.state]), { title: `${summary.name} attempt ${summary.attempt}` });
7189
+ }
7190
+ function formatAttemptFinish(receipt) {
7191
+ const result = receipt.review ? [["Status", receipt.review.status], ["Marks", receipt.review.marks], ["Grade", receipt.review.grade], ["Completed", receipt.review.completed]] : receipt.result ? [["Status", receipt.result.status], ["Marks", receipt.result.marks], ["Grade", receipt.result.grade], ["Completed", receipt.result.completed]] : [];
7192
+ return renderKeyValueTable([
7193
+ ["Quiz", receipt.name],
7194
+ ["Attempt", String(receipt.attempt)],
7195
+ ...result,
7196
+ ["Answered", `${receipt.summary.filter((row) => !/not yet answered/iu.test(row.state)).length} of ${receipt.summary.length}`],
7197
+ ["URL", receipt.url]
7198
+ ], { title: "Attempt submitted" });
7199
+ }
6482
7200
 
6483
7201
  // src/download.ts
6484
7202
  import { createWriteStream } from "fs";
6485
- import { link, lstat, rename as rename2, unlink } from "fs/promises";
7203
+ import { link, lstat, rename as rename3, unlink } from "fs/promises";
6486
7204
  import { randomUUID } from "crypto";
6487
7205
  import path2 from "path";
6488
7206
  import { Readable, Transform } from "stream";
6489
7207
  import { pipeline } from "stream/promises";
6490
- import { parse as parse5 } from "node-html-parser";
7208
+ import { parse as parse6 } from "node-html-parser";
6491
7209
  var ACCEPTED_SOURCE_HINT = "Use a positive resource activity ID, a same-site resource URL, or a same-site pluginfile URL.";
6492
7210
  var FILE_SYSTEM_ERROR_CODES = /* @__PURE__ */ new Set([
6493
7211
  "EACCES",
@@ -6609,7 +7327,7 @@ async function responseOrWrapper(client, requestUrl, sourceUrl, targetName, sign
6609
7327
  };
6610
7328
  }
6611
7329
  function resourceLinks2(html, baseUrl) {
6612
- const root = parse5(html);
7330
+ const root = parse6(html);
6613
7331
  const entries = root.querySelectorAll(".resourceworkaround a[href], .resourcecontent a[href], a.resourceworkaround[href]").map((linkNode) => ({
6614
7332
  name: linkNode.textContent.trim(),
6615
7333
  url: new URL(linkNode.getAttribute("href") ?? "", baseUrl).toString()
@@ -6625,7 +7343,7 @@ function isHtmlWrapper(response) {
6625
7343
  return type.includes("text/html") || type.includes("application/xhtml+xml");
6626
7344
  }
6627
7345
  function looksLikeLoginPage3(html) {
6628
- const root = parse5(html);
7346
+ const root = parse6(html);
6629
7347
  return root.querySelector('form[action*="/login/"], input[name="password"], #page-login-index') !== null || /<title>\s*(?:log in|login)/iu.test(html);
6630
7348
  }
6631
7349
  function chooseUpstreamFilename(resolved) {
@@ -6699,7 +7417,7 @@ async function writeResponse(response, destination, force, signal) {
6699
7417
  const input2 = response.body ? Readable.fromWeb(response.body) : Readable.from([]);
6700
7418
  await pipeline(input2, counter, createWriteStream(temporaryPath, { flags: "wx" }), { signal });
6701
7419
  if (force) {
6702
- await rename2(temporaryPath, destination);
7420
+ await rename3(temporaryPath, destination);
6703
7421
  } else {
6704
7422
  try {
6705
7423
  await link(temporaryPath, destination);
@@ -6756,7 +7474,7 @@ function isFileSystemError(error) {
6756
7474
  }
6757
7475
 
6758
7476
  // src/skills.ts
6759
- import { spawnSync as spawnSync3 } from "child_process";
7477
+ import { spawnSync as spawnSync4 } from "child_process";
6760
7478
  import { mkdirSync, readFileSync, writeFileSync, rmSync } from "fs";
6761
7479
  import path3 from "path";
6762
7480
 
@@ -6768,7 +7486,7 @@ function describeProgram(program) {
6768
7486
  name: program.name(),
6769
7487
  version: program.version() ?? "",
6770
7488
  description: program.description(),
6771
- commands: program.commands.filter((command) => command.name() !== "help").map((command) => describeCommand(command))
7489
+ commands: program.commands.filter((command) => command.name() !== "help" && command.name() !== "dev").map((command) => describeCommand(command))
6772
7490
  };
6773
7491
  }
6774
7492
  function describeCommand(command, noun) {
@@ -6795,20 +7513,20 @@ function describeArgument(argument) {
6795
7513
  ...argument.argChoices ? { enumValues: argument.argChoices } : {}
6796
7514
  };
6797
7515
  }
6798
- function describeOption(option) {
7516
+ function describeOption(option2) {
6799
7517
  return {
6800
- flags: option.flags,
6801
- description: option.description,
6802
- required: option.required,
6803
- variadic: option.variadic,
6804
- ...option.argChoices ? { enumValues: option.argChoices } : {}
7518
+ flags: option2.flags,
7519
+ description: option2.description,
7520
+ required: option2.required,
7521
+ variadic: option2.variadic,
7522
+ ...option2.argChoices ? { enumValues: option2.argChoices } : {}
6805
7523
  };
6806
7524
  }
6807
7525
  function isMutating(command) {
6808
7526
  if (VERB_SET.has(command.name())) {
6809
7527
  return ["send", "submit", "set", "mark-read"].includes(command.name());
6810
7528
  }
6811
- return ["install", "uninstall", "login", "deploy", "connect", "pair", "revoke", "remove", "push"].includes(command.name());
7529
+ return ["install", "uninstall", "login", "deploy", "connect", "pair", "revoke", "remove", "push", "update", "start", "answer", "finish"].includes(command.name());
6812
7530
  }
6813
7531
 
6814
7532
  // src/skills.ts
@@ -6839,7 +7557,7 @@ function buildSkillsAddCommand(extraArgs = [], launcher = "npx") {
6839
7557
  return ["npm", "exec", "--yes", "--", "skills", "add", SKILL_SOURCE, ...extraArgs];
6840
7558
  }
6841
7559
  function addSkill(extraArgs = [], options = {}) {
6842
- const runCommand = options.runCommand ?? spawnSync3;
7560
+ const runCommand = options.runCommand ?? spawnSync4;
6843
7561
  const commandExists = options.commandExists ?? ((name) => isCommandAvailable(name, runCommand));
6844
7562
  const command = commandExists("npx") ? buildSkillsAddCommand(extraArgs, "npx") : commandExists("npm") ? buildSkillsAddCommand(extraArgs, "npm") : void 0;
6845
7563
  if (!command) {
@@ -6872,11 +7590,11 @@ function commandDescriptionRows(command, parentPath = []) {
6872
7590
  required: argument.required,
6873
7591
  variadic: argument.variadic
6874
7592
  })),
6875
- flags: command.options.map((option) => {
6876
- const names = option.flags.match(/-{1,2}[\w-]+/g) ?? [];
6877
- const name = names.find((value) => value.startsWith("--")) ?? names[0] ?? option.flags;
7593
+ flags: command.options.map((option2) => {
7594
+ const names = option2.flags.match(/-{1,2}[\w-]+/g) ?? [];
7595
+ const name = names.find((value) => value.startsWith("--")) ?? names[0] ?? option2.flags;
6878
7596
  const alias = names.find((value) => value !== name);
6879
- return { name, alias, description: option.description, required: option.required };
7597
+ return { name, alias, description: option2.description, required: option2.required };
6880
7598
  })
6881
7599
  };
6882
7600
  return [row, ...command.commands.flatMap((child) => commandDescriptionRows(child, path5))];
@@ -7155,9 +7873,6 @@ async function readAll(input2) {
7155
7873
  return chunks2.join("");
7156
7874
  }
7157
7875
 
7158
- // src/version.ts
7159
- var VERSION = "0.9.2";
7160
-
7161
7876
  // src/forum.ts
7162
7877
  function parseDiscussionReference(value) {
7163
7878
  const raw = value.trim();
@@ -7312,9 +8027,9 @@ function resolveTopLevelUrl(baseUrlOrOptions, targetValue, resolveCourseIdForUrl
7312
8027
  // src/mcp/cli.ts
7313
8028
  import { createTheme as createTheme4 } from "@bunizao/cli-kit";
7314
8029
  import { createHash as createHash3 } from "crypto";
7315
- import { readFile as readFile9 } from "fs/promises";
7316
- import { homedir as homedir14 } from "os";
7317
- import { join as join13 } from "path";
8030
+ import { readFile as readFile10 } from "fs/promises";
8031
+ import { homedir as homedir15 } from "os";
8032
+ import { join as join14 } from "path";
7318
8033
  import { createInterface } from "readline/promises";
7319
8034
  import { fileURLToPath } from "url";
7320
8035
 
@@ -7848,9 +8563,9 @@ function resolveConnection(options) {
7848
8563
  }
7849
8564
 
7850
8565
  // src/mcp/connectors/node-connectors.ts
7851
- import { chmod as chmod4, mkdir as mkdir7, readFile as readFile7, rm as rm5, stat as stat3, writeFile as writeFile6 } from "fs/promises";
7852
- import { homedir as homedir11 } from "os";
7853
- import { dirname as dirname6, join as join10 } from "path";
8566
+ import { chmod as chmod5, mkdir as mkdir8, readFile as readFile8, rm as rm6, stat as stat3, writeFile as writeFile7 } from "fs/promises";
8567
+ import { homedir as homedir12 } from "os";
8568
+ import { dirname as dirname6, join as join11 } from "path";
7854
8569
  var NodeConnectorFileSystem = class {
7855
8570
  async exists(path5) {
7856
8571
  try {
@@ -7864,20 +8579,20 @@ var NodeConnectorFileSystem = class {
7864
8579
  }
7865
8580
  }
7866
8581
  async readText(path5) {
7867
- return readFile7(path5, "utf8");
8582
+ return readFile8(path5, "utf8");
7868
8583
  }
7869
8584
  async writePrivate(path5, content) {
7870
- await mkdir7(dirname6(path5), { recursive: true, mode: 448 });
7871
- await writeFile6(path5, content, { encoding: "utf8", mode: 384 });
7872
- await chmod4(path5, 384);
8585
+ await mkdir8(dirname6(path5), { recursive: true, mode: 448 });
8586
+ await writeFile7(path5, content, { encoding: "utf8", mode: 384 });
8587
+ await chmod5(path5, 384);
7873
8588
  }
7874
8589
  async remove(path5) {
7875
- await rm5(path5, { force: true });
8590
+ await rm6(path5, { force: true });
7876
8591
  }
7877
8592
  };
7878
8593
  function createDefaultClientConnectors(profile, options = {}) {
7879
- const home = options.homeDirectory ?? homedir11();
7880
- const platform = options.platform ?? process.platform;
8594
+ const home = options.homeDirectory ?? homedir12();
8595
+ const platform2 = options.platform ?? process.platform;
7881
8596
  const fileSystem = options.fileSystem ?? new NodeConnectorFileSystem();
7882
8597
  const runtime = runtimeCommand(options.command, options.commandArgs);
7883
8598
  const shared = {
@@ -7888,14 +8603,14 @@ function createDefaultClientConnectors(profile, options = {}) {
7888
8603
  endpoint: options.endpoint,
7889
8604
  accessToken: options.accessToken
7890
8605
  };
7891
- const claudeDesktop = platform === "darwin" ? join10(home, "Library", "Application Support", "Claude", "claude_desktop_config.json") : platform === "win32" ? join10(home, "AppData", "Roaming", "Claude", "claude_desktop_config.json") : join10(home, ".config", "Claude", "claude_desktop_config.json");
7892
- const vscodeUser = platform === "darwin" ? join10(home, "Library", "Application Support", "Code", "User", "mcp.json") : platform === "win32" ? join10(home, "AppData", "Roaming", "Code", "User", "mcp.json") : join10(home, ".config", "Code", "User", "mcp.json");
8606
+ const claudeDesktop = platform2 === "darwin" ? join11(home, "Library", "Application Support", "Claude", "claude_desktop_config.json") : platform2 === "win32" ? join11(home, "AppData", "Roaming", "Claude", "claude_desktop_config.json") : join11(home, ".config", "Claude", "claude_desktop_config.json");
8607
+ const vscodeUser = platform2 === "darwin" ? join11(home, "Library", "Application Support", "Code", "User", "mcp.json") : platform2 === "win32" ? join11(home, "AppData", "Roaming", "Code", "User", "mcp.json") : join11(home, ".config", "Code", "User", "mcp.json");
7893
8608
  return [
7894
- createCodexConnector({ ...shared, configPath: join10(home, ".codex", "config.toml"), detectionPath: join10(home, ".codex") }, fileSystem),
8609
+ createCodexConnector({ ...shared, configPath: join11(home, ".codex", "config.toml"), detectionPath: join11(home, ".codex") }, fileSystem),
7895
8610
  createClaudeDesktopConnector({ ...shared, configPath: claudeDesktop, detectionPath: dirname6(claudeDesktop) }, fileSystem),
7896
- createClaudeCodeConnector({ ...shared, configPath: join10(home, ".claude.json"), detectionPath: join10(home, ".claude") }, fileSystem),
8611
+ createClaudeCodeConnector({ ...shared, configPath: join11(home, ".claude.json"), detectionPath: join11(home, ".claude") }, fileSystem),
7897
8612
  createVsCodeConnector({ ...shared, configPath: vscodeUser, detectionPath: dirname6(vscodeUser) }, fileSystem),
7898
- createCursorConnector({ ...shared, configPath: join10(home, ".cursor", "mcp.json"), detectionPath: join10(home, ".cursor") }, fileSystem)
8613
+ createCursorConnector({ ...shared, configPath: join11(home, ".cursor", "mcp.json"), detectionPath: join11(home, ".cursor") }, fileSystem)
7899
8614
  ];
7900
8615
  }
7901
8616
  var DefaultClientIntegration = class {
@@ -8056,13 +8771,14 @@ function successfulDeploymentCopy(input2, theme = PLAIN) {
8056
8771
  field("Session", theme.status("ready", { ready: "success" })),
8057
8772
  "",
8058
8773
  theme.subject("Renewal"),
8059
- ` ${theme.dim("Installed on this computer")}`,
8060
- ` ${theme.dim("Next check: within 30 minutes")}`,
8774
+ // People did not ask for a scheduler, so the first thing to say is what they will
8775
+ // notice: nothing, unless Moodle signs them out. The mechanics come last and dim.
8776
+ " A silent background check every 30 minutes; you never see it.",
8777
+ ` If Moodle signs you out it re-uploads your browser cookie, or sends one notification to run ${theme.key("moodle mcp login")}.`,
8778
+ ...input2.renewal ? [` ${theme.dim(`${input2.renewal.scheduler} ${input2.renewal.label} \xB7 log ${input2.renewal.log} \xB7 remove with moodle mcp remove`)}`] : [],
8061
8779
  "",
8062
8780
  theme.subject("Connected clients"),
8063
- connectedClients,
8064
- "",
8065
- `Run ${theme.key("moodle mcp status")} at any time.`
8781
+ connectedClients
8066
8782
  ].join("\n");
8067
8783
  }
8068
8784
 
@@ -8368,6 +9084,7 @@ var ManagedMcpDeployment = class {
8368
9084
  profile,
8369
9085
  worker: null,
8370
9086
  credentialsStored: false,
9087
+ credentialsAvailable: true,
8371
9088
  renewalInstalled: await this.dependencies.renewal.inspect(profile),
8372
9089
  clientsConnected: await this.dependencies.clients.inspect(profile),
8373
9090
  readiness: "unknown",
@@ -8378,15 +9095,16 @@ var ManagedMcpDeployment = class {
8378
9095
  }
8379
9096
  const [worker, credentials, renewalInstalled, clientsConnected] = await Promise.all([
8380
9097
  this.dependencies.wrangler.inspect(receipt.accountId, receipt.workerName),
8381
- this.dependencies.credentials.read(profile),
9098
+ // Reporting is not worth failing over: an unopenable keychain is reported, not thrown.
9099
+ readCredentialsForReport(() => this.dependencies.credentials.read(profile)),
8382
9100
  this.dependencies.renewal.inspect(profile),
8383
9101
  this.dependencies.clients.inspect(profile)
8384
9102
  ]);
8385
9103
  let readiness = "unknown";
8386
9104
  let readinessReasonCode = null;
8387
9105
  let sessionRevision = null;
8388
- if (worker && credentials) {
8389
- const target = { endpoint: receipt.productionEndpoint, sessionSyncToken: credentials.sessionSyncToken };
9106
+ if (worker && credentials.value) {
9107
+ const target = { endpoint: receipt.productionEndpoint, sessionSyncToken: credentials.value.sessionSyncToken };
8390
9108
  await this.dependencies.worker.touchSession(target);
8391
9109
  const remoteReadiness = await this.dependencies.worker.getReadiness(target);
8392
9110
  readiness = remoteReadiness.status;
@@ -8397,7 +9115,8 @@ var ManagedMcpDeployment = class {
8397
9115
  return {
8398
9116
  profile,
8399
9117
  worker: resolvedWorker,
8400
- credentialsStored: credentials !== null,
9118
+ credentialsStored: credentials.value !== null,
9119
+ credentialsAvailable: credentials.available,
8401
9120
  renewalInstalled,
8402
9121
  clientsConnected,
8403
9122
  readiness,
@@ -8671,10 +9390,10 @@ function asDeploymentError(error) {
8671
9390
 
8672
9391
  // src/mcp/wrangler.ts
8673
9392
  import { createUi as createUi2 } from "@bunizao/cli-kit";
8674
- import { mkdir as mkdir8, writeFile as writeFile7 } from "fs/promises";
9393
+ import { mkdir as mkdir9, writeFile as writeFile8 } from "fs/promises";
8675
9394
  import { existsSync } from "fs";
8676
- import { homedir as homedir12 } from "os";
8677
- import { join as join11 } from "path";
9395
+ import { homedir as homedir13 } from "os";
9396
+ import { join as join12 } from "path";
8678
9397
  async function resolveWrangler(runner, options = {}) {
8679
9398
  const env = options.env ?? process.env;
8680
9399
  const notice = options.notice ?? ((text2) => process.stderr.write(`${text2}
@@ -8685,8 +9404,8 @@ async function resolveWrangler(runner, options = {}) {
8685
9404
  if (version && sameMajorAtLeast(version, WRANGLER_VERSION)) return { command: existing, args: [] };
8686
9405
  notice(`Ignoring ${existing} (${version ?? "unknown version"}); Cloudflare management needs Wrangler ${WRANGLER_VERSION.split(".")[0]}.x.`);
8687
9406
  }
8688
- const root = join11(options.homeDir ?? homedir12(), ".config", "moodle-cli", "tools", `wrangler@${WRANGLER_VERSION}`);
8689
- const script = join11(root, "node_modules", "wrangler", "bin", "wrangler.js");
9407
+ const root = join12(options.homeDir ?? homedir13(), ".config", "moodle-cli", "tools", `wrangler@${WRANGLER_VERSION}`);
9408
+ const script = join12(root, "node_modules", "wrangler", "bin", "wrangler.js");
8690
9409
  const bun = findExecutable("bun", env);
8691
9410
  const node = findExecutable("node", env);
8692
9411
  if (!bun && !node) throw new Error("Cloudflare management needs Bun or Node 22.13+. Install either, then retry moodle mcp deploy.");
@@ -8702,8 +9421,8 @@ async function resolveWrangler(runner, options = {}) {
8702
9421
  }
8703
9422
  }
8704
9423
  notice(`Cloudflare management needs Wrangler ${WRANGLER_VERSION}; downloading once to ${root}.`);
8705
- await mkdir8(root, { recursive: true, mode: 448 });
8706
- await writeFile7(join11(root, "package.json"), '{ "private": true }\n');
9424
+ await mkdir9(root, { recursive: true, mode: 448 });
9425
+ await writeFile8(join12(root, "package.json"), '{ "private": true }\n');
8707
9426
  const result = await runner.run(bun ?? npm, bun ? ["install", "--cwd", root, "--no-save", `wrangler@${WRANGLER_VERSION}`] : ["install", "--prefix", root, "--no-save", "--package-lock=false", "--no-audit", "--no-fund", `wrangler@${WRANGLER_VERSION}`]);
8708
9427
  if (!existsSync(script)) {
8709
9428
  const output = `${result.stderr}
@@ -8723,18 +9442,18 @@ function sameMajorAtLeast(actual, pinned) {
8723
9442
 
8724
9443
  // src/mcp/deployment/node-adapters.ts
8725
9444
  import { isDeepStrictEqual } from "util";
8726
- import { spawn as spawn3 } from "child_process";
9445
+ import { spawn as spawn4 } from "child_process";
8727
9446
  import { createHash as createHash2, randomBytes as randomBytes2 } from "crypto";
8728
- import { chmod as chmod5, mkdir as mkdir9, mkdtemp, readFile as readFile8, rm as rm6, writeFile as writeFile8 } from "fs/promises";
8729
- import { homedir as homedir13, tmpdir } from "os";
8730
- import { basename, dirname as dirname7, join as join12 } from "path";
9447
+ import { chmod as chmod6, mkdir as mkdir10, mkdtemp, readFile as readFile9, rm as rm7, writeFile as writeFile9 } from "fs/promises";
9448
+ import { homedir as homedir14, tmpdir } from "os";
9449
+ import { basename, dirname as dirname7, join as join13 } from "path";
8731
9450
  var MODERN_MCP_VERSION = "2026-07-28";
8732
9451
  var WORKER_PROPAGATION_ATTEMPTS = 10;
8733
9452
  var WORKER_PROPAGATION_MAX_DELAY_MS = 4e3;
8734
9453
  var NodeDeploymentCommandRunner = class {
8735
9454
  async run(command, args, environment = {}) {
8736
9455
  return new Promise((resolve, reject) => {
8737
- const child = spawn3(command, args, {
9456
+ const child = spawn4(command, args, {
8738
9457
  env: { ...process.env, ...environment },
8739
9458
  stdio: ["ignore", "pipe", "pipe"],
8740
9459
  windowsHide: true
@@ -8968,7 +9687,7 @@ ${error.stderr}`)) {
8968
9687
  }
8969
9688
  };
8970
9689
  async function copyReleaseBundle(source, destination) {
8971
- await writeFile8(destination, await readFile8(source));
9690
+ await writeFile9(destination, await readFile9(source));
8972
9691
  }
8973
9692
  var NodeReleaseMaterializer = class {
8974
9693
  constructor(options) {
@@ -8977,13 +9696,13 @@ var NodeReleaseMaterializer = class {
8977
9696
  options;
8978
9697
  async prepare(plan, credentials) {
8979
9698
  const temporaryRoot = this.options.temporaryRoot ?? tmpdir();
8980
- await mkdir9(temporaryRoot, { recursive: true });
8981
- const artifactDirectory = await mkdtemp(join12(temporaryRoot, "moodle-mcp-"));
8982
- await chmod5(artifactDirectory, 448);
8983
- const workerFile = join12(artifactDirectory, basename(this.options.workerBundlePath));
9699
+ await mkdir10(temporaryRoot, { recursive: true });
9700
+ const artifactDirectory = await mkdtemp(join13(temporaryRoot, "moodle-mcp-"));
9701
+ await chmod6(artifactDirectory, 448);
9702
+ const workerFile = join13(artifactDirectory, basename(this.options.workerBundlePath));
8984
9703
  await copyReleaseBundle(this.options.workerBundlePath, workerFile);
8985
- const wranglerConfigPath = join12(artifactDirectory, "wrangler.json");
8986
- const secretsFilePath = join12(artifactDirectory, "secrets.json");
9704
+ const wranglerConfigPath = join13(artifactDirectory, "wrangler.json");
9705
+ const secretsFilePath = join13(artifactDirectory, "secrets.json");
8987
9706
  const expectedHosts = endpointHosts(plan.intent.workerName, plan.existing?.productionEndpoint);
8988
9707
  const config = {
8989
9708
  $schema: "node_modules/wrangler/config-schema.json",
@@ -9023,18 +9742,18 @@ var NodeReleaseMaterializer = class {
9023
9742
  if (credentials.previousTokensExpireAt !== void 0 && Number.isFinite(credentials.previousTokensExpireAt)) {
9024
9743
  secrets.TOKEN_OVERLAP_EXPIRES_AT = String(credentials.previousTokensExpireAt);
9025
9744
  }
9026
- await writeFile8(wranglerConfigPath, `${JSON.stringify(config, null, 2)}
9745
+ await writeFile9(wranglerConfigPath, `${JSON.stringify(config, null, 2)}
9027
9746
  `, { mode: 384 });
9028
- await writeFile8(secretsFilePath, `${JSON.stringify(secrets)}
9747
+ await writeFile9(secretsFilePath, `${JSON.stringify(secrets)}
9029
9748
  `, { mode: 384 });
9030
- await chmod5(wranglerConfigPath, 384);
9031
- await chmod5(secretsFilePath, 384);
9749
+ await chmod6(wranglerConfigPath, 384);
9750
+ await chmod6(secretsFilePath, 384);
9032
9751
  let recoveryConfigPath;
9033
9752
  try {
9034
- const recoveryBundle = process.env.MOODLE_BUNDLED_RECOVERY ?? join12(dirname7(this.options.workerBundlePath), "recovery.js");
9035
- await copyReleaseBundle(recoveryBundle, join12(artifactDirectory, "recovery.js"));
9036
- recoveryConfigPath = join12(artifactDirectory, "wrangler-recovery.json");
9037
- await writeFile8(recoveryConfigPath, `${JSON.stringify({ ...config, main: "./recovery.js" })}
9753
+ const recoveryBundle = process.env.MOODLE_BUNDLED_RECOVERY ?? join13(dirname7(this.options.workerBundlePath), "recovery.js");
9754
+ await copyReleaseBundle(recoveryBundle, join13(artifactDirectory, "recovery.js"));
9755
+ recoveryConfigPath = join13(artifactDirectory, "wrangler-recovery.json");
9756
+ await writeFile9(recoveryConfigPath, `${JSON.stringify({ ...config, main: "./recovery.js" })}
9038
9757
  `, { mode: 384 });
9039
9758
  } catch (error) {
9040
9759
  if (!isMissing4(error) || plan.existing) throw error;
@@ -9042,7 +9761,7 @@ var NodeReleaseMaterializer = class {
9042
9761
  return { artifactDirectory, wranglerConfigPath, secretsFilePath, recoveryConfigPath, encryptionKeyId: config.vars.SESSION_KEY_ID, credentialId: config.vars.SESSION_CREDENTIAL_ID };
9043
9762
  }
9044
9763
  async cleanup(release) {
9045
- await rm6(release.artifactDirectory, { recursive: true, force: true });
9764
+ await rm7(release.artifactDirectory, { recursive: true, force: true });
9046
9765
  }
9047
9766
  };
9048
9767
  var DefaultMoodleSessionSource = class {
@@ -9239,13 +9958,13 @@ var FetchManagedWorkerClient = class {
9239
9958
  }
9240
9959
  };
9241
9960
  var PrivateDeploymentReceiptStore = class {
9242
- constructor(baseDirectory = join12(homedir13(), ".config", "moodle-cli", "mcp", "deployments")) {
9961
+ constructor(baseDirectory = join13(homedir14(), ".config", "moodle-cli", "mcp", "deployments")) {
9243
9962
  this.baseDirectory = baseDirectory;
9244
9963
  }
9245
9964
  baseDirectory;
9246
9965
  async read(profile) {
9247
9966
  try {
9248
- const parsed = JSON.parse(await readFile8(this.path(profile), "utf8"));
9967
+ const parsed = JSON.parse(await readFile9(this.path(profile), "utf8"));
9249
9968
  return isReceipt(parsed) ? parsed : null;
9250
9969
  } catch (error) {
9251
9970
  if (isMissing4(error)) {
@@ -9256,24 +9975,24 @@ var PrivateDeploymentReceiptStore = class {
9256
9975
  }
9257
9976
  async write(receipt) {
9258
9977
  const path5 = this.path(receipt.profile);
9259
- await mkdir9(dirname7(path5), { recursive: true, mode: 448 });
9260
- await writeFile8(path5, `${JSON.stringify(receipt, null, 2)}
9978
+ await mkdir10(dirname7(path5), { recursive: true, mode: 448 });
9979
+ await writeFile9(path5, `${JSON.stringify(receipt, null, 2)}
9261
9980
  `, { mode: 384 });
9262
- await chmod5(path5, 384);
9981
+ await chmod6(path5, 384);
9263
9982
  }
9264
9983
  async delete(profile) {
9265
- await rm6(this.path(profile), { force: true });
9984
+ await rm7(this.path(profile), { force: true });
9266
9985
  }
9267
9986
  path(profile) {
9268
9987
  if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]{0,63}$/.test(profile)) {
9269
9988
  throw new Error("Invalid Moodle MCP profile name");
9270
9989
  }
9271
- return join12(this.baseDirectory, `${profile}.json`);
9990
+ return join13(this.baseDirectory, `${profile}.json`);
9272
9991
  }
9273
9992
  };
9274
9993
  function createDefaultManagedDeployment(options) {
9275
- const homeDirectory = options.homeDirectory ?? homedir13();
9276
- const platform = options.platform ?? process.platform;
9994
+ const homeDirectory = options.homeDirectory ?? homedir14();
9995
+ const platform2 = options.platform ?? process.platform;
9277
9996
  const runtime = runtimeCommand(options.executable, options.executableArgs);
9278
9997
  const defaults = {
9279
9998
  wrangler: new NodeWranglerDeploymentAdapter({ wranglerBinPath: options.wranglerBinPath }),
@@ -9281,12 +10000,12 @@ function createDefaultManagedDeployment(options) {
9281
10000
  workerBundlePath: options.workerBundlePath,
9282
10001
  compatibilityDate: options.compatibilityDate
9283
10002
  }),
9284
- credentials: createDefaultCredentialStore({ platform, homeDirectory }),
10003
+ credentials: createDefaultCredentialStore({ platform: platform2, homeDirectory }),
9285
10004
  sessions: createInteractiveMoodleSessionSource(options.auth),
9286
10005
  worker: new FetchManagedWorkerClient(options.fetch),
9287
10006
  renewal: new DefaultRenewalIntegration({
9288
10007
  ...options.renewal,
9289
- platform,
10008
+ platform: platform2,
9290
10009
  homeDirectory,
9291
10010
  executable: runtime.command,
9292
10011
  executableArgs: runtime.args,
@@ -9294,12 +10013,12 @@ function createDefaultManagedDeployment(options) {
9294
10013
  }),
9295
10014
  clients: new DefaultClientIntegration({
9296
10015
  ...options.connector,
9297
- platform,
10016
+ platform: platform2,
9298
10017
  homeDirectory,
9299
10018
  command: runtime.command,
9300
10019
  commandArgs: runtime.args
9301
10020
  }),
9302
- receipts: new PrivateDeploymentReceiptStore(join12(homeDirectory, ".config", "moodle-cli", "mcp", "deployments")),
10021
+ receipts: new PrivateDeploymentReceiptStore(join13(homeDirectory, ".config", "moodle-cli", "mcp", "deployments")),
9303
10022
  createToken: () => randomBytes2(32).toString("base64url")
9304
10023
  };
9305
10024
  return new ManagedMcpDeployment({ ...defaults, ...options.dependencies });
@@ -9316,7 +10035,7 @@ function endpointUrl(endpoint, path5) {
9316
10035
  async function pinExpectedHosts(configPath, workerName, productionEndpoint) {
9317
10036
  let config;
9318
10037
  try {
9319
- config = JSON.parse(await readFile8(configPath, "utf8"));
10038
+ config = JSON.parse(await readFile9(configPath, "utf8"));
9320
10039
  } catch {
9321
10040
  throw new DeploymentApplyError("RELEASE_CONFIG_INVALID", "The generated Wrangler configuration is invalid");
9322
10041
  }
@@ -9328,7 +10047,7 @@ async function pinExpectedHosts(configPath, workerName, productionEndpoint) {
9328
10047
  throw new DeploymentApplyError("MISSING_ENDPOINT", "The Worker production endpoint is invalid");
9329
10048
  }
9330
10049
  config.vars.EXPECTED_HOSTS = hosts.join(",");
9331
- await writeFile8(configPath, `${JSON.stringify(config, null, 2)}
10050
+ await writeFile9(configPath, `${JSON.stringify(config, null, 2)}
9332
10051
  `, { mode: 384 });
9333
10052
  }
9334
10053
  function endpointHosts(workerName, endpoint) {
@@ -9593,7 +10312,10 @@ function createMoodleMcpServer(gateway, options = {}) {
9593
10312
  protocolVersion: protocolVersion2,
9594
10313
  capabilities: { tools: { listChanged: false } },
9595
10314
  serverInfo,
9596
- instructions: gateway.submitAssignment ? "Access to the authenticated user's Moodle data. Only submit writes; it defaults to a dry run." : "Read-only access to the authenticated user's Moodle data."
10315
+ instructions: [
10316
+ gateway.submitAssignment ? "Access to the authenticated user's Moodle data. Only submit writes; it defaults to a dry run." : "Read-only access to the authenticated user's Moodle data.",
10317
+ ...options.instructions ?? []
10318
+ ].join(" ")
9597
10319
  });
9598
10320
  }
9599
10321
  if (request.method === "ping") {
@@ -9714,6 +10436,9 @@ async function callTool(gateway, params) {
9714
10436
  function toolContent(name, payload, structuredContent) {
9715
10437
  const text2 = { type: "text", text: JSON.stringify(structuredContent) };
9716
10438
  if (name !== "get_file" || !isMoodleFile(payload)) return [text2];
10439
+ if (payload.mimeType.startsWith("image/")) {
10440
+ return [text2, { type: "image", data: payload.blob, mimeType: payload.mimeType }];
10441
+ }
9717
10442
  return [
9718
10443
  text2,
9719
10444
  {
@@ -9838,9 +10563,9 @@ function deriveMcpWorkerName(moodleOrigin) {
9838
10563
  var DefaultMcpCommandService = class {
9839
10564
  constructor(options) {
9840
10565
  this.options = options;
9841
- this.homeDirectory = options.homeDir ?? homedir14();
10566
+ this.homeDirectory = options.homeDir ?? homedir15();
9842
10567
  this.wranglerInstance = options.wrangler;
9843
- this.receipts = options.receipts ?? new PrivateDeploymentReceiptStore(join13(this.homeDirectory, ".config", "moodle-cli", "mcp", "deployments"));
10568
+ this.receipts = options.receipts ?? new PrivateDeploymentReceiptStore(join14(this.homeDirectory, ".config", "moodle-cli", "mcp", "deployments"));
9844
10569
  this.credentials = options.credentials ?? createDefaultCredentialStore({ platform: process.platform, homeDirectory: this.homeDirectory });
9845
10570
  this.worker = options.worker ?? new FetchManagedWorkerClient(options.fetchImpl);
9846
10571
  this.renewal = options.renewal ?? new DefaultRenewalIntegration({
@@ -9877,7 +10602,8 @@ var DefaultMcpCommandService = class {
9877
10602
  const recovery = await deployment.rollback(identity.profile);
9878
10603
  return {
9879
10604
  data: recovery,
9880
- text: `Moodle MCP restored release ${recovery.versionId}.`
10605
+ text: `${theme.tone("success", "Moodle MCP restored release")} ${theme.key(recovery.versionId)}.`,
10606
+ next: ["moodle mcp status"]
9881
10607
  };
9882
10608
  }
9883
10609
  progress.begin("Planning the deployment");
@@ -9899,11 +10625,12 @@ var DefaultMcpCommandService = class {
9899
10625
  uploadCandidate: plan.uploadCandidate
9900
10626
  },
9901
10627
  text: [
9902
- "Moodle MCP deployment plan",
9903
- `Operation: ${plan.operation}`,
9904
- `Worker: ${plan.intent.workerName}`,
9905
- `Candidate upload: ${plan.uploadCandidate ? "yes" : "no"}`
9906
- ].join("\n")
10628
+ theme.subject("Moodle MCP deployment plan"),
10629
+ ` ${theme.dim("Operation:")} ${plan.operation}`,
10630
+ ` ${theme.dim("Worker:")} ${theme.key(plan.intent.workerName)}`,
10631
+ ` ${theme.dim("Candidate upload:")} ${plan.uploadCandidate ? "yes" : "no"}`
10632
+ ].join("\n"),
10633
+ next: ["moodle mcp deploy"]
9907
10634
  };
9908
10635
  }
9909
10636
  const events = [];
@@ -9932,8 +10659,10 @@ var DefaultMcpCommandService = class {
9932
10659
  endpoint: `${endpoint.replace(/\/$/u, "")}/mcp`,
9933
10660
  moodleSite: identity.moodleOrigin,
9934
10661
  moodleUser: events.find((event2) => event2.moodleUser)?.moodleUser ?? "Unknown Moodle user",
9935
- clients: await this.connectedClientNames(identity.profile)
9936
- }, this.theme())
10662
+ clients: await this.connectedClientNames(identity.profile),
10663
+ renewal: this.renewalJob(identity.profile)
10664
+ }, this.theme()),
10665
+ next: ["moodle mcp status", "moodle mcp pair"]
9937
10666
  };
9938
10667
  }
9939
10668
  async planDeployment(deployment, initialIntent) {
@@ -9996,29 +10725,54 @@ var DefaultMcpCommandService = class {
9996
10725
  localAuthentication = { status: "unknown" };
9997
10726
  }
9998
10727
  const updateAvailable = await this.remoteWorkerBehindLocal(profile);
10728
+ const [receipt, credentials] = await Promise.all([
10729
+ this.receipts.read(profile),
10730
+ readCredentialsForReport(() => this.credentials.read(profile))
10731
+ ]);
10732
+ const job = this.renewalJob(profile);
10733
+ const hosted = receipt && credentials.value ? await this.worker.manageClients({ endpoint: receipt.productionEndpoint, sessionSyncToken: credentials.value.sessionSyncToken }).then((data2) => isClientList(data2) ? data2.clients.filter((client) => client.approved).length : null).catch(() => null) : null;
10734
+ const credentialsState = !credentials.available || !managed.credentialsAvailable ? "unavailable" : managed.credentialsStored ? "stored" : "missing";
10735
+ const renewal = {
10736
+ installed: managed.renewalInstalled,
10737
+ ...job ? { scheduler: job.scheduler, label: job.label, schedule: job.schedule, log: job.log } : {},
10738
+ lastRun: receipt?.lastRenewal ?? null
10739
+ };
9999
10740
  const data = {
10000
10741
  profile,
10001
10742
  localAuthentication,
10002
10743
  managed,
10744
+ credentials: { state: credentialsState },
10745
+ renewal,
10746
+ hostedClients: hosted,
10003
10747
  protocols: [...SUPPORTED_PROTOCOL_VERSIONS],
10004
10748
  updateAvailable,
10005
10749
  ...input2.verbose ? { serviceVersion: VERSION } : {},
10006
10750
  ...input2.logs ? { logs: { available: false, reason: "live_tail_required" } } : {}
10007
10751
  };
10008
10752
  const theme = this.theme();
10009
- const row = (label, value) => `${theme.dim(`${label}:`)} ${theme.status(value, { pass: "success", warn: "warning", fail: "danger", unknown: "muted", "not deployed": "warning", missing: "warning", "not connected": "warning", stored: "success", installed: "success", connected: "success" })}`;
10753
+ const row = (label, value) => `${theme.dim(`${label}:`)} ${theme.status(value, { pass: "success", warn: "warning", fail: "danger", unknown: "muted", "not deployed": "warning", missing: "warning", "not connected": "warning", unavailable: "warning", stored: "success", installed: "success", connected: "success" })}`;
10010
10754
  return {
10011
10755
  data,
10012
10756
  text: [
10013
10757
  row("Moodle MCP", managed.readiness),
10014
10758
  row("Worker", managed.worker?.workerName ?? "not deployed"),
10015
- row("Credentials", managed.credentialsStored ? "stored" : "missing"),
10759
+ row("Credentials", credentialsState),
10016
10760
  row("Renewal", managed.renewalInstalled ? "installed" : "missing"),
10017
- row("Clients", managed.clientsConnected ? "connected" : "not connected"),
10761
+ ...managed.renewalInstalled && job ? [` ${theme.dim(`${job.schedule}; you only hear from it when Moodle signs you out`)}`] : [],
10762
+ ` ${theme.dim("Last run:")} ${renewalRunText(renewal.lastRun, theme)}`,
10763
+ ...managed.renewalInstalled && job && input2.verbose ? [` ${theme.dim("Log:")} ${theme.dim(job.log)}`] : [],
10764
+ row("Local clients", managed.clientsConnected ? "connected" : "not connected"),
10765
+ `${theme.dim("Hosted clients:")} ${hosted === null ? theme.dim("unknown") : hosted ? `${hosted} approved` : theme.dim("none")}`,
10018
10766
  ...managed.recoveryActive ? [`${theme.dim("Release:")} ${theme.tone("warning", "the recovery Worker is live; OAuth sign-in is disabled until")} ${theme.key("moodle mcp deploy")} ${theme.tone("warning", "succeeds.")}`] : [],
10019
- ...updateAvailable ? [`${theme.dim("Update:")} remote Worker is behind this CLI. Run ${theme.key("moodle mcp deploy")} to update it.`] : [],
10767
+ ...updateAvailable ? [`${theme.dim("Update:")} remote Worker is behind this CLI. Run ${theme.key("moodle update")} to update it.`] : [],
10020
10768
  ...input2.logs ? [`${theme.dim("Logs:")} use a live sanitized tail from an interactive terminal`] : []
10021
- ].join("\n")
10769
+ ].join("\n"),
10770
+ next: [
10771
+ ...updateAvailable ? ["moodle update"] : [],
10772
+ ...managed.readiness === "fail" ? ["moodle mcp login"] : [],
10773
+ ...!managed.clientsConnected ? ["moodle mcp connect"] : [],
10774
+ ...hosted ? [] : ["moodle mcp pair"]
10775
+ ]
10022
10776
  };
10023
10777
  }
10024
10778
  async login() {
@@ -10028,9 +10782,12 @@ var DefaultMcpCommandService = class {
10028
10782
  try {
10029
10783
  progress.begin("Reading your Moodle session (a browser sign-in may be required)");
10030
10784
  const recovery = await this.deployment(false).recover(profile);
10785
+ const theme = this.theme();
10786
+ const done = (line) => `${theme.tone("success", "\u2713")} ${line}`;
10031
10787
  return {
10032
10788
  data: recovery,
10033
- text: "\u2713 New Moodle session acquired.\n\u2713 Remote session updated.\n\u2713 MCP readiness restored."
10789
+ text: [done("New Moodle session acquired."), done("Remote session updated."), done("MCP readiness restored.")].join("\n"),
10790
+ next: ["moodle mcp status"]
10034
10791
  };
10035
10792
  } finally {
10036
10793
  progress.clear();
@@ -10059,13 +10816,15 @@ var DefaultMcpCommandService = class {
10059
10816
  }
10060
10817
  const connected = [];
10061
10818
  for (const connector of selected) connected.push(await connectClient(connector));
10819
+ const theme = this.theme();
10062
10820
  const text2 = [
10063
- ...connected.map((item) => `\u2713 ${item.client}`),
10064
- ...input2.showToken ? ["", "MCP access token", credentials.mcpAccessToken] : []
10821
+ ...connected.map((item) => `${theme.tone("success", "\u2713")} ${item.client} ${theme.dim(item.changed ? `\xB7 ${item.configPath}` : "\xB7 already connected")}`),
10822
+ ...input2.showToken ? ["", theme.subject("MCP access token"), ` ${credentials.mcpAccessToken}`] : []
10065
10823
  ].join("\n");
10066
10824
  return {
10067
10825
  data: { profile, mode: input2.mode, connected: connected.map(({ client, configPath, changed }) => ({ client, configPath, changed })) },
10068
- text: text2
10826
+ text: text2,
10827
+ next: ["moodle mcp status"]
10069
10828
  };
10070
10829
  }
10071
10830
  async manageClients(input2) {
@@ -10075,7 +10834,19 @@ var DefaultMcpCommandService = class {
10075
10834
  const credentials = await this.credentials.read(profile);
10076
10835
  if (!receipt || !credentials) throw new UsageError(`No managed Moodle MCP deployment exists for profile ${profile}.`);
10077
10836
  const data = await this.worker.manageClients({ endpoint: receipt.productionEndpoint, sessionSyncToken: credentials.sessionSyncToken, ...input2 });
10078
- return { data, text: input2.revoke ? "OAuth authorization revoked." : JSON.stringify(data, null, 2) };
10837
+ const theme = this.theme();
10838
+ if (input2.revoke) {
10839
+ return { data, text: theme.tone("success", input2.clientId ? "OAuth client revoked." : "All OAuth access revoked."), next: ["moodle mcp pair"] };
10840
+ }
10841
+ const clients = isClientList(data) ? data.clients : [];
10842
+ return {
10843
+ data,
10844
+ text: clients.length ? [
10845
+ theme.subject("OAuth clients"),
10846
+ ...clients.map((client) => ` ${theme.status(client.approved ? "approved" : "pending", { approved: "success", pending: "warning" }).padEnd(theme.enabled ? 18 : 9)} ${client.clientName} ${theme.dim(client.clientId)}`)
10847
+ ].join("\n") : theme.dim("No OAuth clients."),
10848
+ next: clients.length ? [`moodle mcp revoke ${clients[0].clientId}`, "moodle mcp pair"] : ["moodle mcp pair"]
10849
+ };
10079
10850
  }
10080
10851
  async pair() {
10081
10852
  const profile = deriveMcpProfile((await this.config()).baseUrl);
@@ -10097,17 +10868,8 @@ var DefaultMcpCommandService = class {
10097
10868
  expiresAt: pairing.expiresAt,
10098
10869
  authorizationServer: pairing.authorizationServer
10099
10870
  },
10100
- text: [
10101
- "Add this custom connector in Claude, then approve it with the pairing code.",
10102
- "",
10103
- "Connector URL",
10104
- ` ${endpoint}`,
10105
- "",
10106
- "Pairing code",
10107
- ` ${formatPairingCode(pairing.code)}`,
10108
- "",
10109
- `The code expires at ${pairing.expiresAt} and works for one approval.`
10110
- ].join("\n")
10871
+ text: pairingCopy({ endpoint, code: pairing.code, expiresAt: pairing.expiresAt }, this.theme()),
10872
+ next: ["moodle mcp clients"]
10111
10873
  };
10112
10874
  }
10113
10875
  async remove(input2) {
@@ -10123,11 +10885,12 @@ var DefaultMcpCommandService = class {
10123
10885
  return {
10124
10886
  data: result,
10125
10887
  text: [
10126
- "Moodle MCP has been removed.",
10127
- `Worker: ${result.workerRemoved ? "deleted" : "not present"}`,
10128
- "Local renewal, client registrations, and deployment credentials: deleted",
10129
- "Local Moodle configuration: kept; matching authentication cache: removed"
10130
- ].join("\n")
10888
+ this.theme().tone("success", "Moodle MCP has been removed."),
10889
+ ` ${this.theme().dim("Worker:")} ${result.workerRemoved ? "deleted" : "not present"}`,
10890
+ ` ${this.theme().dim("Renewal job, client registrations, deployment credentials:")} deleted`,
10891
+ ` ${this.theme().dim("Local Moodle configuration:")} kept ${this.theme().dim("(its authentication cache was removed)")}`
10892
+ ].join("\n"),
10893
+ next: ["moodle mcp deploy"]
10131
10894
  };
10132
10895
  }
10133
10896
  async serveStdio() {
@@ -10237,16 +11000,22 @@ var DefaultMcpCommandService = class {
10237
11000
  notifySignIn: this.notifyRenewalSignIn
10238
11001
  };
10239
11002
  const decision = await executeRenewalWithRecovery(decideRenewal(snapshot), snapshot, executor);
11003
+ const outcome = uploaded ? { state: "healthy", reasonCode: "SESSION_VALID" } : { state: decision.state, reasonCode: decision.reasonCode };
11004
+ receipt = { ...receipt, lastRenewal: { at: (/* @__PURE__ */ new Date()).toISOString(), ...outcome } };
11005
+ await this.receipts.write(receipt);
11006
+ const theme = this.theme();
10240
11007
  if (uploaded) {
10241
11008
  return {
10242
- data: { profile, state: "healthy", reasonCode: "SESSION_VALID", revision: receipt.sessionRevision },
10243
- text: "Moodle MCP session renewed."
11009
+ data: { profile, ...outcome, revision: receipt.sessionRevision },
11010
+ text: theme.tone("success", "Moodle MCP session renewed."),
11011
+ next: ["moodle mcp status"]
10244
11012
  };
10245
11013
  }
10246
11014
  const detail = decision.state === "needs_sign_in" && signInDetail ? { detail: signInDetail } : {};
10247
11015
  return {
10248
- data: { profile, state: decision.state, reasonCode: decision.reasonCode, revision: receipt.sessionRevision, ...detail },
10249
- text: [renewalResultText(decision), signInDetail].filter(Boolean).join("\n")
11016
+ data: { profile, ...outcome, revision: receipt.sessionRevision, ...detail },
11017
+ text: [renewalResultText(decision, theme), signInDetail].filter(Boolean).join("\n"),
11018
+ next: [decision.state === "needs_sign_in" ? "moodle mcp login" : "moodle mcp status"]
10250
11019
  };
10251
11020
  }
10252
11021
  async writeRenewalRevision(receipt, revision) {
@@ -10288,7 +11057,7 @@ var DefaultMcpCommandService = class {
10288
11057
  }
10289
11058
  });
10290
11059
  await this.receipts.write({ ...receipt, sessionRevision: uploaded.revision });
10291
- return { data: { profile, revision: uploaded.revision }, text: "Moodle MCP session updated." };
11060
+ return { data: { profile, revision: uploaded.revision }, text: this.theme().tone("success", "Moodle MCP session updated."), next: ["moodle mcp status"] };
10292
11061
  }
10293
11062
  deployment(background) {
10294
11063
  if (this.options.createDeployment) return this.options.createDeployment(background);
@@ -10397,13 +11166,13 @@ Selection: `)).trim());
10397
11166
  fetch: this.options.fetchImpl
10398
11167
  });
10399
11168
  }
10400
- prompt(question) {
11169
+ prompt(question2) {
10401
11170
  this.progress().clear();
10402
- if (this.options.prompt) return this.options.prompt(question);
11171
+ if (this.options.prompt) return this.options.prompt(question2);
10403
11172
  const input2 = this.options.stdin ?? process.stdin;
10404
11173
  const output = this.options.stderr ?? process.stderr;
10405
11174
  const readline = createInterface({ input: input2, output });
10406
- return readline.question(question).finally(() => readline.close());
11175
+ return readline.question(question2).finally(() => readline.close());
10407
11176
  }
10408
11177
  workerBundlePath() {
10409
11178
  return this.options.workerBundlePath ?? process.env.MOODLE_BUNDLED_WORKER ?? fileURLToPath(new URL("./worker/worker.js", import.meta.url));
@@ -10412,6 +11181,21 @@ Selection: `)).trim());
10412
11181
  this.wranglerInstance ??= new NodeWranglerDeploymentAdapter();
10413
11182
  return this.wranglerInstance;
10414
11183
  }
11184
+ async workerState() {
11185
+ try {
11186
+ const profile = deriveMcpProfile((await this.config()).baseUrl);
11187
+ const [receipt, credentials] = await Promise.all([
11188
+ this.receipts.read(profile),
11189
+ readCredentialsForReport(() => this.credentials.read(profile))
11190
+ ]);
11191
+ if (!receipt || !credentials.value) return null;
11192
+ const behind = await this.remoteWorkerBehindLocal(profile);
11193
+ const readiness = await this.worker.getReadiness({ endpoint: receipt.productionEndpoint, sessionSyncToken: credentials.value.sessionSyncToken }).catch(() => null);
11194
+ return { behind, ready: readiness?.status === "pass" };
11195
+ } catch {
11196
+ return null;
11197
+ }
11198
+ }
10415
11199
  // The first-use Wrangler download asks a question, so it runs before a spinner
10416
11200
  // owns the terminal rather than drawing its prompt underneath one.
10417
11201
  async prepareToolchain(yes = false) {
@@ -10419,7 +11203,7 @@ Selection: `)).trim());
10419
11203
  await this.wrangler().prepare({ yes });
10420
11204
  }
10421
11205
  releaseDigest() {
10422
- return readFile9(this.workerBundlePath()).then((content) => sha256(content));
11206
+ return readFile10(this.workerBundlePath()).then((content) => sha256(content));
10423
11207
  }
10424
11208
  // True when a deployment receipt exists but its recorded release digest no
10425
11209
  // longer matches the Worker bundle shipped with this CLI, i.e. the remote
@@ -10442,6 +11226,10 @@ Selection: `)).trim());
10442
11226
  theme() {
10443
11227
  return createTheme4(this.options.color?.() ?? false);
10444
11228
  }
11229
+ renewalJob(profile) {
11230
+ const platform2 = process.platform;
11231
+ return platform2 === "darwin" || platform2 === "linux" || platform2 === "win32" ? describeRenewalJob(platform2, this.homeDirectory, profile) : void 0;
11232
+ }
10445
11233
  progress() {
10446
11234
  this.progressReporter ??= createProgressReporter({ stream: this.options.stderr ?? process.stderr });
10447
11235
  return this.progressReporter;
@@ -10506,12 +11294,36 @@ function isWranglerAuthRequired(error) {
10506
11294
  return error instanceof WranglerCommandError && /not authenticated|not logged in|wrangler login/iu.test(`${error.stdout}
10507
11295
  ${error.stderr}`);
10508
11296
  }
10509
- function renewalResultText(decision) {
10510
- if (decision.state === "offline") return "Moodle is unreachable. The remote session was preserved.";
10511
- if (decision.state === "needs_sign_in") return "Moodle MCP needs sign-in. Run `moodle mcp login`.";
11297
+ function renewalResultText(decision, theme) {
11298
+ if (decision.state === "offline") return `${theme.tone("warning", "Moodle is unreachable.")} The remote session was preserved.`;
11299
+ if (decision.state === "needs_sign_in") return `${theme.tone("warning", "Moodle MCP needs sign-in.")} Run ${theme.key("moodle mcp login")}.`;
10512
11300
  if (decision.state === "conflict") return "Moodle MCP refreshed the remote session revision without overwriting it.";
10513
- if (decision.reasonCode === "RENEWAL_AGENT_MISSING") return "Moodle MCP renewal agent installed.";
10514
- return "Moodle MCP session is ready.";
11301
+ if (decision.reasonCode === "RENEWAL_AGENT_MISSING") return theme.tone("success", "Moodle MCP renewal agent installed.");
11302
+ return theme.tone("success", "Moodle MCP session is ready.");
11303
+ }
11304
+ function isClientList(value) {
11305
+ return typeof value === "object" && value !== null && Array.isArray(value.clients);
11306
+ }
11307
+ function renewalRunText(lastRun, theme) {
11308
+ if (!lastRun) return theme.dim("never (the job has not reported yet)");
11309
+ const ago = Math.max(0, Math.round((Date.now() - Date.parse(lastRun.at)) / 6e4));
11310
+ const when = ago < 1 ? "just now" : ago < 120 ? `${ago} min ago` : ago < 48 * 60 ? `${Math.round(ago / 60)} h ago` : `${Math.round(ago / 1440)} days ago`;
11311
+ return `${when} ${theme.status(lastRun.state.replaceAll("_", " "), { healthy: "success", "needs sign in": "warning", offline: "warning", conflict: "warning" })}`;
11312
+ }
11313
+ function pairingCopy(input2, theme) {
11314
+ const expires = new Date(input2.expiresAt);
11315
+ const minutes = Math.max(0, Math.round((expires.getTime() - Date.now()) / 6e4));
11316
+ return [
11317
+ "Add this custom connector in Claude, then approve it with the pairing code.",
11318
+ "",
11319
+ theme.subject("Connector URL"),
11320
+ ` ${theme.key(input2.endpoint)}`,
11321
+ "",
11322
+ theme.subject("Pairing code"),
11323
+ ` ${theme.key(formatPairingCode(input2.code))}`,
11324
+ "",
11325
+ theme.dim(`One approval, valid for ${minutes} minutes (until ${expires.toLocaleTimeString([], { hour: "2-digit", minute: "2-digit" })}).`)
11326
+ ].join("\n");
10515
11327
  }
10516
11328
  async function selectConnectors(connectors, requested) {
10517
11329
  const normalized = normalizeClientName(requested);
@@ -10595,7 +11407,7 @@ function buildProgram(io = {}) {
10595
11407
  program.option("--pretty", "Indent JSON output.");
10596
11408
  program.option("--limit <number>", "Maximum returned rows.", parsePositiveInt);
10597
11409
  program.option("--days <number>", "Deadline window in days.", parsePositiveInt);
10598
- const verbose = program.options.find((option) => option.long === "--verbose");
11410
+ const verbose = program.options.find((option2) => option2.long === "--verbose");
10599
11411
  if (verbose) {
10600
11412
  verbose.short = "-v";
10601
11413
  verbose.flags = "-v, --verbose";
@@ -10798,6 +11610,46 @@ ${tryLines(["moodle due", "moodle units", "moodle --help"])}`}
10798
11610
  command.option("--limit <number>", "Maximum returned rows.", parsePositiveInt).action(async (unit, options) => execute(name, { unit, limit: count("limit", options.limit), ...name === "due" ? { days: count("days", options.days) } : {} }, options));
10799
11611
  }
10800
11612
  addOutputOptions(program.command("find").description(humanDescription("find")).argument("<query>", "Words to look for").argument("[unit]", "Unit code, name, id or URL")).option("--limit <number>", "Maximum returned rows.", parsePositiveInt).option("--types <types>", "Comma-separated activity types.").action(async (query, unit, options) => execute("find", { query, unit, limit: count("limit", options.limit), types: options.types?.split(",") }, options));
11613
+ addOutputOptions(program.command("attempt").description(humanDescription("attempt")).argument("<ref>", "Quiz attempt id or review URL")).action(async (ref2, options) => execute("attempt", { attempt: ref2 }, options));
11614
+ const dev = program.command("dev", { hidden: true }).description("Maintainer utilities.");
11615
+ dev.command("fetch").description("Print a same-site page as HTML with the session; sesskey values are redacted.").argument("<url>").action(async (url) => {
11616
+ const client = await runtime.getClient();
11617
+ if (new URL(url).origin !== new URL(client.baseUrl).origin) throw new UsageError("The URL must belong to the configured Moodle site.");
11618
+ const html = await (await client.requestAbsolute(url)).text();
11619
+ stdout.write(`${redactSesskey(html)}
11620
+ `);
11621
+ });
11622
+ addOutputOptions(mutating(program.command("update").description("Update the package and redeploy the managed MCP Worker when either is behind."))).option("--check", "Report versions without installing or deploying.").option("--quiet", "Print nothing; refresh the cached version only.").action(async (options) => {
11623
+ const updateOptions = { homeDir: io.homeDir, env: io.env, fetchImpl: io.fetchImpl };
11624
+ if (options.quiet) {
11625
+ await refreshLatestVersion(updateOptions);
11626
+ return;
11627
+ }
11628
+ const worker = await getMcpService().workerState();
11629
+ const palette = theme();
11630
+ const workerLine = worker === null ? [] : [`${palette.dim("Worker:")} ${palette.status(worker.behind ? "behind this package" : worker.ready ? "current" : "not ready", { current: "success", "behind this package": "warning", "not ready": "danger" })}`];
11631
+ if (options.check) {
11632
+ const latest = await refreshLatestVersion(updateOptions);
11633
+ const available = isNewerVersion(latest ?? void 0, VERSION);
11634
+ const report2 = { current: VERSION, latest, update_available: available, ...worker ? { worker_behind: worker.behind, worker_ready: worker.ready } : {} };
11635
+ await runtime.output(report2, () => [
11636
+ `${palette.dim("moodle-cli:")} ${palette.key(VERSION)} ${available ? palette.tone("warning", `\u2192 ${latest} available`) : latest ? palette.dim("(latest)") : palette.tone("warning", "(npm unreachable)")}`,
11637
+ ...workerLine,
11638
+ ...available || worker?.behind ? ["", tryLines(["moodle update"])] : []
11639
+ ].join("\n"), options);
11640
+ return;
11641
+ }
11642
+ if (program.opts().dryRun) {
11643
+ const latest = await refreshLatestVersion(updateOptions);
11644
+ const steps = [...isNewerVersion(latest ?? void 0, VERSION) ? [`install moodle-cli ${latest}`] : [], ...worker?.behind ? ["redeploy the Worker"] : []];
11645
+ await runtime.output({ planned: steps, current: VERSION, latest }, () => steps.length ? `Would ${steps.join(", then ")}.` : "Nothing to do; everything is current.", options);
11646
+ return;
11647
+ }
11648
+ const report = await runUpdate({ ...updateOptions, workerBehind: worker?.behind });
11649
+ const stale = worker && !worker.ready && !report.deployed ? [`${palette.tone("warning", "The Worker is deployed but not answering.")} ${tryLines(["moodle mcp status"])}`] : [];
11650
+ await runtime.output({ ...report, ...worker ? { worker_ready: worker.ready } : {} }, () => [palette.tone(report.ok ? report.updated || report.deployed ? "success" : "muted" : "danger", report.note), ...stale].join("\n"), options);
11651
+ if (!report.ok) throw new CliError2("upstream", report.note);
11652
+ });
10801
11653
  addOutputOptions(program.command("get").description("Download a resource by id, URL, or UNIT TASK phrase.").argument("<ref>", "Resource id, URL, or UNIT TASK phrase")).option("--to <directory>", "Destination directory.").option("--force", "Replace an existing file atomically.").action(async (ref2, options) => {
10802
11654
  const client = await runtime.getClient();
10803
11655
  const service = createIntentService(createMoodleGateway(client));
@@ -10832,6 +11684,75 @@ ${tryLines(["moodle due", "moodle units", "moodle --help"])}`}
10832
11684
  }
10833
11685
  await runtime.output(result, () => formatSubmissionReceipt(result.submission), options);
10834
11686
  });
11687
+ const quiz = program.command("quiz").description("Take a quiz: start an attempt, answer questions, finish it. Beta.").summary("Take a quiz (beta)");
11688
+ quiz.addHelpText("after", `
11689
+ ${QUIZ_NOTICE.join("\n")}
11690
+ `);
11691
+ const quizConsent = async (summary) => {
11692
+ const palette = theme();
11693
+ if (!program.opts().yes && !human()) throw new UsageError("Quiz actions need --yes when stdin is not interactive.", QUIZ_NOTICE.join(" "));
11694
+ const notice = [palette.tone("warning", "BETA"), ...QUIZ_NOTICE.map((line) => palette.dim(line))].join("\n");
11695
+ return confirm({ summary: `${notice}
11696
+
11697
+ ${summary}` }, { yes: Boolean(program.opts().yes), dryRun: false, interactive: human() });
11698
+ };
11699
+ const attemptNext = (page) => {
11700
+ const open = page.navigation.find((entry) => entry.number !== "i" && /not yet|not answered/iu.test(entry.state));
11701
+ if (!open) return [`moodle quiz finish ${page.attempt} ${page.quiz_id}`];
11702
+ return [
11703
+ `moodle quiz answer ${page.attempt} ${page.quiz_id} ${open.number} <answer>`,
11704
+ ...open.page === page.page ? [] : [`moodle quiz show ${page.attempt} ${page.quiz_id} --page ${open.page + 1}`]
11705
+ ];
11706
+ };
11707
+ const showPage = (page, palette) => `${palette.tone("warning", "BETA")} ${formatAttemptPage(page)}
11708
+
11709
+ ${tryLines(attemptNext(page))}`;
11710
+ addOutputOptions(mutating(quiz.command("start").description("Start a new attempt, or continue the one in progress, and show its first page.").argument("<ref>", "Quiz id, URL, or UNIT TASK phrase"))).option("--password <password>", "Quiz access password for scripts; at a terminal you are asked for it instead.").action(async (ref2, options) => {
11711
+ const client = await runtime.getClient();
11712
+ const service = createIntentService(createMoodleGateway(client));
11713
+ const id2 = await choose(() => service.resolveItem(ref2), (id3) => Promise.resolve(id3));
11714
+ if (!program.opts().dryRun && !await quizConsent(`Start or continue an attempt on quiz ${theme().target(String(id2))}. Moodle records the attempt and its start time.`)) return;
11715
+ if (program.opts().dryRun) return runtime.output({ planned: "start", quiz_id: id2 }, () => `Would start an attempt on quiz ${id2}.`, options);
11716
+ const password = async () => {
11717
+ if (options.password) return options.password;
11718
+ const input2 = io.stdin ?? process.stdin;
11719
+ if (!human() || !input2.isTTY) return null;
11720
+ return readSecretLine(input2, stderr, "Quiz password (not echoed): ");
11721
+ };
11722
+ const page = await client.startQuizAttempt(id2, { password });
11723
+ await runtime.output({ attempt: page }, () => showPage(page, theme()), options);
11724
+ });
11725
+ addOutputOptions(quiz.command("show").description("Show one page of an attempt in progress: questions, options and saved answers.").argument("<attempt>", "Attempt id").argument("<quiz>", "Quiz id")).option("--page <n>", "Page number, starting at 1.", parsePositiveInt).action(async (attempt, quizId, options) => {
11726
+ const client = await runtime.getClient();
11727
+ const page = await client.getQuizAttemptPage(parsePositiveInt(attempt), parsePositiveInt(quizId), (options.page ?? 1) - 1);
11728
+ await runtime.output({ attempt: page }, () => showPage(page, theme()), options);
11729
+ });
11730
+ addOutputOptions(mutating(quiz.command("answer").description("Save one answer: option letters for a choice question (b, or a,c), the text otherwise.").argument("<attempt>", "Attempt id").argument("<quiz>", "Quiz id").argument("<question>", "Question number as shown").argument("[answer]", "Option letters or answer text"))).option("--from <file>", "Read the answer text from a file.").action(async (attempt, quizId, question2, answer, options) => {
11731
+ const value = options.from ? await readFile11(path4.resolve(io.cwd ?? process.cwd(), options.from), "utf8") : answer;
11732
+ if (!value?.trim()) throw new UsageError("Give the answer as an argument or with --from <file>.");
11733
+ const request = { attemptId: parsePositiveInt(attempt), quizId: parsePositiveInt(quizId), question: question2, value };
11734
+ const palette = theme();
11735
+ const preview2 = value.trim().length > 80 ? `${value.trim().slice(0, 77)}...` : value.trim();
11736
+ if (program.opts().dryRun) return runtime.output({ planned: "answer", ...request }, () => `Would answer question ${question2} of attempt ${attempt} with: ${preview2}`, options);
11737
+ if (!await quizConsent(`Save ${palette.subject(preview2)} as the answer to question ${palette.target(question2)} of attempt ${attempt}.`)) return;
11738
+ const client = await runtime.getClient();
11739
+ const page = await client.answerQuizQuestion(request);
11740
+ await runtime.output({ attempt: page }, () => showPage(page, palette), options);
11741
+ });
11742
+ addOutputOptions(mutating(quiz.command("finish").description("Submit the attempt for grading. Moodle does not allow undoing this.").argument("<attempt>", "Attempt id").argument("<quiz>", "Quiz id"))).action(async (attempt, quizId, options) => {
11743
+ const client = await runtime.getClient();
11744
+ const ids = [parsePositiveInt(attempt), parsePositiveInt(quizId)];
11745
+ const summary = await client.getQuizAttemptSummary(...ids);
11746
+ if (program.opts().dryRun) return runtime.output({ planned: "finish", summary }, () => formatAttemptSummary(summary), options);
11747
+ const palette = theme();
11748
+ const open = summary.rows.filter((row) => /not yet answered/iu.test(row.state));
11749
+ const warning = open.length ? `
11750
+ ${palette.tone("danger", `${open.length} question${open.length === 1 ? "" : "s"} not yet answered: ${open.map((row) => row.number).join(", ")}`)}` : "";
11751
+ if (!await quizConsent(`${formatAttemptSummary(summary)}${warning}
11752
+ ${palette.tone("warning", "Submit all and finish. Moodle does not allow undoing this.")}`)) return;
11753
+ const receipt = await client.finishQuizAttempt(...ids);
11754
+ await runtime.output({ finished: receipt }, () => formatAttemptFinish(receipt), options);
11755
+ });
10835
11756
  addOutputOptions(program.command("open").description("Open a unit or activity reference in the browser.").argument("<ref>", "Unit or activity id, URL, or UNIT TASK phrase")).action(async (ref2, options) => {
10836
11757
  const client = await runtime.getClient();
10837
11758
  let url;
@@ -10958,7 +11879,7 @@ _arguments '1:command:(${names.join(" ")})' '*:reference:'
10958
11879
  else throw new UsageError("Choose zsh, bash or fish.");
10959
11880
  });
10960
11881
  addOutputOptions(mutating(program.command("uninstall").description("Remove local background jobs; optionally remove the selected Worker and configuration.").summary("Remove background jobs, Worker and config"))).option("--remote", "Also remove the configured managed MCP deployment.").option("--purge", "Also delete local Moodle CLI configuration, receipts and cache.").action(async (options) => {
10961
- const home = io.homeDir ?? homedir15();
11882
+ const home = io.homeDir ?? homedir16();
10962
11883
  const jobs = await ownedJobs(home);
10963
11884
  const receipts = await readdir4(path4.join(home, ".config", "moodle-cli", "mcp", "deployments")).catch(() => []);
10964
11885
  const result = { jobs: jobs.map((j) => j.path), remote: Boolean(options.remote), purge: Boolean(options.purge), config: path4.join(home, CONFIG_DIR_NAME), cache: path4.join(home, CACHE_DIR_NAME), package_command: "npm rm -g moodle-cli (or bun remove -g moodle-cli); for the standalone install: rm ~/.local/bin/moodle", remaining: options.remote ? "Only the configured Worker is removed. Other profiles remain remote." : "Remote Workers and credentials remain unless removed with moodle mcp remove." };
@@ -10972,11 +11893,11 @@ _arguments '1:command:(${names.join(" ")})' '*:reference:'
10972
11893
  const profiles = new Set([...jobs.map((j) => j.profile), ...receipts.map((n2) => n2.replace(/\.json$/u, ""))].filter((p) => Boolean(p) && /^[a-z0-9_-]+$/u.test(p)));
10973
11894
  for (const profile of profiles) {
10974
11895
  await renewal2.remove(profile);
10975
- if (options.purge) await rm7(path4.join(home, "Library", "Logs", `com.moodle-cli.mcp-renewal.${profile}.log`), { force: true });
11896
+ if (options.purge) await rm8(path4.join(home, "Library", "Logs", `com.moodle-cli.mcp-renewal.${profile}.log`), { force: true });
10976
11897
  }
10977
11898
  if (options.purge) {
10978
- await rm7(result.config, { recursive: true, force: true });
10979
- await rm7(result.cache, { recursive: true, force: true });
11899
+ await rm8(result.config, { recursive: true, force: true });
11900
+ await rm8(result.cache, { recursive: true, force: true });
10980
11901
  }
10981
11902
  await runtime.output(result, () => `Moodle background jobs removed.
10982
11903
  ${result.remaining}
@@ -11170,7 +12091,7 @@ Log: ${result.log_path}`, options);
11170
12091
  return program;
11171
12092
  }
11172
12093
  var HELP_SECTIONS = {
11173
- "Core commands": ["due", "news", "find", "get", "open", "submit", "units", "activities", "grades", "threads", "forums"],
12094
+ "Core commands": ["due", "news", "find", "get", "open", "submit", "quiz", "units", "activities", "grades", "threads", "forums"],
11174
12095
  "Additional commands": ["user", "todo", "alerts", "overview", "download", "auth", "doctor", "completion", "uninstall"],
11175
12096
  "Agent commands": ["mcp", "commands", "skills"]
11176
12097
  };
@@ -11189,6 +12110,7 @@ async function runCli(argv = process.argv, io = {}) {
11189
12110
  }) === "human"
11190
12111
  });
11191
12112
  try {
12113
+ await startupUpdateNotice(args, stderr, { homeDir: io.homeDir, env: io.env });
11192
12114
  await parseWithPrompts(() => buildProgram({ ...io, rootArgs: args }), args, { ui, fillers: { unit: pickUnit(io, ui) } });
11193
12115
  return 0;
11194
12116
  } catch (error) {
@@ -11217,7 +12139,7 @@ ${hint}
11217
12139
  }
11218
12140
  function openInBrowser(url) {
11219
12141
  return new Promise((resolve, reject) => {
11220
- const child = spawn4(process.platform === "darwin" ? "open" : process.platform === "win32" ? "explorer.exe" : "xdg-open", [url], { stdio: "ignore" });
12142
+ const child = spawn5(process.platform === "darwin" ? "open" : process.platform === "win32" ? "explorer.exe" : "xdg-open", [url], { stdio: "ignore" });
11221
12143
  child.once("error", reject);
11222
12144
  child.once("exit", (code) => code === 0 ? resolve() : reject(new Error("Could not open the browser.")));
11223
12145
  });
@@ -11301,6 +12223,14 @@ function addOutputOptions(command) {
11301
12223
  function outputFormat(options, stdout) {
11302
12224
  return resolveFormat(options, Boolean(stdout && "isTTY" in stdout && stdout.isTTY));
11303
12225
  }
12226
+ var QUIZ_NOTICE = [
12227
+ "moodle quiz is beta: it replays the browser's quiz forms, and a Moodle update can break it without warning.",
12228
+ "Academic integrity: answers you send are your own submission under your institution's rules. Only use this",
12229
+ "where the quiz allows it, and check the attempt in a browser before you finish."
12230
+ ];
12231
+ function redactSesskey(html) {
12232
+ return html.replace(/<input\b[^>]*>/giu, (tag) => /\bname\s*=\s*["']?sesskey["']?/iu.test(tag) ? tag.replace(/(\bvalue\s*=\s*)(?:"[^"]*"|'[^']*'|[^\s>]+)/iu, '$1"REDACTED"') : tag).replace(/(["']?sesskey["']?\s*[:=]\s*["']?)[A-Za-z0-9]{8,}/gu, "$1REDACTED");
12233
+ }
11304
12234
  function submissionSummary(plan, final, theme) {
11305
12235
  const destination = `${theme.target(plan.name)}${plan.unit_id ? theme.dim(` unit ${plan.unit_id}`) : ""}`;
11306
12236
  const lines = plan.uploads.length ? [`${theme.dim("Upload")} ${theme.subject(plan.uploads.map((file2) => file2.name).join(", "))}`, `${theme.dim(" to")} ${destination}`] : [`${theme.dim("Submit")} ${destination}`, `${theme.dim(" ")} ${theme.subject("the files already there")} for grading`];
@@ -11321,7 +12251,9 @@ function parseMcpConnectionMode(value) {
11321
12251
  throw new UsageError("MCP connection mode must be 'bridge' or 'remote'.");
11322
12252
  }
11323
12253
  async function outputMcpResult(runtime, result, options) {
11324
- await runtime.output(result.data, () => result.text, options);
12254
+ await runtime.output(result.data, () => result.next?.length ? `${result.text}
12255
+
12256
+ ${tryLines(result.next)}` : result.text, options);
11325
12257
  }
11326
12258
  function errorOutputFormat(args, stdout) {
11327
12259
  try {
@@ -11391,7 +12323,7 @@ function queryMatches(text2, query) {
11391
12323
  function pathsReferToSameFile(moduleUrl, executable) {
11392
12324
  if (!executable) return false;
11393
12325
  try {
11394
- return realpathSync3(fileURLToPath2(moduleUrl)) === realpathSync3(executable);
12326
+ return realpathSync4(fileURLToPath2(moduleUrl)) === realpathSync4(executable);
11395
12327
  } catch {
11396
12328
  return false;
11397
12329
  }
@@ -11404,5 +12336,6 @@ if (isMain) {
11404
12336
  }
11405
12337
  export {
11406
12338
  buildProgram,
12339
+ redactSesskey,
11407
12340
  runCli
11408
12341
  };