dsh-aha-tutor 1.3.0 → 1.4.0

package/lib/index.js

@@ -1,4 +1,4 @@
-import { $ as courseProgress, A as streamCounter, B as documentParts, C as reworkPrompt, D as generateJson, E as TutorError, F as materialsSummary, G as createConceptState, H as passageRange, I as passagesFor, J as extractJson, K as masteryPercent, L as readMaterials, M as emptyProgress, N as masteryFor, O as generateSteps, P as materialImages, Q as conceptIndex, R as readProfile, S as revisePrompt, T as summaryPrompt, U as spreadPassages, V as formatPassages, W as applyEvidence, X as normalizeBoard, Y as boardToPlainText, Z as blueprintOutline, _ as projectReviewPrompt, _t as newId, a as blueprintPrompt, at as nextLesson, b as quizPrompt, c as detectLanguage, ct as normalizeCheatsheet, d as flashcardsPrompt, dt as normalizeProject, et as findLesson, f as gradePrompt, ft as normalizeQuestionnaire, g as profilePrompt, gt as assertId, h as practicePrompt, ht as text, i as assistPrompt, it as lessonAfter, j as EMPTY_PROFILE, k as generateText, l as digestPartPrompt, lt as normalizeLesson, m as materialBriefPrompt, mt as safeRelativePath, n as publishRuntime, nt as insertLesson, o as cheatsheetPrompt, ot as normalizeBlueprint, p as lessonPrompt, pt as outlineForPrompt, q as recommendNext, r as askPrompt, rt as intakeSummary, s as correctionPrompt, st as normalizeCards, tt as flattenLessons, u as digestPrompt, ut as normalizePractice, v as projectsPrompt, w as shortPrompt, x as reexplainPrompt, y as questionnairePrompt, z as readProgress } from "./runtime-BCGFUDlg.js";
+import { $ as conceptIndex, A as generateText, B as readProgress, C as revisePrompt, D as TutorError, E as summaryPrompt, F as materialImages, G as applyEvidence, H as formatPassages, I as materialsSummary, J as recommendNext, K as createConceptState, L as passagesFor, M as EMPTY_PROFILE, N as emptyProgress, O as generateJson, P as masteryFor, Q as blueprintOutline, R as readMaterials, S as researchQueriesPrompt, T as shortPrompt, U as passageRange, V as documentParts, W as spreadPassages, X as boardToPlainText, Y as extractJson, Z as normalizeBoard, _ as projectReviewPrompt, _t as assertId, a as blueprintPrompt, at as lessonAfter, b as quizPrompt, c as detectLanguage, ct as normalizeCards, d as flashcardsPrompt, dt as normalizePractice, et as courseProgress, f as gradePrompt, ft as normalizeProject, g as profilePrompt, gt as text, h as practicePrompt, ht as safeRelativePath, i as assistPrompt, it as intakeSummary, j as streamCounter, k as generateSteps, l as digestPartPrompt, lt as normalizeCheatsheet, m as materialBriefPrompt, mt as outlineForPrompt, n as publishRuntime, nt as flattenLessons, o as cheatsheetPrompt, ot as nextLesson, p as lessonPrompt, pt as normalizeQuestionnaire, q as masteryPercent, r as askPrompt, rt as insertLesson, s as correctionPrompt, st as normalizeBlueprint, tt as findLesson, u as digestPrompt, ut as normalizeLesson, v as projectsPrompt, vt as newId, w as reworkPrompt, x as reexplainPrompt, y as questionnairePrompt, z as readProfile } from "./runtime-DqCjJ0yL.js";
 import { createRequire } from "node:module";
 import { dirname, join, relative, sep } from "node:path";
 import { credentialKey } from "@deepseek-ai/dsh-credentials";
@@ -46,17 +46,20 @@ function exportCoursePack({ course, progress, boards = {}, practice = {}, sheets
 function parseCoursePack(input) {
 	let pack = input;
 	if (typeof input === "string") {
-		if (input.length > 8388608) throw new Error("course pack is too large");
+		if (input.length > 8388608) throw packError("pack-too-large", "course pack is too large");
 		try {
 			pack = JSON.parse(input);
 		} catch {
-			throw new Error("course pack is not valid JSON");
+			throw packError("bad-pack", "course pack is not valid JSON");
 		}
 	}
-	if (pack?.format !== "aha-tutor.coursepack") throw new Error("not a course pack");
-	if (!Number.isInteger(pack.version) || pack.version > 1) throw new Error("course pack was made by a newer version of the plugin");
+	if (pack?.format !== "aha-tutor.coursepack") throw packError("bad-pack", "not a course pack");
+	if (!Number.isInteger(pack.version) || pack.version > 1) throw packError("pack-too-new", "course pack was made by a newer version of the plugin");
 	return pack;
 }
+function packError(code, message) {
+	return Object.assign(new Error(message), { code });
+}
 function importCoursePack(input, { now = /* @__PURE__ */ new Date() } = {}) {
 	const pack = parseCoursePack(input);
 	const blueprint = normalizeBlueprint(stripIds(pack.course), { language: pack.course?.language });
@@ -236,7 +239,7 @@ function outlineStream(api) {
 		counter(delta);
 	};
 }
-function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date() }) {
+function createCourses({ store, llm, jobs, research, now = () => /* @__PURE__ */ new Date() }) {
 	const stamp = () => now().toISOString();
 	async function readCourse(courseId) {
 		const course = await store.readJson(store.paths.course(assertId(courseId, "crs")), null);
@@ -309,9 +312,9 @@ function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date(
 			}
 		};
 	}
-	function startCraft({ goal, materialIds = [], quick = false, language }) {
+	function startCraft({ goal, materialIds = [], quick = false, language, web = false }) {
 		const cleanGoal = text(goal, 2e3);
-		if (!cleanGoal && !materialIds.length) throw new TutorError("invalid", "Tell me what you want to learn");
+		if (!cleanGoal && !materialIds.length) throw new TutorError("empty-goal", "Tell me what you want to learn");
 		const ids = materialIds.filter((id) => /^mat_[a-z0-9]+$/u.test(id)).slice(0, 8);
 		const courseId = newId("crs");
 		return jobs.start("craft/start", async (api) => {
@@ -327,10 +330,29 @@ function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date(
 				createdAt: stamp()
 			};
 			await saveCourse(draft);
-			if (quick) return {
-				courseId,
-				questionnaire: null
-			};
+			let found = null;
+			if (web && research) {
+				api.progress(0, quick ? 1 : 2, "research");
+				found = await research.run({
+					goal: draft.goal,
+					language: draft.language,
+					signal: api.signal
+				});
+				api.progress(0, quick ? 1 : 2, "questions");
+			}
+			if (quick) {
+				if (found) await store.writeJson(store.paths.intake(courseId), {
+					questionnaire: null,
+					answers: {},
+					research: found,
+					at: stamp()
+				});
+				return {
+					courseId,
+					questionnaire: null,
+					research: found
+				};
+			}
 			const profile = await readProfile(store);
 			const questionnaire = await generateJson(llm, {
 				purpose: "teach",
@@ -338,7 +360,8 @@ function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date(
 					goal: draft.goal,
 					language: draft.language,
 					materialsSummary: materialsSummary(materials),
-					profile
+					profile,
+					sources: found?.sources
 				}),
 				maxTokens: 3e3,
 				signal: api.signal,
@@ -351,12 +374,14 @@ function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date(
 			await store.writeJson(store.paths.intake(courseId), {
 				questionnaire,
 				answers: {},
+				...found ? { research: found } : {},
 				at: stamp()
 			});
 			api.progress(1, 2, "questions");
 			return {
 				courseId,
-				questionnaire
+				questionnaire,
+				research: found
 			};
 		}, {
 			key: `questions:${courseId}`,
@@ -397,7 +422,8 @@ function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date(
 					profile,
 					timeline: settings.timeline,
 					size: settings.size,
-					weeklyMinutes: settings.weeklyMinutes
+					weeklyMinutes: settings.weeklyMinutes,
+					sources: intake.research?.sources
 				}),
 				images: llm.supportsImages?.("teach") ? await materialImages(store, materials) : void 0,
 				maxTokens: 16e3,
@@ -405,12 +431,14 @@ function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date(
 				onText: outlineStream(api),
 				normalize: (raw) => attachProjectUnits(raw, normalizeBlueprint(raw, { language: course.language }))
 			});
+			const sources = intake.research?.sources ?? [];
 			const next = {
 				...course,
 				...blueprint,
 				language: course.language,
 				status: "blueprint",
-				settings
+				settings,
+				...sources.length ? { sources } : {}
 			};
 			await saveCourse(next);
 			return { course: next };
@@ -421,10 +449,10 @@ function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date(
 	}
 	function revise({ courseId, instruction }) {
 		const request = text(instruction, 1500);
-		if (!request) throw new TutorError("invalid", "Describe the change you want");
+		if (!request) throw new TutorError("empty-change", "Describe the change you want");
 		return jobs.start("craft/revise", async (api) => {
 			const course = await readCourse(courseId);
-			if (!course.units) throw new TutorError("invalid", "There is no blueprint to revise yet");
+			if (!course.units) throw new TutorError("no-blueprint", "There is no blueprint to revise yet");
 			const current = {
 				title: course.title,
 				subtitle: course.subtitle,
@@ -465,7 +493,7 @@ function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date(
 	async function applyProposal({ courseId }) {
 		const course = await readCourse(courseId);
 		const proposal = await store.readJson(store.paths.proposal(courseId), null);
-		if (!proposal?.blueprint?.units) throw new TutorError("not-found", "There is no proposed change");
+		if (!proposal?.blueprint?.units) throw new TutorError("no-proposal", "There is no proposed change");
 		const next = {
 			...course,
 			...proposal.blueprint,
@@ -569,7 +597,7 @@ function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date(
 	function confirm({ courseId }) {
 		return jobs.start("craft/confirm", async (api) => {
 			const course = await readCourse(courseId);
-			if (!course.units) throw new TutorError("invalid", "Generate a blueprint first");
+			if (!course.units) throw new TutorError("no-blueprint", "Generate a blueprint first");
 			const lectures = course.units.slice(0, 1).flatMap((unit) => unit.lectures.map((lecture) => ({
 				unit,
 				lecture
@@ -699,7 +727,17 @@ function createCourses({ store, llm, jobs, now = () => /* @__PURE__ */ new Date(
 		};
 	}
 	async function importPack({ json }) {
-		const imported = importCoursePack(json);
+		let imported;
+		try {
+			imported = importCoursePack(json);
+		} catch (error) {
+			const known = [
+				"bad-pack",
+				"pack-too-large",
+				"pack-too-new"
+			].includes(error?.code);
+			throw new TutorError(known ? error.code : "bad-pack", known ? error.message : "not a course pack");
+		}
 		const { course } = imported;
 		await saveCourse(course);
 		for (const [lessonId, board] of Object.entries(imported.boards)) await store.writeJson(store.paths.board(course.id, lessonId), board);
@@ -830,6 +868,150 @@ const BOARD_FONT_FILES = Object.freeze([
 	})
 ]);
 //#endregion
+//#region src/host/jobs.js
+const KEEP_FINISHED_MS = 10 * 6e4;
+const MAX_JOBS = 200;
+function createJobs({ logger, now = Date.now } = {}) {
+	const jobs = /* @__PURE__ */ new Map();
+	const byKey = /* @__PURE__ */ new Map();
+	function sweep() {
+		const cutoff = now() - KEEP_FINISHED_MS;
+		for (const [id, job] of jobs) if (job.finishedAt && job.finishedAt < cutoff) {
+			jobs.delete(id);
+			if (job.key && byKey.get(job.key) === id) byKey.delete(job.key);
+		}
+		if (jobs.size > MAX_JOBS) {
+			const finished = [...jobs.values()].filter((job) => job.finishedAt).sort((a, b) => a.finishedAt - b.finishedAt);
+			for (const job of finished.slice(0, jobs.size - MAX_JOBS)) jobs.delete(job.id);
+		}
+	}
+	function start(kind, run, { key, meta } = {}) {
+		sweep();
+		if (key && byKey.has(key)) {
+			const existing = jobs.get(byKey.get(key));
+			if (existing && !existing.finishedAt && !existing.controller.signal.aborted) return snapshot(existing);
+		}
+		const controller = new AbortController();
+		const job = {
+			id: newId("job"),
+			kind,
+			key: key ?? null,
+			meta: meta ?? {},
+			status: "running",
+			progress: {
+				done: 0,
+				total: 0,
+				label: ""
+			},
+			partial: [],
+			preview: null,
+			result: void 0,
+			error: void 0,
+			startedAt: now(),
+			finishedAt: null,
+			controller
+		};
+		jobs.set(job.id, job);
+		if (key) byKey.set(key, job.id);
+		const api = {
+			signal: controller.signal,
+			progress(done, total, label = job.progress.label) {
+				job.progress = {
+					done,
+					total,
+					label
+				};
+			},
+			push(item) {
+				job.partial.push(item);
+			},
+			preview(value) {
+				job.preview = value ?? null;
+			}
+		};
+		const aborted = new Promise((_, reject) => {
+			controller.signal.addEventListener("abort", () => reject(controller.signal.reason ?? /* @__PURE__ */ new Error("cancelled")), { once: true });
+		});
+		Promise.race([Promise.resolve().then(() => run(api)), aborted]).then((result) => {
+			job.status = "done";
+			job.result = result;
+		}).catch((error) => {
+			job.status = controller.signal.aborted ? "cancelled" : "failed";
+			job.error = controller.signal.aborted ? {
+				code: "cancelled",
+				message: "Cancelled"
+			} : {
+				code: publicCode(error),
+				message: publicMessage(error)
+			};
+			if (job.status === "failed") logger?.warn?.("aha-tutor job %s failed: %s", kind, error?.message);
+		}).finally(() => {
+			job.finishedAt = now();
+		});
+		return snapshot(job);
+	}
+	function snapshot(job, { since = 0 } = {}) {
+		return {
+			id: job.id,
+			kind: job.kind,
+			meta: job.meta,
+			status: job.status,
+			progress: job.progress,
+			partial: job.partial.slice(since),
+			partialCount: job.partial.length,
+			preview: job.preview ?? void 0,
+			elapsedMs: (job.finishedAt ?? now()) - job.startedAt,
+			result: job.status === "done" ? job.result : void 0,
+			error: job.error
+		};
+	}
+	function get(id, options) {
+		const job = jobs.get(id);
+		return job ? snapshot(job, options) : null;
+	}
+	function cancel(id) {
+		const job = jobs.get(id);
+		if (job && !job.finishedAt) job.controller.abort(/* @__PURE__ */ new Error("cancelled"));
+		return job ? snapshot(job) : null;
+	}
+	function running(key) {
+		const id = byKey.get(key);
+		const job = id ? jobs.get(id) : void 0;
+		return job && !job.finishedAt && !job.controller.signal.aborted ? snapshot(job) : null;
+	}
+	function cancelKey(key) {
+		const job = running(key);
+		return job ? cancel(job.id) : null;
+	}
+	function dispose() {
+		for (const job of jobs.values()) if (!job.finishedAt) job.controller.abort(/* @__PURE__ */ new Error("plugin stopped"));
+		jobs.clear();
+		byKey.clear();
+	}
+	return Object.freeze({
+		start,
+		get,
+		cancel,
+		cancelKey,
+		running,
+		dispose
+	});
+}
+function publicMessage(error) {
+	if (error?.userMessage) return String(error.userMessage);
+	if (USER_ERRORS$1.includes(error?.name)) return String(error.message);
+	return "Generation failed";
+}
+function publicCode(error) {
+	if (!USER_ERRORS$1.includes(error?.name)) return "failed";
+	return error.name === "TtsError" ? `tts-${error.code ?? "failed"}` : error.code ?? "failed";
+}
+const USER_ERRORS$1 = [
+	"MaterialError",
+	"TtsError",
+	"TutorError"
+];
+//#endregion
 //#region src/host/web-fetch.js
 const LOCAL_ADDRESS_MESSAGE = "Local network addresses are not supported";
 var AddressError = class extends Error {
@@ -1096,7 +1278,7 @@ function detectKind(name, bytes) {
 	if (head[0] === 137 && head[1] === 80) return "image";
 	if (head[0] === 255 && head[1] === 216) return "image";
 	if (head.subarray(0, 2).toString("latin1") === "PK") {
-		if (lower.endsWith(".doc") || lower.endsWith(".ppt")) throw new MaterialError("unsupported", "Old .doc/.ppt files are not supported; save as .docx/.pptx");
+		if (lower.endsWith(".doc") || lower.endsWith(".ppt")) throw new MaterialError("old-office", "Old .doc/.ppt files are not supported; save as .docx/.pptx");
 	}
 	throw new MaterialError("unsupported", "This file type is not supported");
 }
@@ -1350,7 +1532,7 @@ function extractPlain(bytes, kind) {
 			chunks.push(...chunkText(part, heading ? { section: heading.slice(0, 80) } : {}));
 		}
 	} else chunks.push(...chunkText(value, {}));
-	if (!chunks.length) throw new MaterialError("no-text", "This file is empty");
+	if (!chunks.length) throw new MaterialError("empty", "This file is empty");
 	return {
 		title: kind === "markdown" ? /^#\s+(.+)$/mu.exec(value)?.[1]?.trim() ?? "" : "",
 		chunks
@@ -1362,7 +1544,7 @@ async function ingestFile({ name, bytes, signal }) {
 	const kind = detectKind(name, bytes);
 	const baseTitle = String(name ?? "").replace(/\.[^.]+$/u, "").slice(0, 120) || "Untitled";
 	if (kind === "image") {
-		if (bytes.length > 10485760) throw new MaterialError("too-large", "Images must be smaller than 10 MB");
+		if (bytes.length > 10485760) throw new MaterialError("image-too-large", "Images must be smaller than 10 MB");
 		return {
 			kind,
 			title: baseTitle,
@@ -1417,7 +1599,7 @@ async function ingestUrl(address, { fetchImpl = pageFetch, signal } = {}) {
 		} catch (error) {
 			if (signal?.aborted) throw signal.reason ?? error;
 			if (error?.name === "AddressError") throw new MaterialError("bad-url", error.message);
-			if (error?.code === "ETOOLARGE") throw new MaterialError("too-large", "The page is too large");
+			if (error?.code === "ETOOLARGE") throw new MaterialError("page-too-large", "The page is too large");
 			throw new MaterialError("network", timeout.aborted ? "The page took too long to load" : "The page could not be loaded");
 		}
 		if (response.status >= 300 && response.status < 400 && response.headers.get("location")) {
@@ -1429,7 +1611,7 @@ async function ingestUrl(address, { fetchImpl = pageFetch, signal } = {}) {
 	if (!response?.ok) throw new MaterialError("http", `The page returned an error (${response?.status ?? "redirect loop"})`);
 	const type = String(response.headers.get("content-type") ?? "").toLowerCase();
 	const bytes = Buffer.from(await response.arrayBuffer());
-	if (bytes.length > MAX_PAGE_BYTES && !type.includes("pdf")) throw new MaterialError("too-large", "The page is too large");
+	if (bytes.length > MAX_PAGE_BYTES && !type.includes("pdf")) throw new MaterialError("page-too-large", "The page is too large");
 	if (type.includes("application/pdf") || bytes.subarray(0, 5).toString("latin1") === "%PDF-") return {
 		...await ingestFile({
 			name: `${url.pathname.split("/").pop() || "page"}.pdf`,
@@ -1455,7 +1637,7 @@ async function ingestUrl(address, { fetchImpl = pageFetch, signal } = {}) {
 	}
 	const title = String(article?.title || document.querySelector("title")?.textContent || url.hostname).trim().slice(0, 160);
 	const chunks = chunkText(article?.textContent || document.body?.textContent || "", { section: url.hostname });
-	if (!chunks.length) throw new MaterialError("no-text", "No readable text on this page");
+	if (!chunks.length) throw new MaterialError("page-no-text", "No readable text on this page");
 	return finish("url", title, chunks, { url: url.href });
 }
 //#endregion
@@ -1510,7 +1692,7 @@ function uploadRoute({ studio }) {
 					}) }
 				});
 			} catch (error) {
-				return failure$1(error?.code ?? "failed", error?.name === "TutorError" ? error.message : "Upload failed", 400);
+				return failure$1(publicCode(error), error?.name === "TutorError" ? error.message : "Upload failed", 400);
 			}
 		}
 	};
@@ -1541,7 +1723,7 @@ function ttsRoute({ speak }) {
 				});
 			} catch (error) {
 				const known = error?.name === "TtsError" || error?.name === "TutorError";
-				return failure$1(error?.code ?? "tts", known ? error.message : "Speech synthesis failed", error?.code === "auth" ? 401 : 502);
+				return failure$1(known ? publicCode(error) : "tts-failed", known ? error.message : "Speech synthesis failed", ["auth", "no-key"].includes(error?.code) ? 401 : 502);
 			}
 		}
 	};
@@ -1575,144 +1757,6 @@ function fontRoute({ dir = fontsDir() } = {}) {
 	};
 }
 //#endregion
-//#region src/host/jobs.js
-const KEEP_FINISHED_MS = 10 * 6e4;
-const MAX_JOBS = 200;
-function createJobs({ logger, now = Date.now } = {}) {
-	const jobs = /* @__PURE__ */ new Map();
-	const byKey = /* @__PURE__ */ new Map();
-	function sweep() {
-		const cutoff = now() - KEEP_FINISHED_MS;
-		for (const [id, job] of jobs) if (job.finishedAt && job.finishedAt < cutoff) {
-			jobs.delete(id);
-			if (job.key && byKey.get(job.key) === id) byKey.delete(job.key);
-		}
-		if (jobs.size > MAX_JOBS) {
-			const finished = [...jobs.values()].filter((job) => job.finishedAt).sort((a, b) => a.finishedAt - b.finishedAt);
-			for (const job of finished.slice(0, jobs.size - MAX_JOBS)) jobs.delete(job.id);
-		}
-	}
-	function start(kind, run, { key, meta } = {}) {
-		sweep();
-		if (key && byKey.has(key)) {
-			const existing = jobs.get(byKey.get(key));
-			if (existing && !existing.finishedAt && !existing.controller.signal.aborted) return snapshot(existing);
-		}
-		const controller = new AbortController();
-		const job = {
-			id: newId("job"),
-			kind,
-			key: key ?? null,
-			meta: meta ?? {},
-			status: "running",
-			progress: {
-				done: 0,
-				total: 0,
-				label: ""
-			},
-			partial: [],
-			preview: null,
-			result: void 0,
-			error: void 0,
-			startedAt: now(),
-			finishedAt: null,
-			controller
-		};
-		jobs.set(job.id, job);
-		if (key) byKey.set(key, job.id);
-		const api = {
-			signal: controller.signal,
-			progress(done, total, label = job.progress.label) {
-				job.progress = {
-					done,
-					total,
-					label
-				};
-			},
-			push(item) {
-				job.partial.push(item);
-			},
-			preview(value) {
-				job.preview = value ?? null;
-			}
-		};
-		const aborted = new Promise((_, reject) => {
-			controller.signal.addEventListener("abort", () => reject(controller.signal.reason ?? /* @__PURE__ */ new Error("cancelled")), { once: true });
-		});
-		Promise.race([Promise.resolve().then(() => run(api)), aborted]).then((result) => {
-			job.status = "done";
-			job.result = result;
-		}).catch((error) => {
-			job.status = controller.signal.aborted ? "cancelled" : "failed";
-			job.error = controller.signal.aborted ? {
-				code: "cancelled",
-				message: "Cancelled"
-			} : {
-				code: error?.code ?? "failed",
-				message: publicMessage(error)
-			};
-			if (job.status === "failed") logger?.warn?.("aha-tutor job %s failed: %s", kind, error?.message);
-		}).finally(() => {
-			job.finishedAt = now();
-		});
-		return snapshot(job);
-	}
-	function snapshot(job, { since = 0 } = {}) {
-		return {
-			id: job.id,
-			kind: job.kind,
-			meta: job.meta,
-			status: job.status,
-			progress: job.progress,
-			partial: job.partial.slice(since),
-			partialCount: job.partial.length,
-			preview: job.preview ?? void 0,
-			result: job.status === "done" ? job.result : void 0,
-			error: job.error
-		};
-	}
-	function get(id, options) {
-		const job = jobs.get(id);
-		return job ? snapshot(job, options) : null;
-	}
-	function cancel(id) {
-		const job = jobs.get(id);
-		if (job && !job.finishedAt) job.controller.abort(/* @__PURE__ */ new Error("cancelled"));
-		return job ? snapshot(job) : null;
-	}
-	function running(key) {
-		const id = byKey.get(key);
-		const job = id ? jobs.get(id) : void 0;
-		return job && !job.finishedAt && !job.controller.signal.aborted ? snapshot(job) : null;
-	}
-	function cancelKey(key) {
-		const job = running(key);
-		return job ? cancel(job.id) : null;
-	}
-	function dispose() {
-		for (const job of jobs.values()) if (!job.finishedAt) job.controller.abort(/* @__PURE__ */ new Error("plugin stopped"));
-		jobs.clear();
-		byKey.clear();
-	}
-	return Object.freeze({
-		start,
-		get,
-		cancel,
-		cancelKey,
-		running,
-		dispose
-	});
-}
-function publicMessage(error) {
-	if (error?.userMessage) return String(error.userMessage);
-	if ([
-		"MaterialError",
-		"TtsError",
-		"TutorError"
-	].includes(error?.name)) return String(error.message);
-	return "Generation failed";
-}
-//#endregion
 //#region src/core/planner.js
 const DAY_MS$1 = 1440 * 60 * 1e3;
 const HORIZON_DAYS = 400;
@@ -1756,7 +1800,7 @@ function clampNumber(value, min, max, fallback) {
 	if (!Number.isFinite(number)) return fallback;
 	return Math.min(max, Math.max(min, number));
 }
-function buildPlan({ today, settings, courses = [], reviews = [], exams = [] }) {
+function buildPlan({ today, settings, courses = [], reviews = [], exams = [], spentToday = 0 }) {
 	const start = today ?? toDay(/* @__PURE__ */ new Date());
 	const { studyDays, weeklyMinutes, dailyMinutes } = normalizeSettings(settings);
 	const queues = courses.map((course) => ({
@@ -1790,8 +1834,9 @@ function buildPlan({ today, settings, courses = [], reviews = [], exams = [] })
 			minutes: 0
 		}));
 		if (studyDays.includes(weekday)) {
-			let budget = dailyMinutes;
-			const reviewBudget = Math.round(dailyMinutes * REVIEW_SHARE);
+			const spent = offset === 0 ? Math.max(0, Number(spentToday) || 0) : 0;
+			let budget = dailyMinutes - spent;
+			const reviewBudget = Math.min(Math.max(0, budget), Math.round(dailyMinutes * REVIEW_SHARE));
 			let reviewUsed = 0;
 			while (pendingReviews.length && pendingReviews[0].dueDay <= day && reviewUsed + pendingReviews[0].minutes <= reviewBudget) {
 				const review = pendingReviews.shift();
@@ -1801,6 +1846,8 @@ function buildPlan({ today, settings, courses = [], reviews = [], exams = [] })
 					refId: review.id,
 					courseId: review.courseId ?? null,
 					title: review.title,
+					courseTitle: review.courseTitle ?? "",
+					courseEmoji: review.courseEmoji ?? "",
 					minutes: review.minutes
 				});
 			}
@@ -1813,7 +1860,7 @@ function buildPlan({ today, settings, courses = [], reviews = [], exams = [] })
 				for (const queue of ordered) {
 					const lesson = queue.remaining[0];
 					if (!lesson) continue;
-					const dayIsEmpty = !items.some((item) => item.kind === "lesson");
+					const dayIsEmpty = !spent && !items.some((item) => item.kind === "lesson");
 					if (lesson.minutes <= budget || dayIsEmpty) {
 						queue.remaining.shift();
 						budget -= lesson.minutes;
@@ -1899,9 +1946,61 @@ function neededWeeklyMinutes(course, start, deadline, studyDays) {
 	const perDay = remaining / studyDayCount / (1 - REVIEW_SHARE);
 	return Math.ceil(perDay * studyDays.length / 10) * 10;
 }
+const itemKey = (item) => `${item.kind}:${item.refId}`;
+function mergeAgenda(saved = [], planned = []) {
+	const seen = new Set(saved.map(itemKey));
+	return [...saved, ...planned.filter((item) => !seen.has(itemKey(item)))];
+}
+function planCalendar({ today, agenda = {}, plan, done = {}, checks = [], ahead = 120 }) {
+	const lessonsDone = done.lessons ?? /* @__PURE__ */ new Map();
+	const reviewsDone = done.reviews ?? /* @__PURE__ */ new Map();
+	const last = addDays(today, ahead);
+	const days = /* @__PURE__ */ new Map();
+	const put = (day, item) => {
+		const list = days.get(day) ?? [];
+		if (!list.some((entry) => itemKey(entry) === itemKey(item))) list.push(item);
+		days.set(day, list);
+	};
+	for (const [day, items] of Object.entries(agenda)) if (day <= today) for (const item of items) put(day, item);
+	for (const entry of plan?.days ?? []) if (entry.day >= today && entry.day <= last) for (const item of entry.items) put(entry.day, item);
+	for (const { day, item } of lessonsDone.values()) if (day <= today) put(day, item);
+	for (const check of checks) if (check.day <= today && check.item) put(check.day, check.item);
+	const status = (item, day) => {
+		if (day > today || item.kind === "exam") return false;
+		if (checks.some((check) => check.refId === item.refId && check.day === day)) return "manual";
+		if (item.kind === "lesson" && lessonsDone.get(item.refId)?.day === day) return "auto";
+		if (item.kind === "review" && reviewsDone.get(item.refId) === day) return "auto";
+		return false;
+	};
+	const out = [...days.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([day, items]) => ({
+		day,
+		items: items.map((item) => ({
+			...item,
+			checked: status(item, day)
+		}))
+	}));
+	return {
+		today: out.find((entry) => entry.day === today)?.items ?? [],
+		days: out
+	};
+}
 //#endregion
 //#region src/host/learner.js
 const PROFILE_REFRESH_MS = 10 * 6e4;
+function agendaItem(raw) {
+	const kind = raw?.kind === "lesson" || raw?.kind === "review" ? raw.kind : null;
+	const refId = text(raw?.refId, 80);
+	if (!kind || !refId) return null;
+	return {
+		kind,
+		refId,
+		courseId: /^crs_[a-z0-9]{6,40}$/u.test(String(raw.courseId)) ? raw.courseId : null,
+		title: text(raw.title, 160),
+		courseTitle: text(raw.courseTitle, 160),
+		courseEmoji: text(raw.courseEmoji, 8),
+		minutes: Math.min(240, Math.max(0, Math.round(Number(raw.minutes) || 0)))
+	};
+}
 function createLearner({ store, llm, now = () => /* @__PURE__ */ new Date(), logger }) {
 	let lastRefresh = 0;
 	let refreshing = null;
@@ -1991,9 +2090,12 @@ function createLearner({ store, llm, now = () => /* @__PURE__ */ new Date(), log
 					0
 				]
 			},
-			exams: Array.isArray(plan.exams) ? plan.exams : []
+			exams: Array.isArray(plan.exams) ? plan.exams : [],
+			checks: Array.isArray(plan.checks) ? plan.checks : [],
+			agenda: plan.agenda && typeof plan.agenda === "object" ? plan.agenda : {}
 		};
 	}
+	const validDay = (value) => /^\d{4}-\d{2}-\d{2}$/u.test(String(value ?? "")) ? value : null;
 	async function activeCourses() {
 		const ids = await store.listIds(store.paths.courses(), "crs");
 		const result = [];
@@ -2009,25 +2111,56 @@ function createLearner({ store, llm, now = () => /* @__PURE__ */ new Date(), log
 	}
 	async function plan({ today } = {}) {
 		const file = await readPlanFile();
-		const day = /^\d{4}-\d{2}-\d{2}$/u.test(String(today ?? "")) ? today : toDay(now());
+		const day = validDay(today) ?? toDay(now());
 		const active = await activeCourses();
+		const tickedLessons = new Set(file.checks.filter((check) => check.kind === "lesson" && check.day <= day).map((check) => check.refId));
+		const tickedToday = new Set(file.checks.filter((check) => check.day === day).map((check) => check.refId));
 		const reviews = [];
+		const done = {
+			lessons: /* @__PURE__ */ new Map(),
+			reviews: /* @__PURE__ */ new Map()
+		};
 		for (const { course, progress } of active) {
+			const label = {
+				courseId: course.id,
+				courseTitle: course.title,
+				courseEmoji: course.emoji ?? ""
+			};
 			const index = conceptIndex(course);
 			for (const [conceptId, card] of Object.entries(progress.reviews ?? {})) {
 				const concept = index.get(conceptId);
 				if (!concept) continue;
-				reviews.push({
-					id: `${course.id}:${conceptId}`,
-					courseId: course.id,
+				const id = `${course.id}:${conceptId}`;
+				if (card.lastReviewedAt) done.reviews.set(id, toDay(new Date(card.lastReviewedAt)));
+				if (!tickedToday.has(id)) reviews.push({
+					id,
+					...label,
 					title: concept.name,
 					dueDay: toDay(new Date(card.dueAt)),
 					minutes: 5
 				});
 			}
+			for (const { lesson } of flattenLessons(course)) {
+				const record = progress.lessons?.[lesson.id];
+				if (record?.status === "done" && record.completedAt) done.lessons.set(lesson.id, {
+					day: toDay(new Date(record.completedAt)),
+					item: {
+						kind: "lesson",
+						refId: lesson.id,
+						title: lesson.title,
+						minutes: lesson.estMinutes,
+						...label
+					}
+				});
+			}
 		}
+		const spent = /* @__PURE__ */ new Map();
+		for (const { day: doneDay, item } of done.lessons.values()) if (doneDay === day) spent.set(item.refId, item.minutes);
+		for (const item of file.agenda[day] ?? []) if (item.kind === "review" && (done.reviews.get(item.refId) === day || tickedToday.has(item.refId))) spent.set(item.refId, item.minutes);
+		for (const check of file.checks) if (check.day === day && check.item) spent.set(check.refId, check.item.minutes);
 		const built = buildPlan({
 			today: day,
+			spentToday: [...spent.values()].reduce((sum, minutes) => sum + (Number(minutes) || 0), 0),
 			settings: file.settings,
 			courses: active.map(({ course, progress }) => ({
 				id: course.id,
@@ -2038,7 +2171,7 @@ function createLearner({ store, llm, now = () => /* @__PURE__ */ new Date(), log
 					id: lesson.id,
 					title: lesson.title,
 					minutes: lesson.estMinutes,
-					done: progress.lessons?.[lesson.id]?.status === "done"
+					done: progress.lessons?.[lesson.id]?.status === "done" || tickedLessons.has(lesson.id)
 				}))
 			})),
 			reviews,
@@ -2049,13 +2182,57 @@ function createLearner({ store, llm, now = () => /* @__PURE__ */ new Date(), log
 				courseId: exam.courseId ?? null
 			}))
 		});
+		const planned = (built.days.find((entry) => entry.day === day)?.items ?? []).filter((item) => item.kind !== "exam").map(agendaItem);
+		const oldest = addDays(day, -180);
+		const merged = mergeAgenda(file.agenda[day] ?? [], planned).slice(0, 40);
+		let agenda = file.agenda;
+		if (JSON.stringify(merged) !== JSON.stringify(file.agenda[day] ?? []) || Object.keys(file.agenda).some((key) => key < oldest)) agenda = (await store.updateJson(store.paths.plan(), {}, (current) => {
+			const kept = Object.fromEntries(Object.entries(current.agenda ?? {}).filter(([key]) => validDay(key) && key >= oldest));
+			kept[day] = mergeAgenda(kept[day] ?? [], planned).slice(0, 40);
+			return {
+				...current,
+				agenda: kept
+			};
+		})).agenda;
+		const calendar = planCalendar({
+			today: day,
+			agenda,
+			plan: built,
+			done,
+			checks: file.checks
+		});
 		return {
 			settings: file.settings,
 			exams: file.exams,
 			plan: built,
-			today: built.days.find((entry) => entry.day === day)?.items ?? []
+			today: calendar.today,
+			calendar: calendar.days
 		};
 	}
+	async function check({ today, day, item }) {
+		const current = validDay(today) ?? toDay(now());
+		const when = validDay(day);
+		const entry = agendaItem(item ?? {});
+		if (!when || !entry || when > current) throw new TutorError("cannot-tick", "Only today or an earlier day can be ticked");
+		await store.updateJson(store.paths.plan(), {}, (current) => ({
+			...current,
+			checks: [...(current.checks ?? []).filter((existing) => !(existing.refId === entry.refId && existing.day === when)), {
+				refId: entry.refId,
+				kind: entry.kind,
+				day: when,
+				item: entry,
+				at: now().toISOString()
+			}].slice(-1e3)
+		}));
+		return plan({ today });
+	}
+	async function uncheck({ today, day, refId }) {
+		await store.updateJson(store.paths.plan(), {}, (current) => ({
+			...current,
+			checks: (current.checks ?? []).filter((existing) => !(existing.refId === refId && existing.day === day))
+		}));
+		return plan({ today });
+	}
 	async function savePlanSettings({ weeklyMinutes, studyDays }) {
 		await store.updateJson(store.paths.plan(), {}, (current) => ({
 			...current,
@@ -2068,7 +2245,7 @@ function createLearner({ store, llm, now = () => /* @__PURE__ */ new Date(), log
 	}
 	async function addExam({ title, day, courseId }) {
 		const name = text(title, 120);
-		if (!name || !/^\d{4}-\d{2}-\d{2}$/u.test(String(day))) throw new Error("Exam needs a title and a date");
+		if (!name || !/^\d{4}-\d{2}-\d{2}$/u.test(String(day))) throw new TutorError("exam-incomplete", "Exam needs a title and a date");
 		await store.updateJson(store.paths.plan(), {}, (current) => ({
 			...current,
 			exams: [...current.exams ?? [], {
@@ -2122,6 +2299,8 @@ function createLearner({ store, llm, now = () => /* @__PURE__ */ new Date(), log
 		removeNote,
 		noteLesson,
 		plan,
+		check,
+		uncheck,
 		savePlanSettings,
 		addExam,
 		removeExam,
@@ -2220,6 +2399,7 @@ function round2(value) {
 //#region src/host/lessons.js
 const EVENTS_KEPT = 200;
 const STEP_ID = /^s\d{1,4}$/u;
+const BOARD_JOBS = ["lesson/board", "lesson/prefetch"];
 function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__PURE__ */ new Date() }) {
 	const stamp = () => now().toISOString();
 	async function context(courseId, lessonId) {
@@ -2263,7 +2443,7 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 			mastery: Object.fromEntries(row.lesson.concepts.map((concept) => [concept.id, masteryPercent(progress.concepts?.[concept.id] ?? createConceptState(concept.id, concept.name))]))
 		};
 	}
-	async function buildBoard({ course, row, signal, onStep, directive, style }) {
+	async function buildBoard({ course, row, signal, onStep, onProgress, directive, style }) {
 		const progress = await readProgress(store, course.id);
 		const profile = await readProfile(store);
 		const materials = await readMaterials(store, course.materialIds ?? []);
@@ -2275,7 +2455,7 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 		const kindDirective = row.lesson.kind === "remedial" ? "remediate" : row.lesson.kind === "review" ? "review" : row.lesson.kind === "challenge" ? "challenge" : void 0;
 		return generateSteps(llm, {
 			purpose: "teach",
-			effort: "low",
+			effort: "lowest",
 			prompt: lessonPrompt({
 				course,
 				unit: row.unit,
@@ -2295,6 +2475,7 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 			signal,
 			conceptIds: row.lesson.concepts.map((concept) => concept.id),
 			onStep,
+			onProgress,
 			minSteps: 3
 		});
 	}
@@ -2319,6 +2500,7 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 				row,
 				signal: api.signal,
 				onStep: (step) => api.push(step),
+				onProgress: (info) => api.preview(info),
 				style: text(style, 300) || void 0
 			});
 			const saved = {
@@ -2351,7 +2533,8 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 					course,
 					row: next,
 					signal: api.signal,
-					onStep: (step) => api.push(step)
+					onStep: (step) => api.push(step),
+					onProgress: (info) => api.preview(info)
 				});
 				const saved = {
 					...board,
@@ -2371,10 +2554,18 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 			});
 		}).catch(() => void 0);
 	}
+	function followedJob(scope, kinds, meta) {
+		const job = scope?.jobId ? jobs.get(scope.jobId) : null;
+		return job && kinds.includes(job.kind) && Object.entries(meta).every(([key, value]) => job.meta?.[key] === value) ? job : null;
+	}
 	async function scopeBoard(scope) {
 		if (scope?.kind === "lesson") {
 			const { course, row } = await context(scope.courseId, scope.lessonId);
-			const board = await store.readJson(store.paths.board(course.id, row.lesson.id), null);
+			const writing = followedJob(scope, BOARD_JOBS, {
+				courseId: course.id,
+				lessonId: row.lesson.id
+			});
+			const board = writing ? { steps: writing.partial } : await store.readJson(store.paths.board(course.id, row.lesson.id), null);
 			return {
 				course,
 				lesson: row.lesson,
@@ -2383,18 +2574,20 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 			};
 		}
 		if (scope?.kind === "thread" || scope?.kind === "short") {
-			const kind = scope.kind === "thread" ? "assist" : "shorts";
-			const item = await store.readJson(store.paths.item(kind, scope.id), null);
-			if (!item) throw new TutorError("not-found", "Not found");
-			const board = scope.kind === "thread" ? item.turns?.[Math.max(0, Math.min(item.turns.length - 1, Number(scope.turn) || 0))]?.board : item.board;
+			const thread = scope.kind === "thread";
+			const writing = thread ? followedJob(scope, ["assist/turn"], { threadId: scope.id }) : followedJob(scope, ["short/make"], { id: scope.id });
+			const item = await store.readJson(store.paths.item(thread ? "assist" : "shorts", scope.id), null);
+			if (!item && !writing) throw new TutorError("not-found", "Not found");
+			const board = writing ? { steps: writing.partial } : thread ? item.turns?.[Math.max(0, Math.min(item.turns.length - 1, Number(scope.turn) || 0))]?.board : item.board;
+			const language = item?.language ?? detectLanguage((board?.steps ?? []).map((step) => step.say).join(" "));
 			return {
 				course: null,
 				lesson: {
-					title: item.title,
+					title: item?.title ?? writing.meta?.title ?? "",
 					objectives: []
 				},
 				board,
-				language: item.language
+				language
 			};
 		}
 		throw new TutorError("invalid", "Unknown board");
@@ -2412,7 +2605,7 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 	const anchorFor = (board, stepIndex, anchorStepId) => STEP_ID.test(String(anchorStepId)) ? anchorStepId : board?.steps?.[Math.max(0, Number(stepIndex) || 0)]?.id ?? "s1";
 	function ask({ scope, stepIndex = 0, question, anchorStepId }) {
 		const request = text(question, 1500);
-		if (!request) throw new TutorError("invalid", "Type your question");
+		if (!request) throw new TutorError("empty-question", "Type your question");
 		return jobs.start("lesson/ask", async (api) => {
 			const { course, lesson, board, language } = await scopeBoard(scope);
 			const profile = await readProfile(store);
@@ -2454,11 +2647,11 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 	function reexplain({ scope, stepIndex = 0, style = "example", anchorStepId }) {
 		return jobs.start("lesson/reexplain", async (api) => {
 			const { course, lesson, board, language } = await scopeBoard(scope);
-			if (!board?.steps?.length) throw new TutorError("invalid", "Nothing to re-explain yet");
+			if (!board?.steps?.length) throw new TutorError("no-board", "The board is not written yet. Try again once its first step is up.");
 			const index = Math.min(board.steps.length - 1, Math.max(0, Number(stepIndex) || 0));
 			const answer = await generateSteps(llm, {
 				purpose: "teach",
-				effort: "low",
+				effort: "lowest",
 				prompt: reexplainPrompt({
 					lesson,
 					language,
@@ -2943,12 +3136,22 @@ const REASONING_ROOM = Object.freeze({
 	off: 0,
 	none: 0,
 	minimal: 4e3,
-	low: 8e3,
+	low: 16e3,
 	medium: 16e3,
 	high: 24e3,
 	xhigh: 48e3,
 	max: 48e3
 });
+const EFFORT_ORDER = [
+	"off",
+	"none",
+	"minimal",
+	"low",
+	"medium",
+	"high",
+	"xhigh",
+	"max"
+];
 const STOPPED_AT_LIMIT = /* @__PURE__ */ new Set(["max-tokens", "length"]);
 const CALL_TIMEOUT_MS = 6 * 6e4;
 const MAX_RETRIES = 2;
@@ -2973,7 +3176,10 @@ function toTutorError(code, fallback) {
 }
 function pickEffort(efforts, wanted) {
 	if (!efforts?.length || !wanted) return void 0;
-	if (wanted === "lowest") return efforts[0].id;
+	if (wanted === "lowest") {
+		const rank = (effort) => EFFORT_ORDER.includes(effort.id) ? EFFORT_ORDER.indexOf(effort.id) : EFFORT_ORDER.length;
+		return efforts.reduce((lightest, effort) => rank(effort) < rank(lightest) ? effort : lightest).id;
+	}
 	return (efforts.find((effort) => effort.id === wanted) ?? efforts.find((effort) => effort.id !== "off" && effort.id !== "none") ?? efforts[0]).id;
 }
 function outputBudget(maxTokens, effort, model) {
@@ -3007,7 +3213,7 @@ function createLlmPort({ getLlm, getDefault, getAttachments, prefs, logger }) {
 			provider: selection.provider,
 			model: selection.model
 		};
-		throw new TutorError("llm-unavailable", "No model is configured in DSH yet.");
+		throw new TutorError("llm-missing", "No model is configured in DSH yet.");
 	}
 	async function modalities(purpose, signal) {
 		const llm = getLlm();
@@ -3041,9 +3247,9 @@ function createLlmPort({ getLlm, getDefault, getAttachments, prefs, logger }) {
 		}
 		return blocks;
 	}
-	async function attempt({ purpose, effort, system, user, images, maxTokens, signal, onText }) {
+	async function attempt({ purpose, effort, system, user, images, maxTokens, signal, onText, onReasoning }) {
 		const llm = getLlm();
-		if (!llm) throw new TutorError("llm-unavailable", "DSH has no model service in this profile.");
+		if (!llm) throw new TutorError("llm-missing", "DSH has no model service in this profile.");
 		const target = route(purpose);
 		const timeout = AbortSignal.timeout(CALL_TIMEOUT_MS);
 		const fused = signal ? AbortSignal.any([signal, timeout]) : timeout;
@@ -3079,7 +3285,8 @@ function createLlmPort({ getLlm, getDefault, getAttachments, prefs, logger }) {
 			})) if (chunk.type === "text-delta" && typeof chunk.text === "string") {
 				textValue += chunk.text;
 				onText?.(chunk.text);
-			} else if (chunk.type === "finish") finish = chunk.reason;
+			} else if (chunk.type === "reasoning-delta" && typeof chunk.text === "string") onReasoning?.(chunk.text);
+			else if (chunk.type === "finish") finish = chunk.reason;
 		} catch (error) {
 			if (signal?.aborted) throw signal.reason ?? error;
 			throw Object.assign(toTutorError(timeout.aborted ? "TIMEOUT" : error?.code, error?.message), {
@@ -3122,7 +3329,8 @@ function createLlmPort({ getLlm, getDefault, getAttachments, prefs, logger }) {
 	return Object.freeze({
 		complete: (options) => call({
 			...options,
-			onText: void 0
+			onText: void 0,
+			onReasoning: void 0
 		}),
 		stream: (options) => call(options),
 		route,
@@ -3782,7 +3990,7 @@ function createProjects({ store, llm, jobs, courses, projectsRoot = resolveProje
 				const content = await readWorkspace(folderOf(course, project));
 				if (content) parts.push(`Files in the project folder:\n${content}`);
 			}
-			if (!parts.length) throw new TutorError("invalid", "Nothing to review yet: write a note or work in the project folder first");
+			if (!parts.length) throw new TutorError("nothing-to-review", "Nothing to review yet: write a note or work in the project folder first");
 			const result = await generateJson(llm, {
 				purpose: "teach",
 				prompt: projectReviewPrompt({
@@ -3844,6 +4052,100 @@ function createProjects({ store, llm, jobs, courses, projectsRoot = resolveProje
 	});
 }
 //#endregion
+//#region src/host/research.js
+const MAX_QUERIES = 3;
+const RESULTS_PER_QUERY = 6;
+const MAX_SOURCES = 10;
+const UNAVAILABLE = /* @__PURE__ */ new Set([
+	"WEB_PROVIDER_UNAVAILABLE",
+	"WEB_PROVIDER_CONFIGURED_MISSING",
+	"WEB_PROVIDER_CONFIGURED_UNAVAILABLE",
+	"WEB_PROVIDER_AMBIGUOUS"
+]);
+function cleanQueries(raw, goal) {
+	const queries = [...new Set((Array.isArray(raw) ? raw : []).map((query) => text(query, 120)).filter(Boolean))].slice(0, MAX_QUERIES);
+	return queries.length ? queries : [text(goal, 120)].filter(Boolean);
+}
+function mergeSources(lists) {
+	const seen = /* @__PURE__ */ new Set();
+	const out = [];
+	const longest = Math.max(0, ...lists.map((list) => list.length));
+	for (let rank = 0; rank < longest && out.length < MAX_SOURCES; rank += 1) for (const list of lists) {
+		const source = list[rank];
+		const url = safeUrl(source?.url);
+		if (!url || seen.has(url) || out.length >= MAX_SOURCES) continue;
+		seen.add(url);
+		out.push({
+			url,
+			title: text(source.title, 200) || new URL(url).hostname,
+			snippet: text(source.snippet ?? source.text ?? source.excerpt, 400),
+			publishedAt: text(source.publishedAt ?? source.date, 40)
+		});
+	}
+	return out;
+}
+function safeUrl(value) {
+	const raw = text(value, 500);
+	if (!raw) return "";
+	try {
+		const url = new URL(raw);
+		return url.protocol === "https:" || url.protocol === "http:" ? url.href : "";
+	} catch {
+		return "";
+	}
+}
+function skipReason(error) {
+	const code = String(error?.code ?? "");
+	if (code === "WEB_PROVIDER_CREDENTIAL_MISSING") return "no-credential";
+	if (UNAVAILABLE.has(code)) return "unavailable";
+	return error ? "failed" : "empty";
+}
+function createResearch({ getWeb, llm, logger }) {
+	async function run({ goal, language, signal, onSearching }) {
+		const web = getWeb?.();
+		if (typeof web?.search !== "function") return {
+			skipped: "unavailable",
+			sources: []
+		};
+		let queries;
+		try {
+			queries = await generateJson(llm, {
+				purpose: "quick",
+				prompt: researchQueriesPrompt({
+					goal,
+					language
+				}),
+				maxTokens: 400,
+				signal,
+				normalize: (raw) => cleanQueries(raw?.queries, goal)
+			});
+		} catch (error) {
+			if (signal?.aborted) throw error;
+			queries = cleanQueries([], goal);
+		}
+		onSearching?.(queries);
+		const settled = await Promise.allSettled(queries.map((query) => web.search({
+			query,
+			maxResults: RESULTS_PER_QUERY
+		}, signal)));
+		signal?.throwIfAborted?.();
+		const failure = settled.find((result) => result.status === "rejected")?.reason;
+		if (failure) logger?.debug?.("aha-tutor web research: %s", failure?.code ?? failure?.message);
+		const sources = mergeSources(settled.filter((result) => result.status === "fulfilled").map((result) => result.value?.sources ?? []));
+		if (!sources.length) return {
+			skipped: skipReason(failure),
+			queries,
+			sources: []
+		};
+		return {
+			queries,
+			sources,
+			at: (/* @__PURE__ */ new Date()).toISOString()
+		};
+	}
+	return Object.freeze({ run });
+}
+//#endregion
 //#region src/host/rpc.js
 const ID = (prefix) => new RegExp(`^${prefix}_[a-z0-9]{6,40}$`, "u");
 const IDS = {
@@ -3873,19 +4175,24 @@ function idList(value, prefix, max = 8) {
 }
 function scopeOf(payload) {
 	const scope = payload?.scope ?? {};
+	const jobId = optional(scope, "jobId", "job");
+	const writing = jobId ? { jobId } : {};
 	if (scope.kind === "lesson") return {
 		kind: "lesson",
 		courseId: need(scope, "courseId", "crs"),
-		lessonId: need(scope, "lessonId", "les")
+		lessonId: need(scope, "lessonId", "les"),
+		...writing
 	};
 	if (scope.kind === "thread") return {
 		kind: "thread",
 		id: need(scope, "id", "thd"),
-		turn: Number(scope.turn) || 0
+		turn: Number(scope.turn) || 0,
+		...writing
 	};
 	if (scope.kind === "short") return {
 		kind: "short",
-		id: need(scope, "id", "sht")
+		id: need(scope, "id", "sht"),
+		...writing
 	};
 	throw new TutorError("invalid", "Invalid board scope");
 }
@@ -3919,6 +4226,7 @@ function createRoutes({ courses, lessons, learner, studio, projects, jobs, setti
 			goal: payload.goal,
 			materialIds: idList(payload.materialIds, "mat"),
 			quick: payload.quick === true,
+			web: payload.web === true,
 			language: typeof payload.language === "string" ? payload.language.slice(0, 12) : void 0
 		}) }),
 		"course/proposal-apply": (payload) => courses.applyProposal({ courseId: need(payload, "courseId", "crs") }),
@@ -4066,6 +4374,16 @@ function createRoutes({ courses, lessons, learner, studio, projects, jobs, setti
 		"profile/clear": () => learner.clearProfile(),
 		"profile/remove-note": (payload) => learner.removeNote({ id: need(payload, "id", "nte") }),
 		"plan/get": (payload) => learner.plan({ today: payload.today }),
+		"plan/check": (payload) => learner.check({
+			today: payload.today,
+			day: payload.day,
+			item: payload.item
+		}),
+		"plan/uncheck": (payload) => learner.uncheck({
+			today: payload.today,
+			day: String(payload.day ?? "").slice(0, 10),
+			refId: String(payload.refId ?? "").slice(0, 80)
+		}),
 		"plan/settings": (payload) => learner.savePlanSettings({
 			weeklyMinutes: payload.weeklyMinutes,
 			studyDays: payload.studyDays
@@ -4198,13 +4516,12 @@ function createRpcHandler(routes, { logger, checkPeer = isOwner } = {}) {
 			};
 		} catch (error) {
 			if (signal?.aborted) throw error;
-			const known = [
+			if (![
 				"TutorError",
 				"MaterialError",
 				"TtsError"
-			].includes(error?.name);
-			if (!known) logger?.warn?.("aha-tutor %s failed: %s", endpoint, error?.message);
-			return failure(known ? error.code ?? "failed" : "failed", known ? error.message : publicMessage(error));
+			].includes(error?.name)) logger?.warn?.("aha-tutor %s failed: %s", endpoint, error?.message);
+			return failure(publicCode(error), publicMessage(error));
 		}
 	};
 }
@@ -4364,15 +4681,15 @@ function checkEndpoint(value) {
 	try {
 		url = new URL(String(value));
 	} catch {
-		throw new TtsError("config", "TTS address is not a valid URL");
+		throw new TtsError("address", "TTS address is not a valid URL");
 	}
 	const local = [
 		"localhost",
 		"127.0.0.1",
 		"[::1]"
 	].includes(url.hostname);
-	if (url.protocol !== "https:" && !(url.protocol === "http:" && local)) throw new TtsError("config", "TTS address must use https (http only for localhost)");
-	if (url.username || url.password) throw new TtsError("config", "TTS address must not contain credentials");
+	if (url.protocol !== "https:" && !(url.protocol === "http:" && local)) throw new TtsError("address", "TTS address must use https (http only for localhost)");
+	if (url.username || url.password) throw new TtsError("address", "TTS address must not contain credentials");
 	return url;
 }
 const SENTENCE_END = /([。！？!?；;…]+|\.(?=\s)|\n+)/u;
@@ -4475,7 +4792,7 @@ const synthesizers = {
 		return readBounded(response);
 	},
 	async volcengine({ text, config, secret, rate, fetchImpl, signal }) {
-		if (!config.appId) throw new TtsError("config", "Volcengine App ID is required");
+		if (!config.appId) throw new TtsError("app-id", "Volcengine App ID is required");
 		const response = await boundedFetch(fetchImpl, "https://openspeech.bytedance.com/api/v1/tts", {
 			method: "POST",
 			headers: {
@@ -4556,9 +4873,9 @@ const synthesizers = {
 	},
 	async azure({ text, config, secret, rate, fetchImpl, signal }) {
 		const region = String(config.region || "").trim().toLowerCase();
-		if (!/^[a-z0-9]{2,30}$/u.test(region)) throw new TtsError("config", "Azure region is invalid");
+		if (!/^[a-z0-9]{2,30}$/u.test(region)) throw new TtsError("azure", "Azure region is invalid");
 		const voice = String(config.voice || "zh-CN-XiaoxiaoNeural");
-		if (!/^[A-Za-z]{2,3}-[A-Za-z]{2,4}-[A-Za-z0-9:]+$/u.test(voice)) throw new TtsError("config", "Azure voice name is invalid");
+		if (!/^[A-Za-z]{2,3}-[A-Za-z]{2,4}-[A-Za-z0-9:]+$/u.test(voice)) throw new TtsError("azure", "Azure voice name is invalid");
 		const lang = voice.split("-").slice(0, 2).join("-");
 		const percent = Math.round((rateNumber(rate) - 1) * 100);
 		const ssml = `<speak version="1.0" xmlns="http://www.w3.org/2001/10/synthesis" xml:lang="${lang}"><voice name="${voice}"><prosody rate="${percent >= 0 ? "+" : ""}${percent}%">${xmlEscape(text)}</prosody></voice></speak>`;
@@ -4598,7 +4915,7 @@ function createTts({ cacheDir, fetchImpl = globalThis.fetch, getSecret }) {
 	async function synthesize({ provider, config = {}, text, rate = 1, signal }) {
 		if (!TTS_PROVIDERS.includes(provider)) throw new TtsError("config", "Unknown TTS provider");
 		const content = String(text ?? "").trim().slice(0, 4e3);
-		if (!content) throw new TtsError("request", "Nothing to speak");
+		if (!content) throw new TtsError("empty", "Nothing to speak");
 		const merged = {
 			...providerDefaults(provider),
 			...config
@@ -4614,7 +4931,7 @@ function createTts({ cacheDir, fetchImpl = globalThis.fetch, getSecret }) {
 			};
 		} catch {}
 		const secret = await getSecret(provider);
-		if (!secret) throw new TtsError("auth", "No key saved for this TTS provider");
+		if (!secret) throw new TtsError("no-key", "No key saved for this TTS provider");
 		const parts = [];
 		for (const chunk of splitForTts(content, CHUNK_UNITS[provider])) parts.push(await synthesizers[provider]({
 			text: chunk,
@@ -4747,7 +5064,7 @@ function createKeyStore({ getCredentials, credentialKey }) {
 	};
 	const service = () => {
 		const credentials = getCredentials();
-		if (!credentials) throw new TutorError("unavailable", "DSH credentials are not available in this profile");
+		if (!credentials) throw new TutorError("no-credentials", "DSH credentials are not available in this profile");
 		return credentials;
 	};
 	return {
@@ -4766,7 +5083,7 @@ function createKeyStore({ getCredentials, credentialKey }) {
 		},
 		async write(provider, value) {
 			const key = String(value ?? "").trim();
-			if (!/^[\x21-\x7E]{8,1024}$/u.test(key)) throw new TutorError("invalid", "The key looks wrong (8–1024 printable characters, no spaces)");
+			if (!/^[\x21-\x7E]{8,1024}$/u.test(key)) throw new TutorError("bad-key", "The key looks wrong (8–1024 printable characters, no spaces)");
 			await service().modifyRecord(keyOf(provider), async () => ({
 				kind: "api-key",
 				key
@@ -4928,7 +5245,7 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 	function digest({ id }) {
 		return jobs.start("material/digest", async (api) => {
 			const [material] = await readMaterials(store, [assertId(id, "mat")]);
-			if (!material?.chunks.length) throw new TutorError("invalid", "This material has no text to digest");
+			if (!material?.chunks.length) throw new TutorError("material-no-text", "This material has no text to digest");
 			const title = material.meta.title;
 			const language = detectLanguage(material.chunks[0].text, uiLanguage());
 			const size = material.chunks.reduce((sum, chunk) => sum + chunk.text.length, 0);
@@ -5011,9 +5328,9 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 	}
 	async function scopeOf(materialIds) {
 		const ids = (Array.isArray(materialIds) ? materialIds : []).filter((id) => /^mat_[a-z0-9]+$/u.test(String(id))).slice(0, 8);
-		if (!ids.length) throw new TutorError("invalid", "Pick at least one material");
+		if (!ids.length) throw new TutorError("no-material", "Pick at least one material");
 		const materials = await readMaterials(store, ids);
-		if (!materials.some((item) => item.chunks.length)) throw new TutorError("invalid", "These materials have no text");
+		if (!materials.some((item) => item.chunks.length)) throw new TutorError("material-no-text", "These materials have no text");
 		const title = materials.map((item) => item.meta.title).join(" + ");
 		return {
 			ids,
@@ -5228,8 +5545,9 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 	}
 	function assist({ mode = "explain", request, materialIds = [], threadId, newThreadId }) {
 		const ask = text(request, 4e3);
-		if (!ask) throw new TutorError("invalid", "Type your question");
+		if (!ask) throw new TutorError("empty-question", "Type your question");
 		const chosen = ASSIST_MODES.includes(mode) ? mode : "explain";
+		const fresh = /^thd_[a-z0-9]{6,40}$/u.test(String(newThreadId)) ? newThreadId : null;
 		return jobs.start("assist/turn", async (api) => {
 			let thread = threadId ? await store.readJson(store.paths.item("assist", assertId(threadId, "thd")), null) : null;
 			const ids = [.../* @__PURE__ */ new Set([...thread?.materialIds ?? [], ...Array.isArray(materialIds) ? materialIds : []])].filter((id) => /^mat_[a-z0-9]+$/u.test(String(id))).slice(0, 8);
@@ -5240,7 +5558,7 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 			const images = await assistImages(ids);
 			const board = await generateSteps(llm, {
 				purpose: "teach",
-				effort: "low",
+				effort: "lowest",
 				prompt: assistPrompt({
 					mode: chosen,
 					request: ask,
@@ -5261,7 +5579,7 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 				board,
 				at: stamp()
 			};
-			const id = thread?.id ?? (/^thd_[a-z0-9]{6,40}$/u.test(String(newThreadId)) ? newThreadId : newId("thd"));
+			const id = thread?.id ?? fresh ?? newId("thd");
 			const saved = await store.updateJson(store.paths.item("assist", id), null, (current) => {
 				const next = current ?? {
 					id,
@@ -5281,14 +5599,18 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 				turn: saved.turns.length - 1,
 				board
 			};
-		}, { meta: { threadId: threadId ?? null } });
+		}, { meta: {
+			threadId: threadId ?? fresh,
+			title: ask.slice(0, 60)
+		} });
 	}
 	async function assistImages(ids) {
 		return llm.supportsImages?.("teach") ? materialImages(store, await readMaterials(store, ids)) : [];
 	}
 	function makeShort({ topic, url, newId: presetId }) {
 		const subject = text(topic, 300);
-		if (!subject && !url) throw new TutorError("invalid", "Give a topic or a web address");
+		if (!subject && !url) throw new TutorError("empty-topic", "Give a topic or a web address");
+		const id = /^sht_[a-z0-9]{6,40}$/u.test(String(presetId)) ? presetId : newId("sht");
 		return jobs.start("short/make", async (api) => {
 			let passages = "";
 			let sourceTitle = "";
@@ -5302,7 +5624,7 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 			const language = detectLanguage(subject || passages, uiLanguage());
 			const board = await generateSteps(llm, {
 				purpose: "teach",
-				effort: "low",
+				effort: "lowest",
 				prompt: shortPrompt({
 					topic: subject || sourceTitle,
 					passages,
@@ -5314,7 +5636,7 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 				minSteps: 3
 			});
 			const item = {
-				id: /^sht_[a-z0-9]{6,40}$/u.test(String(presetId)) ? presetId : newId("sht"),
+				id,
 				title: board.title || subject || sourceTitle,
 				topic: subject,
 				sourceUrl: url ? String(url) : null,
@@ -5324,7 +5646,10 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 			};
 			await store.writeJson(store.paths.item("shorts", item.id), item);
 			return { item };
-		});
+		}, { meta: {
+			id,
+			title: subject
+		} });
 	}
 	return Object.freeze({
 		upload,
@@ -5437,7 +5762,12 @@ function apply(ctx) {
 	const courses = createCourses({
 		store,
 		llm,
-		jobs
+		jobs,
+		research: createResearch({
+			getWeb: () => ctx.get?.("web"),
+			llm,
+			logger
+		})
 	});
 	const lessons = createLessons({
 		store,