moodle-cli 0.8.0 → 0.9.1

package/dist/worker/worker.js

@@ -3582,7 +3582,7 @@ var require_parse = __commonJS({
     var whitespace = /* @__PURE__ */ new Set([9, 10, 12, 13, 32]);
     var ZERO = "0".charCodeAt(0);
     var NINE = "9".charCodeAt(0);
-    function parse7(formula) {
+    function parse8(formula) {
       formula = formula.trim().toLowerCase();
       if (formula === "even") {
         return [2, 0];
@@ -3634,7 +3634,7 @@ var require_parse = __commonJS({
         }
       }
     }
-    exports.parse = parse7;
+    exports.parse = parse8;
   }
 });
 
@@ -5084,7 +5084,7 @@ var require_html = __commonJS({
         }).join("");
       }
       set innerHTML(content) {
-        const r = parse7(content, this._parseOptions);
+        const r = parse8(content, this._parseOptions);
         const nodes = r.childNodes.length ? r.childNodes : [new text_1.default(content, this)];
         resetParent(nodes, this);
         resetParent(this.childNodes, null);
@@ -5095,7 +5095,7 @@ var require_html = __commonJS({
           content = [content];
         } else if (typeof content == "string") {
           options = Object.assign(Object.assign({}, this._parseOptions), options);
-          const r = parse7(content, options);
+          const r = parse8(content, options);
           content = r.childNodes.length ? r.childNodes : [new text_1.default(r.innerHTML, this)];
         }
         resetParent(this.childNodes, null);
@@ -5109,7 +5109,7 @@ var require_html = __commonJS({
           if (node2 instanceof node_1.default) {
             return [node2];
           } else if (typeof node2 == "string") {
-            const r = parse7(node2, this._parseOptions);
+            const r = parse8(node2, this._parseOptions);
             return r.childNodes.length ? r.childNodes : [new text_1.default(node2, this)];
           }
           return [];
@@ -5493,7 +5493,7 @@ var require_html = __commonJS({
         if (arguments.length < 2) {
           throw new Error("2 arguments required");
         }
-        const p = parse7(html, this._parseOptions);
+        const p = parse8(html, this._parseOptions);
         if (where === "afterend") {
           this.after(...p.childNodes);
         } else if (where === "afterbegin") {
@@ -5639,7 +5639,7 @@ var require_html = __commonJS({
       }
       /** Clone this Node */
       clone() {
-        return parse7(this.toString(), this._parseOptions).firstChild;
+        return parse8(this.toString(), this._parseOptions).firstChild;
       }
     };
     exports.default = HTMLElement2;
@@ -5841,7 +5841,7 @@ var require_html = __commonJS({
       return stack;
     }
     exports.base_parse = base_parse;
-    function parse7(data, options = {}) {
+    function parse8(data, options = {}) {
       const stack = base_parse(data, options);
       const [root] = stack;
       while (stack.length > 1) {
@@ -5869,7 +5869,7 @@ var require_html = __commonJS({
       }
       return root;
     }
-    exports.parse = parse7;
+    exports.parse = parse8;
     function resolveInsertable(insertable) {
       return insertable.map((val) => {
         if (typeof val === "string") {
@@ -5937,18 +5937,18 @@ var require_dist = __commonJS({
     var parse_1 = __importDefault(require_parse2());
     var valid_1 = __importDefault(require_valid());
     exports.valid = valid_1.default;
-    function parse7(data, options = {}) {
+    function parse8(data, options = {}) {
       return (0, parse_1.default)(data, options);
     }
-    exports.default = parse7;
-    exports.parse = parse7;
-    parse7.parse = parse_1.default;
-    parse7.HTMLElement = html_1.default;
-    parse7.CommentNode = comment_1.default;
-    parse7.valid = valid_1.default;
-    parse7.Node = node_1.default;
-    parse7.TextNode = text_1.default;
-    parse7.NodeType = type_1.default;
+    exports.default = parse8;
+    exports.parse = parse8;
+    parse8.parse = parse_1.default;
+    parse8.HTMLElement = html_1.default;
+    parse8.CommentNode = comment_1.default;
+    parse8.valid = valid_1.default;
+    parse8.Node = node_1.default;
+    parse8.TextNode = text_1.default;
+    parse8.NodeType = type_1.default;
   }
 });
 
@@ -6292,20 +6292,20 @@ function createOAuthRouter(options) {
   async function handleAuthorizationCodeGrant(form) {
     const code = form.get("code") ?? "";
     const key = `${CODE_PREFIX}${await digestBearerToken(code)}`;
-    const record2 = code ? await storage.get(key) : void 0;
-    if (record2) await storage.delete(key);
-    if (!record2 || record2.expiresAt <= now()) {
+    const record3 = code ? await storage.get(key) : void 0;
+    if (record3) await storage.delete(key);
+    if (!record3 || record3.expiresAt <= now()) {
       return oauthError(400, "invalid_grant", "The authorization code is invalid or expired.");
     }
-    if (form.get("client_id") !== record2.clientId) {
+    if (form.get("client_id") !== record3.clientId) {
       return oauthError(400, "invalid_grant", "The authorization code was issued to another client.");
     }
     const redirectUri = form.get("redirect_uri");
-    if (redirectUri !== null && redirectUri !== record2.redirectUri) {
+    if (redirectUri !== null && redirectUri !== record3.redirectUri) {
       return oauthError(400, "invalid_grant", "The redirect URI does not match the authorization request.");
     }
     const verifier = form.get("code_verifier") ?? "";
-    if (!/^[A-Za-z0-9._~-]{43,128}$/u.test(verifier) || await pkceChallenge(verifier) !== record2.codeChallenge) {
+    if (!/^[A-Za-z0-9._~-]{43,128}$/u.test(verifier) || await pkceChallenge(verifier) !== record3.codeChallenge) {
       return oauthError(400, "invalid_grant", "The PKCE code verifier is invalid.");
     }
     const requestedResource = normalizeResource(form.get("resource"));
@@ -6313,9 +6313,9 @@ function createOAuthRouter(options) {
       return oauthError(400, "invalid_target", "The requested resource is not hosted by this server.");
     }
     return issueTokens({
-      clientId: record2.clientId,
+      clientId: record3.clientId,
       resource: resourceUrl,
-      scope: record2.scope,
+      scope: record3.scope,
       family: createSecret()
     });
   }
@@ -6325,33 +6325,33 @@ function createOAuthRouter(options) {
     const requestedResource = normalizeResource(form.get("resource"));
     if (requestedResource === void 0) return oauthError(400, "invalid_target", "The requested resource is not hosted by this server.");
     const digest = await digestBearerToken(refreshToken);
-    const record2 = await storage.get(`${REFRESH_PREFIX}${digest}`);
-    if (!record2) {
+    const record3 = await storage.get(`${REFRESH_PREFIX}${digest}`);
+    if (!record3) {
       const consumed = await storage.get(`${CONSUMED_REFRESH_PREFIX}${digest}`);
       if (consumed) await revokeFamily(consumed.family);
       return oauthError(400, "invalid_grant", "The refresh token is invalid or expired.");
     }
     await storage.delete(`${REFRESH_PREFIX}${digest}`);
-    if (record2.resource !== resourceUrl) return oauthError(400, "invalid_grant", "The grant must be authorized again for this resource.");
-    if (record2.expiresAt <= now()) return oauthError(400, "invalid_grant", "The refresh token is invalid or expired.");
+    if (record3.resource !== resourceUrl) return oauthError(400, "invalid_grant", "The grant must be authorized again for this resource.");
+    if (record3.expiresAt <= now()) return oauthError(400, "invalid_grant", "The refresh token is invalid or expired.");
     const clientId = form.get("client_id");
-    if (clientId !== null && clientId !== record2.clientId) {
+    if (clientId !== null && clientId !== record3.clientId) {
       return oauthError(400, "invalid_grant", "The refresh token was issued to another client.");
     }
     const requestedScope = form.get("scope");
-    if (requestedScope && requestedScope.split(/\s+/u).some((scope) => scope && scope !== record2.scope)) {
+    if (requestedScope && requestedScope.split(/\s+/u).some((scope) => scope && scope !== record3.scope)) {
       return oauthError(400, "invalid_scope", "The requested scope exceeds the original grant.");
     }
     await storage.put(`${CONSUMED_REFRESH_PREFIX}${digest}`, {
-      ...record2,
+      ...record3,
       expiresAt: now() + CONSUMED_REFRESH_RETENTION_MS
     });
     await prune();
     return issueTokens({
-      clientId: record2.clientId,
-      resource: record2.resource,
-      scope: record2.scope,
-      family: record2.family
+      clientId: record3.clientId,
+      resource: record3.resource,
+      scope: record3.scope,
+      family: record3.family
     });
   }
   async function handleRevoke(request) {
@@ -6363,8 +6363,8 @@ function createOAuthRouter(options) {
     if (token) {
       const digest = await digestBearerToken(token);
       for (const prefix of [ACCESS_PREFIX, REFRESH_PREFIX]) {
-        const record2 = await storage.get(`${prefix}${digest}`);
-        if (record2) await revokeFamily(record2.family);
+        const record3 = await storage.get(`${prefix}${digest}`);
+        if (record3) await revokeFamily(record3.family);
       }
     }
     return new Response(null, { status: 200, headers: { "cache-control": "no-store" } });
@@ -6424,8 +6424,8 @@ function createOAuthRouter(options) {
     async revokeClients(clientId) {
       await storage.delete(PAIRING_KEY);
       for (const prefix of [CLIENT_PREFIX, CODE_PREFIX, ACCESS_PREFIX, REFRESH_PREFIX, CONSUMED_REFRESH_PREFIX]) {
-        for (const [key, record2] of await storage.list({ prefix })) {
-          if (!clientId || record2.clientId === clientId) await storage.delete(key);
+        for (const [key, record3] of await storage.list({ prefix })) {
+          if (!clientId || record3.clientId === clientId) await storage.delete(key);
         }
       }
     },
@@ -6442,14 +6442,14 @@ function createOAuthRouter(options) {
     async verifyAccessToken(token, resource) {
       if (!token) return null;
       const key = `${ACCESS_PREFIX}${await digestBearerToken(token)}`;
-      const record2 = await storage.get(key);
-      if (!record2) return null;
-      if (record2.expiresAt <= now()) {
+      const record3 = await storage.get(key);
+      if (!record3) return null;
+      if (record3.expiresAt <= now()) {
         await storage.delete(key);
         return null;
       }
-      if (record2.resource !== resourceUrl || resource !== resourceUrl) return null;
-      return { clientId: record2.clientId, scope: record2.scope };
+      if (record3.resource !== resourceUrl || resource !== resourceUrl) return null;
+      return { clientId: record3.clientId, scope: record3.scope };
     }
   };
 }
@@ -8529,18 +8529,18 @@ var validateAsync = async (schema2, value, _ctx) => {
   return result.issues.length === 0;
 };
 var _encode = (_Err) => {
-  const parse7 = _parse(_Err);
+  const parse8 = _parse(_Err);
   const fn = (schema2, value, _ctx, _params) => {
     const ctx = _ctx ? { ..._ctx, direction: "backward" } : { direction: "backward" };
-    return parse7(schema2, value, ctx, finalizeParams(fn, _params));
+    return parse8(schema2, value, ctx, finalizeParams(fn, _params));
   };
   return fn;
 };
 var encode = /* @__PURE__ */ _encode($ZodRealError);
 var _decode = (_Err) => {
-  const parse7 = _parse(_Err);
+  const parse8 = _parse(_Err);
   const fn = (schema2, value, _ctx, _params) => {
-    return parse7(schema2, value, _ctx, finalizeParams(fn, _params));
+    return parse8(schema2, value, _ctx, finalizeParams(fn, _params));
   };
   return fn;
 };
@@ -8934,8 +8934,8 @@ var $ZodCheckMaxSize = /* @__PURE__ */ $constructor("$ZodCheckMaxSize", (inst, d
   (_a3 = inst._zod.def).when ?? (_a3.when = _whenHasSize);
   inst._zod.check = (payload) => {
     const input3 = payload.value;
-    const size = input3.size;
-    if (size <= def.maximum)
+    const size2 = input3.size;
+    if (size2 <= def.maximum)
       return;
     payload.issues.push({
       origin: getSizableOrigin(input3),
@@ -8954,8 +8954,8 @@ var $ZodCheckMinSize = /* @__PURE__ */ $constructor("$ZodCheckMinSize", (inst, d
   (_a3 = inst._zod.def).when ?? (_a3.when = _whenHasSize);
   inst._zod.check = (payload) => {
     const input3 = payload.value;
-    const size = input3.size;
-    if (size >= def.minimum)
+    const size2 = input3.size;
+    if (size2 >= def.minimum)
       return;
     payload.issues.push({
       origin: getSizableOrigin(input3),
@@ -8974,10 +8974,10 @@ var $ZodCheckSizeEquals = /* @__PURE__ */ $constructor("$ZodCheckSizeEquals", (i
   (_a3 = inst._zod.def).when ?? (_a3.when = _whenHasSize);
   inst._zod.check = (payload) => {
     const input3 = payload.value;
-    const size = input3.size;
-    if (size === def.size)
+    const size2 = input3.size;
+    if (size2 === def.size)
       return;
-    const tooBig = size > def.size;
+    const tooBig = size2 > def.size;
     payload.issues.push({
       origin: getSizableOrigin(input3),
       ...tooBig ? { code: "too_big", maximum: def.size } : { code: "too_small", minimum: def.size },
@@ -21713,11 +21713,11 @@ function _minSize(minimum, params) {
   });
 }
 // @__NO_SIDE_EFFECTS__
-function _size(size, params) {
+function _size(size2, params) {
   return new $ZodCheckSizeEquals({
     check: "size_equals",
     ...normalizeParams(params),
-    size
+    size: size2
   });
 }
 // @__NO_SIDE_EFFECTS__
@@ -23274,8 +23274,8 @@ function rewriteKeyNames(ctx) {
       bySchema.set(entry.schema, entry);
   }
   const rewrites = /* @__PURE__ */ new Map();
-  for (const record2 of pendingRecords.get(ctx) ?? []) {
-    const seen = ctx.seen.get(record2);
+  for (const record3 of pendingRecords.get(ctx) ?? []) {
+    const seen = ctx.seen.get(record3);
     const names = (seen?.def ?? seen?.schema)?.propertyNames;
     if (!names || names === true || rewrites.has(names))
       continue;
@@ -24992,8 +24992,8 @@ var ZodFile = /* @__PURE__ */ $constructor("ZodFile", (inst, def) => {
   $ZodFile.init(inst, def);
   ZodType.init(inst, def);
   inst._zod.processJSONSchema = (ctx, json2, params) => fileProcessor(inst, ctx, json2, params);
-  inst.min = (size, params) => inst.check(_minSize(size, params));
-  inst.max = (size, params) => inst.check(_maxSize(size, params));
+  inst.min = (size2, params) => inst.check(_minSize(size2, params));
+  inst.max = (size2, params) => inst.check(_maxSize(size2, params));
   inst.mime = (types, params) => inst.check(_mime(Array.isArray(types) ? types : [types], params));
 });
 function file(params) {
@@ -26452,7 +26452,7 @@ function stringValue(value) {
 }
 
 // src/version.ts
-var VERSION = "0.8.0";
+var VERSION = "0.9.1";
 
 // src/worker/http.ts
 var HEALTH_PATH = "/healthz";
@@ -27004,7 +27004,12 @@ async function fetchWithSession(input3, init, moodleOrigin, cookie, fetchImpl =
       headers.delete("authorization");
       headers.delete("proxy-authorization");
     }
-    const response = await fetchImpl(url2.toString(), { ...init, method, body, headers: Object.fromEntries(headers), signal, redirect: "manual" });
+    let response;
+    try {
+      response = await fetchImpl(url2.toString(), { ...init, method, body, headers: Object.fromEntries(headers), signal, redirect: "manual" });
+    } catch (error62) {
+      throw requestFailure(error62, url2, deadline);
+    }
     if (!REDIRECT_STATUSES.has(response.status)) return response;
     const location = response.headers.get("location");
     if (!location) return response;
@@ -27025,6 +27030,25 @@ async function fetchWithSession(input3, init, moodleOrigin, cookie, fetchImpl =
     url2 = next;
   }
 }
+var RequestFailed = class extends Error {
+  host;
+  timedOut;
+  constructor(host, timedOut, cause) {
+    super(timedOut ? `${host} did not respond within ${REQUEST_TIMEOUT_MS / 1e3}s.` : `Could not reach ${host}: ${cause}`);
+    this.name = "RequestFailed";
+    this.host = host;
+    this.timedOut = timedOut;
+  }
+};
+function requestFailure(error62, url2, deadline) {
+  if (deadline.aborted) {
+    return new RequestFailed(url2.host, true);
+  }
+  if (!(error62 instanceof Error)) {
+    return error62;
+  }
+  return new RequestFailed(url2.host, false, error62.cause instanceof Error ? error62.cause.message : error62.message);
+}
 
 // src/constants.ts
 var PACKAGE_NAME = "moodle-cli";
@@ -27057,6 +27081,9 @@ var FUNC_GET_UNREAD_CONVERSATION_COUNTS = "core_message_get_unread_conversation_
 var FUNC_GET_DISCUSSION_POSTS = "mod_forum_get_discussion_posts";
 var DEFAULT_SESSION_CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
 
+// src/moodle-assign-core.ts
+var import_node_html_parser3 = __toESM(require_dist(), 1);
+
 // src/html-utils.ts
 var import_node_html_parser = __toESM(require_dist(), 1);
 function htmlToStructuredContent(html, baseUrl) {
@@ -27126,262 +27153,6 @@ function decodeHtml(value) {
   return value.replace(/&nbsp;/g, " ").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#39;/g, "'");
 }
 
-// src/parsers.ts
-function schema(parser) {
-  return { parse: parser };
-}
-var UserInfoSchema = schema(parseUserInfo);
-var CourseSchema = schema(parseCourse);
-var CoursesSchema = schema(parseCourses);
-var ActivitySchema = schema(parseActivity);
-var SectionSchema = schema(parseSection);
-var CourseContentsSchema = schema(parseCourseContents);
-var TodoItemSchema = schema(parseTodoItem);
-function parseUserInfo(value) {
-  const data = asRecord(value);
-  return {
-    userid: numberValue(data.userid),
-    username: stringValue2(data.username),
-    fullname: stringValue2(data.fullname),
-    sitename: stringValue2(data.sitename),
-    siteurl: stringValue2(data.siteurl),
-    lang: stringValue2(data.lang),
-    ...data.timezone ? { timezone: String(data.timezone) } : {}
-  };
-}
-function parseCourse(value, nowSeconds = Math.floor(Date.now() / 1e3)) {
-  const data = asRecord(value);
-  const course = {
-    id: numberValue(data.id),
-    shortname: stringValue2(data.shortname),
-    fullname: stringValue2(data.fullname),
-    category: numberValue(data.category),
-    visible: booleanValue(data.visible, true),
-    startdate: numberValue(data.startdate)
-  };
-  const enddate = numberValue(data.enddate);
-  if (enddate > 0) {
-    course.enddate = enddate;
-  }
-  return course;
-}
-function parseCourses(value) {
-  return asArray(value).map((item) => parseCourse(item));
-}
-function parseActivity(value) {
-  const data = asRecord(value);
-  return {
-    id: numberValue(data.id),
-    name: stringValue2(data.name),
-    modname: stringValue2(data.modname),
-    url: stringValue2(data.url),
-    visible: booleanValue(data.visible, true),
-    description: stringValue2(data.description),
-    ...data.completiondata && typeof data.completiondata === "object" ? { completion: numberValue(asRecord(data.completiondata).state) } : {},
-    ...Array.isArray(data.contents) ? { file_entries: data.contents.filter((f) => asRecord(f).fileurl).map((f) => ({ name: stringValue2(asRecord(f).filename), url: stringValue2(asRecord(f).fileurl), requires_authentication: true })) } : {}
-  };
-}
-function parseSection(value) {
-  const data = asRecord(value);
-  return {
-    id: numberValue(data.id),
-    name: stringValue2(data.name),
-    section: numberValue(data.section),
-    visible: booleanValue(data.visible, true),
-    summary: stringValue2(data.summary),
-    ...data.current !== void 0 ? { current: booleanValue(data.current) } : {},
-    activities: asArray(data.modules).map((item) => parseActivity(item))
-  };
-}
-function parseCourseContents(value) {
-  return asArray(value).map((item) => parseSection(item));
-}
-function parseCourseFormatState(value, baseUrl) {
-  const state = asRecord(parseJsonValue(value));
-  const activities = /* @__PURE__ */ new Map();
-  const activitiesBySection = /* @__PURE__ */ new Map();
-  for (const item of asArray(state.cm)) {
-    const data = asRecord(item);
-    const id2 = numberValue(data.id);
-    const sectionId = stringValue2(data.sectionid);
-    const module = stringValue2(data.module) || stringValue2(data.plugin).replace(/^mod_/u, "") || stringValue2(data.modname).toLowerCase();
-    const activity = {
-      id: id2,
-      name: htmlText(data.name, baseUrl),
-      modname: module.toLowerCase(),
-      url: stringValue2(data.url) ? resolveUrl(baseUrl, stringValue2(data.url)) : "",
-      visible: booleanValue(data.visible, true) && booleanValue(data.uservisible, true) && !booleanValue(data.stealth),
-      description: htmlText(data.content ?? data.description, baseUrl),
-      ...data.completionstate !== void 0 && data.completionstate !== null ? { completion: numberValue(data.completionstate) } : {}
-    };
-    activities.set(String(id2), activity);
-    const sectionActivities = activitiesBySection.get(sectionId) ?? [];
-    sectionActivities.push(activity);
-    activitiesBySection.set(sectionId, sectionActivities);
-  }
-  return asArray(state.section).map((item) => {
-    const data = asRecord(item);
-    const id2 = numberValue(data.id);
-    const hasActivityList = Array.isArray(data.cmlist);
-    const listedActivities = asArray(data.cmlist).map((activityId) => activities.get(stringValue2(activityId))).filter((activity) => activity !== void 0);
-    return {
-      id: id2,
-      name: htmlText(data.title || data.rawtitle, baseUrl),
-      section: numberValue(data.section ?? data.number),
-      visible: booleanValue(data.visible, true),
-      summary: htmlText(data.summary, baseUrl),
-      ...data.current !== void 0 ? { current: booleanValue(data.current) } : {},
-      activities: hasActivityList ? listedActivities : activitiesBySection.get(String(id2)) ?? []
-    };
-  });
-}
-function parseTodoItem(value) {
-  const data = asRecord(value);
-  const course = asRecord(data.course);
-  const action = asRecord(data.action);
-  const progress = course.progress;
-  return {
-    id: numberValue(data.id),
-    name: stringValue2(data.name),
-    activity_name: stringValue2(data.activityname),
-    modname: stringValue2(data.modulename),
-    course_id: numberValue(course.id),
-    course_name: stringValue2(course.fullname),
-    due_at: numberValue(data.timesort) || numberValue(data.timestart),
-    overdue: booleanValue(data.overdue),
-    actionable: booleanValue(action.actionable),
-    action_name: stringValue2(action.name),
-    action_url: stringValue2(action.url),
-    url: stringValue2(data.url),
-    event_type: stringValue2(data.eventtype),
-    course_progress: typeof progress === "number" ? progress : void 0
-  };
-}
-function parseTodoItems(value) {
-  return asArray(value).map((item) => parseTodoItem(item));
-}
-function parseAlertNotification(value) {
-  const data = asRecord(value);
-  return {
-    id: numberValue(data.id),
-    subject: stringValue2(data.subject),
-    short_subject: stringValue2(data.shortenedsubject),
-    event_type: stringValue2(data.eventtype),
-    component: stringValue2(data.component),
-    created_at: numberValue(data.timecreated),
-    created_pretty: stringValue2(data.timecreatedpretty),
-    read: booleanValue(data.read),
-    context_url: stringValue2(data.contexturl),
-    context_name: stringValue2(data.contexturlname)
-  };
-}
-function parseAlertSummary(notificationsData, countsData, unreadCountsData) {
-  const notificationsRecord = asRecord(notificationsData);
-  const counts2 = asRecord(countsData);
-  const unreadCounts = asRecord(unreadCountsData);
-  const types = asRecord(counts2.types);
-  const unreadTypes = asRecord(unreadCounts.types);
-  const notifications = asArray(notificationsRecord.notifications).map((item) => parseAlertNotification(item));
-  return {
-    notifications,
-    notification_count: notifications.length,
-    unread_notification_count: notifications.filter((notification) => !notification.read).length,
-    starred_message_count: numberValue(counts2.favourites),
-    direct_message_count: numberValue(types["1"]),
-    group_message_count: numberValue(types["2"]),
-    self_message_count: numberValue(types["3"]),
-    unread_starred_message_count: numberValue(unreadCounts.favourites),
-    unread_direct_message_count: numberValue(unreadTypes["1"]),
-    unread_group_message_count: numberValue(unreadTypes["2"]),
-    unread_self_message_count: numberValue(unreadTypes["3"])
-  };
-}
-function parseForumPostAuthor(value) {
-  const data = asRecord(value);
-  const urls = asRecord(data.urls);
-  return {
-    id: numberValue(data.id),
-    fullname: stringValue2(data.fullname),
-    profile_url: stringValue2(urls.profile),
-    profile_image_url: stringValue2(urls.profileimage)
-  };
-}
-function parseForumPost(value, baseUrl = "") {
-  const data = asRecord(value);
-  const urls = asRecord(data.urls);
-  const messageHtml = stringValue2(data.message);
-  const structured = htmlToStructuredContent(messageHtml, stringValue2(urls.view || urls.discuss) || baseUrl);
-  return {
-    id: numberValue(data.id),
-    discussion_id: numberValue(data.discussionid),
-    subject: stringValue2(data.subject),
-    message_html: messageHtml,
-    message_text: structured.text,
-    image_urls: structured.image_urls,
-    links: structured.links,
-    tables: structured.tables,
-    author: parseForumPostAuthor(data.author),
-    parent_id: numberValue(data.parentid),
-    time_created: numberValue(data.timecreated),
-    time_modified: numberValue(data.timemodified),
-    created_pretty: "",
-    unread: booleanValue(data.unread),
-    is_deleted: booleanValue(data.isdeleted),
-    is_private_reply: booleanValue(data.isprivatereply),
-    url: stringValue2(urls.view || urls.viewisolated),
-    reply_url: stringValue2(urls.reply)
-  };
-}
-function parseForumDiscussion(value, discussionId, baseUrl = "") {
-  const data = asRecord(value);
-  const posts = asArray(data.posts).map((item) => parseForumPost(item, baseUrl));
-  return {
-    id: discussionId,
-    subject: posts[0]?.subject ?? "",
-    course_id: numberValue(data.courseid),
-    forum_id: numberValue(data.forumid),
-    group_id: numberValue(data.groupid),
-    group_name: stringValue2(data.groupname),
-    url: posts[0]?.url ? posts[0].url.split("#", 1)[0] : "",
-    posts
-  };
-}
-function asRecord(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
-}
-function asArray(value) {
-  return Array.isArray(value) ? value : [];
-}
-function stringValue2(value) {
-  return typeof value === "string" ? value : value == null ? "" : String(value);
-}
-function numberValue(value) {
-  if (typeof value === "number" && Number.isFinite(value)) {
-    return value;
-  }
-  if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) {
-    return Number(value);
-  }
-  return 0;
-}
-function booleanValue(value, defaultValue = false) {
-  if (value === void 0 || value === null) {
-    return defaultValue;
-  }
-  return Boolean(value);
-}
-function parseJsonValue(value) {
-  if (typeof value !== "string") return value;
-  try {
-    return JSON.parse(value);
-  } catch {
-    return {};
-  }
-}
-function htmlText(value, baseUrl) {
-  return htmlToStructuredContent(stringValue2(value), baseUrl).text;
-}
-
 // src/scraper.ts
 var import_node_html_parser2 = __toESM(require_dist(), 1);
 function parseMoodleErrorHtml(html) {
@@ -27413,8 +27184,8 @@ function parseMoodleErrorHtml(html) {
 function parsePageContext(html, baseUrl) {
   const root = (0, import_node_html_parser2.parse)(html);
   const config2 = parseMoodleConfig(html);
-  const sesskey = stringValue3(config2.sesskey).trim();
-  const userid = numberValue2(config2.userId) || numberValue2(root.querySelector("[data-user-id]")?.getAttribute("data-user-id"));
+  const sesskey = stringValue2(config2.sesskey).trim();
+  const userid = numberValue(config2.userId) || numberValue(root.querySelector("[data-user-id]")?.getAttribute("data-user-id"));
   if (!sesskey || !userid) {
     throw new Error("Session appears invalid: could not load authenticated Moodle context");
   }
@@ -27426,8 +27197,8 @@ function parsePageContext(html, baseUrl) {
       fullname: cleanNodeText(root.querySelector(".userfullname")),
       sitename: extractSitename(root),
       siteurl: baseUrl,
-      ...config2.timezone ? { timezone: stringValue3(config2.timezone) } : {},
-      lang: stringValue3(config2.language) || root.querySelector("html")?.getAttribute("lang") || ""
+      ...config2.timezone ? { timezone: stringValue2(config2.timezone) } : {},
+      lang: stringValue2(config2.language) || root.querySelector("html")?.getAttribute("lang") || ""
     }
   };
 }
@@ -27967,7 +27738,7 @@ function numberQueryValue(href, key) {
     return null;
   }
 }
-function numberValue2(value) {
+function numberValue(value) {
   if (typeof value === "number" && Number.isFinite(value)) {
     return value;
   }
@@ -27976,7 +27747,7 @@ function numberValue2(value) {
   }
   return 0;
 }
-function stringValue3(value) {
+function stringValue2(value) {
   return typeof value === "string" ? value : value == null ? "" : String(value);
 }
 function fileEntry(name, url2, baseUrl) {
@@ -27990,6 +27761,619 @@ function unique(items) {
   return [...new Set(items)];
 }
 
+// src/moodle-assign-core.ts
+async function submitAssignmentFiles(deps, request) {
+  const id2 = request.activityId;
+  if (!Number.isSafeInteger(id2) || id2 <= 0) throw deps.usage("The assignment id must be a positive integer.");
+  if (!request.files.length && !request.final) throw deps.usage("Give at least one file to upload, or use --final to submit the existing draft.");
+  const seen = /* @__PURE__ */ new Set();
+  for (const file3 of request.files) {
+    if (!file3.name || /[\\/]/u.test(file3.name)) throw deps.usage(`'${file3.name}' is not a plain file name.`);
+    if (seen.has(file3.name.toLowerCase())) throw deps.usage(`'${file3.name}' is given twice; Moodle keeps one file per name.`);
+    seen.add(file3.name.toLowerCase());
+  }
+  const viewUrl = `${deps.baseUrl}${ASSIGN_VIEW_PATH}?id=${id2}`;
+  request.onProgress?.("Reading the assignment");
+  const before = parseReceiptPage(await pageText(deps, viewUrl), id2, deps.baseUrl);
+  const form = parseSubmissionForm(await pageText(deps, `${viewUrl}&action=editsubmission`), deps);
+  const draft = await listDraftFiles(deps, form);
+  const removed = request.replace ? draft.map((file3) => file3.name) : [];
+  const kept = request.replace ? [] : draft.filter((file3) => !seen.has(file3.name.toLowerCase()));
+  checkLimits(deps, form, kept, request.files);
+  let statement = form.statement;
+  let confirm;
+  if (request.final && !statement) {
+    confirm = parseConfirmForm(await pageText(deps, `${viewUrl}&action=submit`), deps);
+    statement = confirm.statement;
+  }
+  if (statement && !request.acceptStatement) {
+    throw deps.usage(`Moodle requires you to accept this statement: "${statement}"`, "Re-run with --accept-statement once you agree.");
+  }
+  const limits = describeLimits(form);
+  const uploads = request.files.map((file3) => ({ name: file3.name, bytes: file3.bytes.byteLength, ...file3.path ? { path: file3.path } : {} }));
+  if (request.dryRun) {
+    return {
+      ...before,
+      action: "planned",
+      files: draft.map((file3) => ({ name: file3.name, bytes: file3.bytes })),
+      uploads,
+      removed,
+      limits,
+      ...statement ? { statement, statement_accepted: true } : {},
+      checked_at: timestamp(deps)
+    };
+  }
+  if (removed.length) {
+    request.onProgress?.(`Removing ${removed.join(", ")}`);
+    await deleteDraftFiles(deps, form, draft);
+  }
+  const storedNames = [];
+  for (const [index, file3] of request.files.entries()) {
+    request.onProgress?.(`Uploading ${file3.name} (${index + 1}/${request.files.length})`);
+    storedNames.push(await uploadDraftFile(deps, form, file3));
+  }
+  if (storedNames.length || removed.length) {
+    request.onProgress?.("Saving the submission");
+    const savedHtml = await postForm(deps, form.action, [...form.fields, ...form.statement ? [["submissionstatement", "1"]] : [], ["submitbutton", "Save changes"]]);
+    if (savedHtml !== null) throw deps.fail(`Moodle did not save the submission: ${noticesOf(savedHtml) || "it returned the edit form again without a reason"}`);
+  }
+  request.onProgress?.("Reading the receipt");
+  let receipt = parseReceiptPage(await pageText(deps, viewUrl), id2, deps.baseUrl);
+  const listed = new Set(receipt.files.map((file3) => file3.name.toLowerCase()));
+  const missing = storedNames.filter((name) => !listed.has(name.toLowerCase()));
+  if (missing.length) throw deps.fail(`Moodle saved the submission but its page does not list ${missing.join(", ")}; check the assignment in a browser before submitting.`);
+  let action = "saved";
+  if (isSubmitted(receipt.submission_status)) action = "submitted";
+  else if (request.final) {
+    request.onProgress?.("Submitting for grading");
+    confirm ??= parseConfirmForm(await pageText(deps, `${viewUrl}&action=submit`), deps);
+    const errorHtml = await postForm(deps, confirm.action, [...confirm.fields, ...confirm.statement ? [["submissionstatement", "1"]] : [], ["submitbutton", "Continue"]]);
+    if (errorHtml !== null) throw deps.fail(`Moodle did not submit the assignment for grading: ${noticesOf(errorHtml) || "it returned the confirmation page again without a reason"}`);
+    receipt = parseReceiptPage(await pageText(deps, viewUrl), id2, deps.baseUrl);
+    if (!isSubmitted(receipt.submission_status)) throw deps.fail(`Moodle accepted the confirmation but still reports "${receipt.submission_status || "no status"}"; check the assignment in a browser.`);
+    action = "submitted";
+  }
+  return {
+    ...receipt,
+    action,
+    uploads,
+    removed,
+    limits,
+    ...statement ? { statement, statement_accepted: true } : {},
+    checked_at: timestamp(deps)
+  };
+}
+function parseSubmissionForm(html, deps) {
+  const root = (0, import_node_html_parser3.parse)(html);
+  const form = formWithAction(root, "savesubmission");
+  if (!form) {
+    const notice = noticesOf(html);
+    if (root.querySelectorAll("input[type=submit], button").some((button) => /begin assignment/iu.test(cleanText(button.getAttribute("value") ?? button.textContent)))) {
+      throw deps.fail("This is a timed assignment; start it in a browser before uploading files.");
+    }
+    throw deps.fail(notice ? `Moodle is not accepting a submission: ${notice}` : "Moodle did not show a submission form for this assignment.");
+  }
+  const itemid = form.querySelector("input[name=files_filemanager]")?.getAttribute("value")?.trim() ?? "";
+  if (!itemid) throw deps.fail("This assignment does not accept file uploads.");
+  const options = filemanagerOptions(html, itemid);
+  if (!options) throw deps.fail("Moodle did not describe the file upload area for this assignment.");
+  const fields2 = formFields(form);
+  const sesskey = fields2.find(([name]) => name === "sesskey")?.[1] ?? "";
+  if (!sesskey) throw deps.fail("The submission form has no session key.");
+  const picker = record2(options.filepicker);
+  const repositories = (Array.isArray(picker.repositories) ? picker.repositories : Object.values(record2(picker.repositories))).map(record2);
+  const upload = repositories.find((repo) => repo.type === "upload");
+  if (!upload || upload.id === void 0) throw deps.fail("The site does not allow direct file uploads for this assignment.");
+  const accepted = options.accepted_types;
+  const acceptedTypes = Array.isArray(accepted) ? accepted.map(String).filter(Boolean) : accepted === void 0 || accepted === "*" ? "*" : [String(accepted)];
+  return {
+    action: resolveUrl(deps.baseUrl, form.getAttribute("action") || `${deps.baseUrl}${ASSIGN_VIEW_PATH}`),
+    fields: fields2,
+    sesskey,
+    itemid,
+    clientId: String(options.client_id ?? ""),
+    contextId: String(record2(options.context).id ?? ""),
+    repoId: String(upload.id),
+    author: String(picker.author ?? ""),
+    license: String(picker.defaultlicense ?? ""),
+    maxBytes: integer2(options.maxbytes),
+    areaMaxBytes: integer2(options.areamaxbytes),
+    maxFiles: integer2(options.maxfiles),
+    acceptedTypes: acceptedTypes.length === 1 && acceptedTypes[0] === "*" ? "*" : acceptedTypes,
+    ...statementOf(form)
+  };
+}
+function parseConfirmForm(html, deps) {
+  const root = (0, import_node_html_parser3.parse)(html);
+  const form = formWithAction(root, "confirmsubmit");
+  if (!form) {
+    const notice = noticesOf(html);
+    throw deps.fail(notice ? `Moodle is not accepting a submission for grading: ${notice}` : "Moodle did not show the submit-for-grading confirmation.");
+  }
+  return { action: resolveUrl(deps.baseUrl, form.getAttribute("action") || `${deps.baseUrl}${ASSIGN_VIEW_PATH}`), fields: formFields(form), ...statementOf(form) };
+}
+function parseReceiptPage(html, activityId, baseUrl) {
+  const page2 = parseAssignmentHtml(html, activityId, baseUrl);
+  const root = (0, import_node_html_parser3.parse)(html);
+  const files = /* @__PURE__ */ new Map();
+  const add = (link) => {
+    const name = cleanText(link.textContent);
+    const href = link.getAttribute("href") ?? "";
+    if (name && !files.has(name.toLowerCase())) files.set(name.toLowerCase(), { name, ...href ? { url: resolveUrl(baseUrl, href) } : {} });
+  };
+  for (const link of root.querySelectorAll(".fileuploadsubmission a[href]")) add(link);
+  for (const link of tableCell(root, "File submissions")?.querySelectorAll("a[href]") ?? []) add(link);
+  return {
+    id: activityId,
+    name: page2.name,
+    ...page2.course_id ? { unit_id: page2.course_id } : {},
+    url: page2.url,
+    submission_status: page2.submission_status,
+    grading_status: page2.grading_status,
+    due: page2.due_pretty || cleanText(tableCell(root, "Due date")?.textContent),
+    time_remaining: page2.time_remaining,
+    last_modified: cleanText(tableCell(root, "Last modified")?.textContent),
+    files: [...files.values()]
+  };
+}
+function noticesOf(html) {
+  const root = (0, import_node_html_parser3.parse)(html);
+  const texts = [];
+  for (const node2 of root.querySelectorAll(".alert, .invalid-feedback, .form-control-feedback, .error, [data-fieldtype] .text-danger")) {
+    for (const junk of node2.querySelectorAll("button, .close")) junk.remove();
+    const text = cleanText(node2.textContent);
+    if (text && !texts.includes(text)) texts.push(text);
+  }
+  return texts.join(" ");
+}
+function formWithAction(root, action) {
+  for (const form of root.querySelectorAll("form")) {
+    if (form.querySelectorAll("input[name=action]").some((input3) => input3.getAttribute("value") === action)) return form;
+  }
+  return null;
+}
+function formFields(form) {
+  const fields2 = [];
+  for (const element of form.querySelectorAll("input, textarea, select")) {
+    const name = element.getAttribute("name");
+    if (!name) continue;
+    const tag = element.tagName.toLowerCase();
+    if (tag === "textarea") {
+      fields2.push([name, element.textContent]);
+      continue;
+    }
+    if (tag === "select") {
+      const options = element.querySelectorAll("option");
+      const chosen = options.find((option) => option.hasAttribute("selected")) ?? options[0];
+      if (chosen) fields2.push([name, chosen.getAttribute("value") ?? cleanText(chosen.textContent)]);
+      continue;
+    }
+    const type = (element.getAttribute("type") ?? "text").toLowerCase();
+    if (["submit", "button", "image", "file", "reset"].includes(type)) continue;
+    if ((type === "checkbox" || type === "radio") && !element.hasAttribute("checked")) continue;
+    fields2.push([name, element.getAttribute("value") ?? (type === "checkbox" ? "on" : "")]);
+  }
+  return fields2;
+}
+function statementOf(form) {
+  const box = form.querySelector("input[name=submissionstatement]");
+  if (!box) return {};
+  const id2 = box.getAttribute("id");
+  const label = (id2 ? form.querySelector(`label[for="${id2}"]`) : null) ?? box.closest("label") ?? box.parentNode?.querySelector("label") ?? null;
+  const text = cleanText(label?.textContent).replace(/\s*Required\s*$/u, "").trim();
+  return { statement: text || "Submission statement" };
+}
+function filemanagerOptions(html, itemid) {
+  const pattern = /M\.form_filemanager\.init\(\s*Y\s*,\s*/gu;
+  let match;
+  while (match = pattern.exec(html)) {
+    const json2 = balancedObject(html, match.index + match[0].length);
+    if (!json2) continue;
+    try {
+      const options = JSON.parse(json2);
+      if (isRecord5(options) && String(options.itemid) === itemid) return options;
+    } catch {
+    }
+  }
+  return null;
+}
+function balancedObject(text, start) {
+  if (text[start] !== "{") return null;
+  let depth = 0;
+  let quoted = false;
+  for (let index = start; index < text.length; index += 1) {
+    const char = text[index];
+    if (quoted) {
+      if (char === "\\") index += 1;
+      else if (char === '"') quoted = false;
+    } else if (char === '"') quoted = true;
+    else if (char === "{") depth += 1;
+    else if (char === "}") {
+      depth -= 1;
+      if (depth === 0) return text.slice(start, index + 1);
+    }
+  }
+  return null;
+}
+function tableCell(root, label) {
+  for (const row of root.querySelectorAll("tr")) {
+    const cells = row.querySelectorAll("th, td");
+    if (cells.length > 1 && cleanText(cells[0].textContent) === label) return cells[1];
+  }
+  return null;
+}
+async function pageText(deps, url2) {
+  return (await deps.request(url2)).text();
+}
+async function postForm(deps, action, fields2) {
+  const response = await deps.request(action, {
+    method: "POST",
+    headers: { "content-type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams(fields2).toString()
+  });
+  const html = await response.text();
+  return landedOnView(response.url) ? null : html;
+}
+function landedOnView(url2) {
+  try {
+    const parsed = new URL(url2);
+    return parsed.pathname.endsWith(ASSIGN_VIEW_PATH) && (parsed.searchParams.get("action") ?? "view") === "view";
+  } catch {
+    return false;
+  }
+}
+async function draftAjax(deps, form, action, params) {
+  const body = new URLSearchParams({ sesskey: form.sesskey, client_id: form.clientId, itemid: form.itemid, ...params });
+  const response = await deps.request(`${deps.baseUrl}/repository/draftfiles_ajax.php?action=${action}`, {
+    method: "POST",
+    headers: { "content-type": "application/x-www-form-urlencoded" },
+    body: body.toString()
+  }, { allowErrorStatus: true });
+  return jsonOf(deps, response, `draft file ${action}`);
+}
+async function listDraftFiles(deps, form) {
+  const data = record2(await draftAjax(deps, form, "list", { filepath: "/" }));
+  const list2 = Array.isArray(data.list) ? data.list.map(record2) : [];
+  return list2.filter((item) => item.type !== "folder").map((item) => ({ name: String(item.filename ?? item.fullname ?? ""), path: String(item.filepath ?? "/"), bytes: integer2(item.size) })).filter((item) => item.name);
+}
+async function deleteDraftFiles(deps, form, files) {
+  const selected = JSON.stringify(files.map((file3) => ({ filename: file3.name, filepath: file3.path })));
+  const result = await draftAjax(deps, form, "deleteselected", { selected });
+  if (result === false) throw deps.fail("Moodle did not remove the existing submission files.");
+}
+async function uploadDraftFile(deps, form, file3) {
+  const body = new FormData();
+  body.set("sesskey", form.sesskey);
+  body.set("client_id", form.clientId);
+  body.set("repo_id", form.repoId);
+  body.set("itemid", form.itemid);
+  body.set("env", "filemanager");
+  body.set("ctx_id", form.contextId);
+  body.set("title", file3.name);
+  body.set("author", form.author);
+  body.set("license", form.license);
+  body.set("savepath", "/");
+  body.set("maxbytes", String(form.maxBytes));
+  body.set("areamaxbytes", String(form.areaMaxBytes));
+  for (const type of form.acceptedTypes === "*" ? ["*"] : form.acceptedTypes) body.append("accepted_types[]", type);
+  body.set("overwrite", "1");
+  body.set("repo_upload_file", new Blob([Uint8Array.from(file3.bytes)]), file3.name);
+  const response = await deps.request(`${deps.baseUrl}/repository/repository_ajax.php?action=upload`, { method: "POST", body }, { allowErrorStatus: true });
+  const data = record2(await jsonOf(deps, response, `upload of ${file3.name}`));
+  if (typeof data.error === "string" && data.error) throw deps.fail(`Moodle refused ${file3.name}: ${data.error}`, typeof data.errorcode === "string" ? data.errorcode : void 0);
+  if (data.event === "fileexists") throw deps.fail(`Moodle reports ${file3.name} already exists and did not overwrite it.`);
+  const stored = typeof data.file === "string" && data.file ? data.file : file3.name;
+  if (!data.url && !data.id && !data.file) throw deps.fail(`Moodle did not confirm the upload of ${file3.name}.`);
+  return stored;
+}
+async function jsonOf(deps, response, step) {
+  const text = await response.text();
+  try {
+    return JSON.parse(text);
+  } catch {
+    const notice = noticesOf(text);
+    throw deps.fail(`Moodle did not answer the ${step} with JSON (HTTP ${response.status})${notice ? `: ${notice}` : ""}`);
+  }
+}
+function checkLimits(deps, form, kept, files) {
+  if (form.maxFiles > 0 && kept.length + files.length > form.maxFiles) {
+    throw deps.usage(`This assignment allows ${form.maxFiles} file${form.maxFiles === 1 ? "" : "s"}; the submission would hold ${kept.length + files.length}.`, kept.length ? "Use --replace to drop the existing files first." : void 0);
+  }
+  for (const file3 of files) {
+    if (form.maxBytes > 0 && file3.bytes.byteLength > form.maxBytes) throw deps.usage(`${file3.name} is ${size(file3.bytes.byteLength)}; the limit is ${size(form.maxBytes)}.`);
+    if (form.acceptedTypes !== "*" && form.acceptedTypes.every((type) => type.startsWith(".")) && !form.acceptedTypes.some((type) => file3.name.toLowerCase().endsWith(type.toLowerCase()))) {
+      throw deps.usage(`${file3.name} is not an accepted type; allowed: ${form.acceptedTypes.join(", ")}.`);
+    }
+  }
+  const total = kept.reduce((sum, file3) => sum + file3.bytes, 0) + files.reduce((sum, file3) => sum + file3.bytes.byteLength, 0);
+  if (form.areaMaxBytes > 0 && total > form.areaMaxBytes) throw deps.usage(`The submission would total ${size(total)}; the limit is ${size(form.areaMaxBytes)}.`, kept.length ? "Use --replace to drop the existing files first." : void 0);
+}
+function describeLimits(form) {
+  return {
+    ...form.maxBytes > 0 ? { max_bytes: form.maxBytes } : {},
+    ...form.maxFiles > 0 ? { max_files: form.maxFiles } : {},
+    ...form.areaMaxBytes > 0 ? { area_max_bytes: form.areaMaxBytes } : {},
+    ...form.acceptedTypes !== "*" ? { accepted_types: form.acceptedTypes } : {}
+  };
+}
+function isSubmitted(status) {
+  return /\bsubmitted\b/iu.test(status) && !/\bnot submitted\b/iu.test(status);
+}
+function size(bytes) {
+  if (bytes >= 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+  if (bytes >= 1024) return `${(bytes / 1024).toFixed(1)} KiB`;
+  return `${bytes} B`;
+}
+function timestamp(deps) {
+  return (deps.now?.() ?? /* @__PURE__ */ new Date()).toISOString();
+}
+function integer2(value) {
+  const number4 = Number(value);
+  return Number.isSafeInteger(number4) ? number4 : 0;
+}
+function isRecord5(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function record2(value) {
+  return isRecord5(value) ? value : {};
+}
+
+// src/parsers.ts
+function schema(parser) {
+  return { parse: parser };
+}
+var UserInfoSchema = schema(parseUserInfo);
+var CourseSchema = schema(parseCourse);
+var CoursesSchema = schema(parseCourses);
+var ActivitySchema = schema(parseActivity);
+var SectionSchema = schema(parseSection);
+var CourseContentsSchema = schema(parseCourseContents);
+var TodoItemSchema = schema(parseTodoItem);
+function parseUserInfo(value) {
+  const data = asRecord(value);
+  return {
+    userid: numberValue2(data.userid),
+    username: stringValue3(data.username),
+    fullname: stringValue3(data.fullname),
+    sitename: stringValue3(data.sitename),
+    siteurl: stringValue3(data.siteurl),
+    lang: stringValue3(data.lang),
+    ...data.timezone ? { timezone: String(data.timezone) } : {}
+  };
+}
+function parseCourse(value, nowSeconds = Math.floor(Date.now() / 1e3)) {
+  const data = asRecord(value);
+  const course = {
+    id: numberValue2(data.id),
+    shortname: stringValue3(data.shortname),
+    fullname: stringValue3(data.fullname),
+    category: numberValue2(data.category),
+    visible: booleanValue(data.visible, true),
+    startdate: numberValue2(data.startdate)
+  };
+  const enddate = numberValue2(data.enddate);
+  if (enddate > 0) {
+    course.enddate = enddate;
+  }
+  return course;
+}
+function parseCourses(value) {
+  return asArray(value).map((item) => parseCourse(item));
+}
+function parseActivity(value) {
+  const data = asRecord(value);
+  return {
+    id: numberValue2(data.id),
+    name: stringValue3(data.name),
+    modname: stringValue3(data.modname),
+    url: stringValue3(data.url),
+    visible: booleanValue(data.visible, true),
+    description: stringValue3(data.description),
+    ...data.completiondata && typeof data.completiondata === "object" ? { completion: numberValue2(asRecord(data.completiondata).state) } : {},
+    ...Array.isArray(data.contents) ? { file_entries: data.contents.filter((f) => asRecord(f).fileurl).map((f) => ({ name: stringValue3(asRecord(f).filename), url: stringValue3(asRecord(f).fileurl), requires_authentication: true })) } : {}
+  };
+}
+function parseSection(value) {
+  const data = asRecord(value);
+  return {
+    id: numberValue2(data.id),
+    name: stringValue3(data.name),
+    section: numberValue2(data.section),
+    visible: booleanValue(data.visible, true),
+    summary: stringValue3(data.summary),
+    ...data.current !== void 0 ? { current: booleanValue(data.current) } : {},
+    activities: asArray(data.modules).map((item) => parseActivity(item))
+  };
+}
+function parseCourseContents(value) {
+  return asArray(value).map((item) => parseSection(item));
+}
+function parseCourseFormatState(value, baseUrl) {
+  const state = asRecord(parseJsonValue(value));
+  const activities = /* @__PURE__ */ new Map();
+  const activitiesBySection = /* @__PURE__ */ new Map();
+  for (const item of asArray(state.cm)) {
+    const data = asRecord(item);
+    const id2 = numberValue2(data.id);
+    const sectionId = stringValue3(data.sectionid);
+    const module = stringValue3(data.module) || stringValue3(data.plugin).replace(/^mod_/u, "") || stringValue3(data.modname).toLowerCase();
+    const activity = {
+      id: id2,
+      name: htmlText(data.name, baseUrl),
+      modname: module.toLowerCase(),
+      url: stringValue3(data.url) ? resolveUrl(baseUrl, stringValue3(data.url)) : "",
+      visible: booleanValue(data.visible, true) && booleanValue(data.uservisible, true) && !booleanValue(data.stealth),
+      description: htmlText(data.content ?? data.description, baseUrl),
+      ...data.completionstate !== void 0 && data.completionstate !== null ? { completion: numberValue2(data.completionstate) } : {}
+    };
+    activities.set(String(id2), activity);
+    const sectionActivities = activitiesBySection.get(sectionId) ?? [];
+    sectionActivities.push(activity);
+    activitiesBySection.set(sectionId, sectionActivities);
+  }
+  return asArray(state.section).map((item) => {
+    const data = asRecord(item);
+    const id2 = numberValue2(data.id);
+    const hasActivityList = Array.isArray(data.cmlist);
+    const listedActivities = asArray(data.cmlist).map((activityId) => activities.get(stringValue3(activityId))).filter((activity) => activity !== void 0);
+    return {
+      id: id2,
+      name: htmlText(data.title || data.rawtitle, baseUrl),
+      section: numberValue2(data.section ?? data.number),
+      visible: booleanValue(data.visible, true),
+      summary: htmlText(data.summary, baseUrl),
+      ...data.current !== void 0 ? { current: booleanValue(data.current) } : {},
+      activities: hasActivityList ? listedActivities : activitiesBySection.get(String(id2)) ?? []
+    };
+  });
+}
+function parseTodoItem(value) {
+  const data = asRecord(value);
+  const course = asRecord(data.course);
+  const action = asRecord(data.action);
+  const progress = course.progress;
+  return {
+    id: numberValue2(data.id),
+    name: stringValue3(data.name),
+    activity_name: stringValue3(data.activityname),
+    modname: stringValue3(data.modulename),
+    course_id: numberValue2(course.id),
+    course_name: stringValue3(course.fullname),
+    due_at: numberValue2(data.timesort) || numberValue2(data.timestart),
+    overdue: booleanValue(data.overdue),
+    actionable: booleanValue(action.actionable),
+    action_name: stringValue3(action.name),
+    action_url: stringValue3(action.url),
+    url: stringValue3(data.url),
+    event_type: stringValue3(data.eventtype),
+    course_progress: typeof progress === "number" ? progress : void 0
+  };
+}
+function parseTodoItems(value) {
+  return asArray(value).map((item) => parseTodoItem(item));
+}
+function parseAlertNotification(value) {
+  const data = asRecord(value);
+  return {
+    id: numberValue2(data.id),
+    subject: stringValue3(data.subject),
+    short_subject: stringValue3(data.shortenedsubject),
+    event_type: stringValue3(data.eventtype),
+    component: stringValue3(data.component),
+    created_at: numberValue2(data.timecreated),
+    created_pretty: stringValue3(data.timecreatedpretty),
+    read: booleanValue(data.read),
+    context_url: stringValue3(data.contexturl),
+    context_name: stringValue3(data.contexturlname)
+  };
+}
+function parseAlertSummary(notificationsData, countsData, unreadCountsData) {
+  const notificationsRecord = asRecord(notificationsData);
+  const counts2 = asRecord(countsData);
+  const unreadCounts = asRecord(unreadCountsData);
+  const types = asRecord(counts2.types);
+  const unreadTypes = asRecord(unreadCounts.types);
+  const notifications = asArray(notificationsRecord.notifications).map((item) => parseAlertNotification(item));
+  return {
+    notifications,
+    notification_count: notifications.length,
+    unread_notification_count: notifications.filter((notification) => !notification.read).length,
+    starred_message_count: numberValue2(counts2.favourites),
+    direct_message_count: numberValue2(types["1"]),
+    group_message_count: numberValue2(types["2"]),
+    self_message_count: numberValue2(types["3"]),
+    unread_starred_message_count: numberValue2(unreadCounts.favourites),
+    unread_direct_message_count: numberValue2(unreadTypes["1"]),
+    unread_group_message_count: numberValue2(unreadTypes["2"]),
+    unread_self_message_count: numberValue2(unreadTypes["3"])
+  };
+}
+function parseForumPostAuthor(value) {
+  const data = asRecord(value);
+  const urls = asRecord(data.urls);
+  return {
+    id: numberValue2(data.id),
+    fullname: stringValue3(data.fullname),
+    profile_url: stringValue3(urls.profile),
+    profile_image_url: stringValue3(urls.profileimage)
+  };
+}
+function parseForumPost(value, baseUrl = "") {
+  const data = asRecord(value);
+  const urls = asRecord(data.urls);
+  const messageHtml = stringValue3(data.message);
+  const structured = htmlToStructuredContent(messageHtml, stringValue3(urls.view || urls.discuss) || baseUrl);
+  return {
+    id: numberValue2(data.id),
+    discussion_id: numberValue2(data.discussionid),
+    subject: stringValue3(data.subject),
+    message_html: messageHtml,
+    message_text: structured.text,
+    image_urls: structured.image_urls,
+    links: structured.links,
+    tables: structured.tables,
+    author: parseForumPostAuthor(data.author),
+    parent_id: numberValue2(data.parentid),
+    time_created: numberValue2(data.timecreated),
+    time_modified: numberValue2(data.timemodified),
+    created_pretty: "",
+    unread: booleanValue(data.unread),
+    is_deleted: booleanValue(data.isdeleted),
+    is_private_reply: booleanValue(data.isprivatereply),
+    url: stringValue3(urls.view || urls.viewisolated),
+    reply_url: stringValue3(urls.reply)
+  };
+}
+function parseForumDiscussion(value, discussionId, baseUrl = "") {
+  const data = asRecord(value);
+  const posts = asArray(data.posts).map((item) => parseForumPost(item, baseUrl));
+  return {
+    id: discussionId,
+    subject: posts[0]?.subject ?? "",
+    course_id: numberValue2(data.courseid),
+    forum_id: numberValue2(data.forumid),
+    group_id: numberValue2(data.groupid),
+    group_name: stringValue3(data.groupname),
+    url: posts[0]?.url ? posts[0].url.split("#", 1)[0] : "",
+    posts
+  };
+}
+function asRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function stringValue3(value) {
+  return typeof value === "string" ? value : value == null ? "" : String(value);
+}
+function numberValue2(value) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    return value;
+  }
+  if (typeof value === "string" && value.trim() !== "" && Number.isFinite(Number(value))) {
+    return Number(value);
+  }
+  return 0;
+}
+function booleanValue(value, defaultValue = false) {
+  if (value === void 0 || value === null) {
+    return defaultValue;
+  }
+  return Boolean(value);
+}
+function parseJsonValue(value) {
+  if (typeof value !== "string") return value;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return {};
+  }
+}
+function htmlText(value, baseUrl) {
+  return htmlToStructuredContent(stringValue3(value), baseUrl).text;
+}
+
 // src/moodle-forum-core.ts
 var ForumModule = class {
   baseUrl;
@@ -28124,13 +28508,13 @@ var ForumModule = class {
   }
 };
 function shouldFallbackForumAjax(error62) {
-  if (!isRecord5(error62)) {
+  if (!isRecord6(error62)) {
     return false;
   }
   const code = typeof error62.moodleErrorCode === "string" ? error62.moodleErrorCode : "";
   return code === "servicenotavailable" || code === "accessexception" || error62 instanceof Error && error62.message.includes("Web service is not available");
 }
-function isRecord5(value) {
+function isRecord6(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -28262,9 +28646,9 @@ async function searchForumContent(source, query, options = {}) {
   hits.sort(sortBy === "recent" ? sortRecent : sortRelevant);
   return hits.slice(0, options.limit ?? 20).map(([, hit]) => includePostText ? hit : { ...hit, snippet: "" });
 }
-async function inParallel(items, size, run) {
+async function inParallel(items, size2, run) {
   const results = [];
-  for (let index = 0; index < items.length; index += size) results.push(...await Promise.all(items.slice(index, index + size).map(run)));
+  for (let index = 0; index < items.length; index += size2) results.push(...await Promise.all(items.slice(index, index + size2).map(run)));
   return results;
 }
 function normalizeQuery(value) {
@@ -28450,7 +28834,7 @@ var MoodleClientCore = class {
     try {
       if (this.unavailable.has(FUNC_GET_SITE_INFO) && this.userInfo?.fullname) return this.userInfo;
       const data = await this.call(FUNC_GET_SITE_INFO);
-      if (isRecord6(data) && "userid" in data) {
+      if (isRecord7(data) && "userid" in data) {
         const info = parseUserInfo(data);
         this.sesskey = typeof data.sesskey === "string" ? data.sesskey : this.sesskey;
         this.userid = info.userid;
@@ -28549,9 +28933,9 @@ var MoodleClientCore = class {
     let type = "";
     try {
       const data = await this.call(FUNC_GET_COURSE_MODULE, { cmid: id2 });
-      const module = isRecord6(data) && isRecord6(data.cm) ? data.cm : data;
-      type = isRecord6(module) && typeof module.modname === "string" ? module.modname : "";
-      courseId = isRecord6(module) && typeof module.course === "number" ? module.course : void 0;
+      const module = isRecord7(data) && isRecord7(data.cm) ? data.cm : data;
+      type = isRecord7(module) && typeof module.modname === "string" ? module.modname : "";
+      courseId = isRecord7(module) && typeof module.course === "number" ? module.course : void 0;
     } catch (error62) {
       if (!this.errors.isApi(error62) || error62.moodleErrorCode !== "servicenotavailable") {
         throw error62;
@@ -28595,14 +28979,14 @@ var MoodleClientCore = class {
       } else {
         data = await this.call(FUNC_GET_ACTION_EVENTS, { ...window, limittononsuspendedevents: true });
       }
-      const events = isRecord6(data) && Array.isArray(data.events) ? data.events : [];
+      const events = isRecord7(data) && Array.isArray(data.events) ? data.events : [];
       for (const item of parseTodoItems(events)) if (!seen.has(item.id)) {
         seen.add(item.id);
         items.push(item);
       }
       if (events.length < batchSize) break;
       const last = events.at(-1);
-      const next = isRecord6(last) && typeof last.id === "number" ? last.id : void 0;
+      const next = isRecord7(last) && typeof last.id === "number" ? last.id : void 0;
       if (!next || next === aftereventid) throw this.errors.api("Moodle repeated a calendar page; refine the date window.");
       aftereventid = next;
     }
@@ -28769,8 +29153,18 @@ var MoodleClientCore = class {
   async getFolder(id2) {
     return parseFolderHtml(await this.get(FOLDER_VIEW_PATH, { id: id2 }), id2, this.baseUrl);
   }
-  async requestAbsolute(url2, init = {}) {
-    return this.requestAbsoluteInternal(url2, init, true);
+  async requestAbsolute(url2, init = {}, options = {}) {
+    return this.requestAbsoluteInternal(url2, init, true, Boolean(options.allowErrorStatus));
+  }
+  /** Uploads files into an assignment and reads the receipt back from the site. */
+  async submitAssignment(request) {
+    await this.ensureSession();
+    return submitAssignmentFiles({
+      baseUrl: this.baseUrl,
+      request: (url2, init, options) => this.requestAbsolute(url2, init, options),
+      fail: (message, moodleErrorCode) => this.errors.api(message, moodleErrorCode),
+      usage: (message, hint) => this.errors.usage ? this.errors.usage(message, hint) : new MoodleClientCoreError("usage", message, hint)
+    }, request);
   }
   async getNewsForums(courseId) {
     const units = courseId === void 0 ? await this.getCourses() : (await this.getCourses()).filter((c) => c.id === courseId);
@@ -28780,7 +29174,7 @@ var MoodleClientCore = class {
       await this.ensureSession();
       const data = await this.call("mod_forum_get_forums_by_courses", { courseids: units.map((c) => c.id) });
       for (const f of Array.isArray(data) ? data : []) {
-        if (!isRecord6(f) || f.type !== "news" || typeof f.cmid !== "number") continue;
+        if (!isRecord7(f) || f.type !== "news" || typeof f.cmid !== "number") continue;
         const c = units.find((c2) => c2.id === f.course);
         forums.push({ id: f.cmid, name: String(f.name || ""), course_id: Number(f.course), course_name: c?.fullname || "", url: `${this.baseUrl}/mod/forum/view.php?id=${f.cmid}` });
       }
@@ -28908,16 +29302,16 @@ var MoodleClientCore = class {
   async getAbsolute(url2) {
     return (await this.requestAbsolute(url2)).text();
   }
-  async requestAbsoluteInternal(url2, init, allowRetry) {
+  async requestAbsoluteInternal(url2, init, allowRetry, allowErrorStatus = false) {
     const response = await fetchWithSession(url2, init, this.baseUrl, this.cookie, this.fetchImpl);
     if (response.url.includes("/login/")) {
       if (this.onLoginRequired && allowRetry && !this.retryingLogin) {
         await this.reauthenticate();
-        return this.requestAbsoluteInternal(url2, init, false);
+        return this.requestAbsoluteInternal(url2, init, false, allowErrorStatus);
       }
       throw this.errors.api("Session expired", "servicerequireslogin");
     }
-    if (!response.ok) {
+    if (!response.ok && !allowErrorStatus) {
       const context = `HTTP ${response.status} loading ${safeUrl(url2)}`;
       const contentType2 = response.headers.get("content-type")?.toLowerCase() ?? "";
       if (contentType2.includes("text/html") || contentType2.includes("application/xhtml+xml")) {
@@ -28935,7 +29329,7 @@ var MoodleClientCore = class {
     let offset = 0;
     while (true) {
       const data = await this.call(FUNC_GET_COURSES_BY_TIMELINE, { classification: "all", limit: 100, offset });
-      if (!isRecord6(data) || !Array.isArray(data.courses) || !data.courses.length) {
+      if (!isRecord7(data) || !Array.isArray(data.courses) || !data.courses.length) {
         break;
       }
       courses.push(...data.courses);
@@ -29098,19 +29492,19 @@ function placeholderUserInfo(baseUrl, userid) {
   };
 }
 function parseTodoPayload(value) {
-  return parseTodoItems(isRecord6(value) && Array.isArray(value.events) ? value.events : []);
+  return parseTodoItems(isRecord7(value) && Array.isArray(value.events) ? value.events : []);
 }
 function errorMessage(value) {
   return value instanceof Error ? value.message : "Unknown Moodle error";
 }
-function chunks(values, size) {
+function chunks(values, size2) {
   const result = [];
-  for (let index = 0; index < values.length; index += size) {
-    result.push(values.slice(index, index + size));
+  for (let index = 0; index < values.length; index += size2) {
+    result.push(values.slice(index, index + size2));
   }
   return result;
 }
-function isRecord6(value) {
+function isRecord7(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
 function isLoginErrorCode(code) {
@@ -29133,7 +29527,7 @@ function safeUrl(value) {
 }
 
 // src/mcp/gateway.ts
-var import_node_html_parser3 = __toESM(require_dist(), 1);
+var import_node_html_parser4 = __toESM(require_dist(), 1);
 var MAX_MCP_FILE_BYTES = 16 * 1024 * 1024;
 var MoodleGatewayError = class extends Error {
   code;
@@ -29143,13 +29537,14 @@ var MoodleGatewayError = class extends Error {
     this.code = code;
   }
 };
-function createMoodleGateway(client) {
+function createMoodleGateway(client, hooks = {}) {
   return {
     getUser: () => client.getSiteInfo(),
     listThreads: (id2) => client.getForumDiscussionRefs ? client.getForumDiscussionRefs(id2) : Promise.resolve([]),
     listNewsForums: (id2) => client.getNewsForums ? client.getNewsForums(id2) : Promise.resolve([]),
     getOverview: (input3) => client.getOverview(input3.todoLimit, input3.todoDays, input3.alertsLimit),
     ...client.getTodo ? { getDue: (days, courseId) => client.getTodo(Number.MAX_SAFE_INTEGER, days, courseId) } : {},
+    ...client.submitAssignmentFiles ? { submitAssignment: (input3) => client.submitAssignmentFiles({ ...input3, ...hooks.onSubmitProgress ? { onProgress: hooks.onSubmitProgress } : {} }) } : {},
     listCourses: () => client.getCourses(),
     async getCourse({ courseId }) {
       const [courses, sections] = await Promise.all([
@@ -29273,7 +29668,7 @@ async function fileFromActivity(client, activityId) {
   return { url: entry.url, name: entry.name };
 }
 function resourceLinks(html, baseUrl) {
-  const root = (0, import_node_html_parser3.parse)(html);
+  const root = (0, import_node_html_parser4.parse)(html);
   const entries = root.querySelectorAll(".resourceworkaround a[href], .resourcecontent a[href], a.resourceworkaround[href]").map((link) => ({
     name: link.textContent.trim(),
     url: new URL(link.getAttribute("href") ?? "", baseUrl).toString()
@@ -29327,7 +29722,7 @@ function isHtml(response) {
   return type.includes("text/html") || type.includes("application/xhtml+xml");
 }
 function looksLikeLoginPage(html) {
-  const root = (0, import_node_html_parser3.parse)(html);
+  const root = (0, import_node_html_parser4.parse)(html);
   return root.querySelector('form[action*="/login/"], input[name="password"], #page-login-index') !== null || /<title>\s*(?:log in|login)/iu.test(html);
 }
 function contentType(response) {
@@ -29400,6 +29795,8 @@ var counts = external_exports.object(Object.fromEntries(["notification_count", "
 var postSchema = external_exports.object({ id, parent_id: n, name: s, author: external_exports.object({ id, name: s }), time_created: id, created: s, message_text: s, links: external_exports.array(external_exports.object({ text: s, url: s })).optional() });
 var gradeSchema = external_exports.object({ unit_id: id, code: s, graded: id, total: id, total_grade: s, total_range: s, total_percentage: s, items: external_exports.array(external_exports.object({ name: s, type: s, grade: s, range: s, percentage: s, weight: s, contribution: s, feedback: s, status: s, due: s, due_at: n })).optional() });
 var searchSchema = external_exports.object({ unit_id: id, forum_id: id, discussion_id: id, name: s, post_id: id, snippet: s, time_created: n, created: s, url: s });
+var submissionFile = external_exports.object({ name: external_exports.string(), bytes: n, url: s });
+var receiptSchema = external_exports.object({ id, name: s, unit_id: n, url: s, action: external_exports.enum(["planned", "saved", "submitted"]), submission_status: s, grading_status: s, due: s, time_remaining: s, last_modified: s, statement: s, statement_accepted: external_exports.boolean().optional(), files: external_exports.array(submissionFile).optional(), uploads: external_exports.array(external_exports.object({ name: external_exports.string(), bytes: id, path: s })).optional(), removed: external_exports.array(external_exports.string()).optional(), limits: external_exports.object({ max_bytes: n, max_files: n, area_max_bytes: n, accepted_types: external_exports.array(external_exports.string()).optional() }).optional(), checked_at: external_exports.string() });
 var input2 = (shape) => external_exports.object(shape).strict();
 var list = (key, value) => external_exports.object({ [key]: external_exports.array(value).optional(), total: id });
 var intentContracts = {
@@ -29413,6 +29810,7 @@ var intentContracts = {
   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: input2({ unit: ref.optional(), limit: limit.default(5) }), output: list("news", external_exports.object({ id, name: s, unit_id: id, unit_code: s, forum_id: id, post: postSchema.optional() })) },
   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: input2({ discussion_id: external_exports.number().int().positive(), limit, offset: external_exports.number().int().nonnegative().default(0) }), output: external_exports.object({ thread: external_exports.object({ id, name: s, unit_id: id, forum_id: id, url: s, posts: external_exports.array(postSchema).optional(), posts_total: id, offset: id }) }) },
   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: input2({ query: external_exports.string().trim().min(1), unit: ref.optional(), courseId: external_exports.number().int().positive().optional(), forumId: external_exports.number().int().positive().optional(), limit, includePostText: external_exports.boolean().default(true), titlesOnly: external_exports.boolean().default(false), unreadOnly: external_exports.boolean().default(false), sortBy: external_exports.enum(["relevance", "recent"]).default("relevance"), maxForums: limit.default(20), maxDiscussionsPerForum: limit.default(50) }), output: external_exports.object({ results: external_exports.array(searchSchema).optional(), total: id, forums: external_exports.record(external_exports.string(), external_exports.string()).optional(), units: external_exports.record(external_exports.string(), external_exports.string()).optional(), scope: external_exports.object({ max_forums: id, max_discussions_per_forum: id }) }) },
+  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: input2({ ref, files: external_exports.array(external_exports.string().trim().min(1)).max(20).default([]), final: external_exports.boolean().default(false), replace: external_exports.boolean().default(false), accept_statement: external_exports.boolean().default(false), dry_run: external_exports.boolean().default(true) }), output: external_exports.object({ submission: receiptSchema }) },
   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: input2({ ref }), output: external_exports.object({ file: external_exports.object({ name: external_exports.string(), mime_type: external_exports.string(), bytes: id, uri: external_exports.string() }) }) }
 };
 function intentDescription(name) {
@@ -29472,9 +29870,9 @@ function postRow(p, subject, tz = "UTC") {
 }
 
 // src/intents.ts
-async function inParallel2(items, size, run) {
+async function inParallel2(items, size2, run) {
   const results = [];
-  for (let index = 0; index < items.length; index += size) results.push(...await Promise.all(items.slice(index, index + size).map(run)));
+  for (let index = 0; index < items.length; index += size2) results.push(...await Promise.all(items.slice(index, index + size2).map(run)));
   return results;
 }
 function createIntentService(gateway, now = () => Date.now()) {
@@ -29665,6 +30063,12 @@ function createIntentService(gateway, now = () => Date.now()) {
         result = { file: { name: file3.name, mime_type: file3.mimeType, bytes: file3.bytes, uri: file3.uri } };
         break;
       }
+      case "submit": {
+        if (!gateway.submitAssignment) throw new MoodleGatewayError("MOODLE_TOOL_UNAVAILABLE", "Submitting needs local files; run moodle submit or the local MCP server on the machine that holds them.");
+        const activityId = await resolveItem(input3.ref);
+        result = { submission: await gateway.submitAssignment({ activityId, files: input3.files, final: Boolean(input3.final), replace: Boolean(input3.replace), acceptStatement: Boolean(input3.accept_statement), dryRun: Boolean(input3.dry_run) }) };
+        break;
+      }
     }
     return intentContracts[name].output.parse(stripEmpty(result));
   }
@@ -29683,13 +30087,23 @@ var READ_ONLY_ANNOTATIONS = {
   idempotentHint: true,
   openWorldHint: true
 };
+var WRITE_ANNOTATIONS = {
+  readOnlyHint: false,
+  destructiveHint: true,
+  idempotentHint: false,
+  openWorldHint: true
+};
+var WRITE_TOOLS = /* @__PURE__ */ new Set(["submit"]);
 var aliases = { get_overview: "home", list_courses: "units", get_course: "unit", get_activity: "item", get_grades: "grades", get_thread: "thread", get_file: "file" };
 var TOOL_CATALOG = Object.entries(intentContracts).map(([name, contract]) => ({
   name,
   description: intentDescription(name),
   inputSchema: compactSchema(external_exports.toJSONSchema(contract.input, { io: "input" })),
-  annotations: READ_ONLY_ANNOTATIONS
+  annotations: WRITE_TOOLS.has(name) ? WRITE_ANNOTATIONS : READ_ONLY_ANNOTATIONS
 }));
+function toolsFor(gateway) {
+  return gateway.submitAssignment ? TOOL_CATALOG : TOOL_CATALOG.filter((tool) => !WRITE_TOOLS.has(tool.name));
+}
 var TOOL_OUTPUT_SCHEMAS = Object.fromEntries(Object.entries(intentContracts).map(([name, contract]) => [name, compactSchema(external_exports.toJSONSchema(contract.output))]));
 function compactSchema(value) {
   if (Array.isArray(value)) return value.map(compactSchema);
@@ -29727,7 +30141,7 @@ function createMoodleMcpServer(gateway, options = {}) {
             protocolVersion,
             capabilities: { tools: { listChanged: false } },
             serverInfo,
-            instructions: "Read-only access to the authenticated user's Moodle data."
+            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."
           });
         }
         if (request.method === "ping") {
@@ -29735,7 +30149,7 @@ function createMoodleMcpServer(gateway, options = {}) {
         }
         if (request.method === "tools/list") {
           return jsonRpcSuccess(id2, {
-            tools: TOOL_CATALOG,
+            tools: toolsFor(gateway),
             resultType: "complete",
             _meta: RESULT_META
           });
@@ -29791,8 +30205,9 @@ async function callTool(gateway, params) {
   const requested = typeof params?.name === "string" ? params.name : "";
   const name = Object.hasOwn(aliases, requested) ? aliases[requested] : requested;
   if (!Object.hasOwn(intentContracts, name) && !["get_user", "list_activities", "list_forums"].includes(name)) throw new McpCallError("TOOL_NOT_FOUND", `Unknown Moodle tool: ${requested || "<missing>"}`);
+  if (WRITE_TOOLS.has(name) && !gateway.submitAssignment) throw new McpCallError("TOOL_NOT_FOUND", `${requested} is only available on a local MCP server with access to the files.`);
   const raw = params?.arguments ?? {};
-  if (!isRecord7(raw)) throw new McpCallError("INVALID_TOOL_ARGUMENTS", "Tool arguments must be an object.");
+  if (!isRecord8(raw)) throw new McpCallError("INVALID_TOOL_ARGUMENTS", "Tool arguments must be an object.");
   const args = { ...raw };
   if (Object.hasOwn(aliases, requested)) {
     const renames = { courseId: "unit", activityId: "ref", discussionId: "discussion_id", source: "ref", todoDays: "days", gradedOnly: "graded_only" };
@@ -29840,7 +30255,7 @@ async function callTool(gateway, params) {
       const mapped2 = { type: "MOODLE_RESULT_INVALID", message: `Moodle returned ${name} data in an unexpected shape.`, hint: "Retry once; if it persists, run the same command locally with --verbose and report the tool name.", issues: error62.issues.slice(0, 5).map((issue2) => ({ path: issue2.path.join("."), message: issue2.message })) };
       return { content: [{ type: "text", text: JSON.stringify({ error: mapped2 }) }], structuredContent: { error: mapped2 }, isError: true, resultType: "complete", _meta: RESULT_META };
     }
-    const mapped = error62 instanceof ReferenceError2 ? { type: error62.code, code: error62.code, message: error62.message, hint: error62.hint, candidates: error62.candidates } : mapMoodleError(error62);
+    const mapped = error62 instanceof ReferenceError2 ? { type: error62.code, code: error62.code, message: error62.message, hint: error62.hint, candidates: error62.candidates } : mapMoodleError(error62, WRITE_TOOLS.has(name));
     return { content: [{ type: "text", text: JSON.stringify({ error: mapped }) }], structuredContent: { error: mapped }, isError: true, resultType: "complete", _meta: RESULT_META };
   }
 }
@@ -29859,9 +30274,11 @@ function toolContent(name, payload, structuredContent) {
     }
   ];
 }
-function mapMoodleError(error62) {
-  const record2 = isRecord7(error62) ? error62 : {};
-  const code = typeof record2.code === "string" ? record2.code : "";
+function mapMoodleError(error62, verbatim = false) {
+  const record3 = isRecord8(error62) ? error62 : {};
+  const code = typeof record3.code === "string" ? record3.code : "";
+  const own2 = verbatim && typeof record3.message === "string" && record3.message.trim() && code !== "auth" ? record3.message : void 0;
+  const ownHint = verbatim && typeof record3.hint === "string" && record3.hint.trim() ? record3.hint : void 0;
   const typeByCode = {
     auth: "MOODLE_AUTH_REQUIRED",
     not_found: "MOODLE_NOT_FOUND",
@@ -29870,8 +30287,8 @@ function mapMoodleError(error62) {
   };
   const type = code.startsWith("MOODLE_") ? code : typeByCode[code] ?? "MOODLE_UPSTREAM_ERROR";
   const message = type === "MOODLE_AUTH_REQUIRED" ? "The Moodle session has expired. Sign in again." : type === "MOODLE_NOT_FOUND" || type === "MOODLE_COURSE_NOT_FOUND" ? "The requested Moodle item was not found." : type === "MOODLE_INVALID_REQUEST" ? "The Moodle request is invalid." : "Moodle could not complete the request.";
-  const moodleCode = typeof record2.moodleErrorCode === "string" && /^[a-z][a-z0-9_]{0,63}$/u.test(record2.moodleErrorCode) ? record2.moodleErrorCode : void 0;
-  return { type, message, hint: type === "MOODLE_AUTH_REQUIRED" ? "Run moodle mcp login for a remote server, or moodle auth login locally; then retry." : "Run moodle doctor, or refine the request using units and find.", ...type === "MOODLE_AUTH_REQUIRED" ? { recovery: { action: "moodle mcp login", where: "machine running moodle-cli", then: "retry this tool" } } : {}, ...moodleCode ? { moodleCode } : {} };
+  const moodleCode = typeof record3.moodleErrorCode === "string" && /^[a-z][a-z0-9_]{0,63}$/u.test(record3.moodleErrorCode) ? record3.moodleErrorCode : void 0;
+  return { type, message: own2 ?? message, hint: ownHint ?? (type === "MOODLE_AUTH_REQUIRED" ? "Run moodle mcp login for a remote server, or moodle auth login locally; then retry." : "Run moodle doctor, or refine the request using units and find."), ...type === "MOODLE_AUTH_REQUIRED" ? { recovery: { action: "moodle mcp login", where: "machine running moodle-cli", then: "retry this tool" } } : {}, ...moodleCode ? { moodleCode } : {} };
 }
 var McpCallError = class extends Error {
   type;
@@ -29883,11 +30300,11 @@ var McpCallError = class extends Error {
     this.details = details;
   }
 };
-function isRecord7(value) {
+function isRecord8(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isMoodleFile(value) {
-  return isRecord7(value) && typeof value.name === "string" && typeof value.mimeType === "string" && typeof value.bytes === "number" && typeof value.uri === "string" && typeof value.blob === "string";
+  return isRecord8(value) && typeof value.name === "string" && typeof value.mimeType === "string" && typeof value.bytes === "number" && typeof value.uri === "string" && typeof value.blob === "string";
 }
 
 // src/worker/moodle-upstream.ts
@@ -29958,17 +30375,17 @@ var FetchMoodleSessionUpstream = class {
       return { alive: false, remainingSeconds: null };
     }
     if (!Array.isArray(body) || body.length === 0) return { alive: null, remainingSeconds: null };
-    const first2 = isRecord8(body[0]) ? body[0] : void 0;
+    const first2 = isRecord9(body[0]) ? body[0] : void 0;
     if (first2?.error) {
-      const exception = isRecord8(first2.exception) ? first2.exception : void 0;
+      const exception = isRecord9(first2.exception) ? first2.exception : void 0;
       const errorCode = typeof exception?.errorcode === "string" ? exception.errorcode : "";
       if (errorCode === "servicerequireslogin" || errorCode === "sitepolicynotagreed") {
         return { alive: false, remainingSeconds: null };
       }
       return { alive: null, remainingSeconds: null };
     }
-    const last = isRecord8(body.at(-1)) ? body.at(-1) : void 0;
-    const data = isRecord8(last?.data) ? last.data : void 0;
+    const last = isRecord9(body.at(-1)) ? body.at(-1) : void 0;
+    const data = isRecord9(last?.data) ? last.data : void 0;
     const remainingSeconds = typeof data?.timeremaining === "number" ? data.timeremaining : null;
     const rotatedCookie = cookieFromSetCookie(response.headers.get("set-cookie"), session.cookieName);
     return {
@@ -29990,7 +30407,7 @@ function cookieFromSetCookie(header, cookieName) {
   const escaped = cookieName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
   return header.match(new RegExp(`(?:^|,\\s*)${escaped}=([^;,\\s]+)`))?.[1];
 }
-function isRecord8(value) {
+function isRecord9(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -30212,16 +30629,16 @@ var SessionBroker = class {
     });
   }
   async readSession(storage) {
-    const record2 = await storage.get(SESSION_STORAGE_KEY);
-    if (!record2) return void 0;
-    if (record2.version === 2 && typeof record2.encrypted_session === "string") {
-      const decrypted = await decryptValue(record2.encrypted_session, await this.keyring());
+    const record3 = await storage.get(SESSION_STORAGE_KEY);
+    if (!record3) return void 0;
+    if (record3.version === 2 && typeof record3.encrypted_session === "string") {
+      const decrypted = await decryptValue(record3.encrypted_session, await this.keyring());
       const session = JSON.parse(decrypted.value);
       if (typeof session.cookie_value !== "string" || typeof session.sesskey !== "string" || !Number.isSafeInteger(session.moodle_user_id) || session.moodle_user_id <= 0) throw new Error("Invalid encrypted session.");
       return session;
     }
-    if (typeof record2.encrypted_cookie !== "string") throw new Error("Invalid legacy session.");
-    const { encrypted_cookie, ...metadata } = record2;
+    if (typeof record3.encrypted_cookie !== "string") throw new Error("Invalid legacy session.");
+    const { encrypted_cookie, ...metadata } = record3;
     const cookie = await decryptValue(encrypted_cookie, await this.keyring());
     return { ...metadata, cookie_value: cookie.value };
   }
@@ -30233,10 +30650,10 @@ var SessionBroker = class {
   }
   async loadSession() {
     return this.transaction(async (storage) => {
-      const record2 = await storage.get(SESSION_STORAGE_KEY);
-      if (!record2) return void 0;
+      const record3 = await storage.get(SESSION_STORAGE_KEY);
+      if (!record3) return void 0;
       const session = await this.readSession(storage);
-      if (session && (record2.version !== 2 || (await decryptValue(record2.encrypted_session, await this.keyring())).needsRotation)) {
+      if (session && (record3.version !== 2 || (await decryptValue(record3.encrypted_session, await this.keyring())).needsRotation)) {
         await this.writeSession(storage, session);
       }
       return session;
@@ -30312,14 +30729,14 @@ function normalizeOrigin(value) {
   }
 }
 function isSessionCandidate(value) {
-  if (!isRecord9(value)) return false;
+  if (!isRecord10(value)) return false;
   return typeof value.moodleOrigin === "string" && typeof value.cookieName === "string" && /^MoodleSession[A-Za-z0-9_-]*$/.test(value.cookieName) && typeof value.cookieValue === "string" && value.cookieValue.length > 0 && value.cookieValue.length <= 4096 && !/[\u0000-\u001f\u007f;]/.test(value.cookieValue) && (value.expectedRevision === null || Number.isInteger(value.expectedRevision) && value.expectedRevision >= 0);
 }
-function isRecord9(value) {
+function isRecord10(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function isMcpEnvelope(value) {
-  if (!isRecord9(value) || !("request" in value) || !isRecord9(value.context)) return false;
+  if (!isRecord10(value) || !("request" in value) || !isRecord10(value.context)) return false;
   return (value.context.protocolVersion === void 0 || typeof value.context.protocolVersion === "string") && (value.context.method === void 0 || typeof value.context.method === "string") && (value.context.toolName === void 0 || typeof value.context.toolName === "string");
 }