dsh-aha-tutor 1.6.0 → 1.7.0

package/lib/index.js

@@ -1,4 +1,4 @@
-import { $ as BOARD_LIMITS, A as TutorError, B as passagesFor, C as researchQueriesPrompt, Ct as text, D as summaryPrompt, E as shortPrompt, Et as newId, F as EMPTY_PROFILE, G as formatPassages, H as readProfile, I as emptyProgress, J as applyEvidence, K as passageRange, L as masteryFor, M as generateSteps, N as generateText, O as verifyItemPrompt, P as streamCounter, Q as extractJson, R as materialImages, S as reexplainPrompt, St as safeRelativePath, T as reworkPrompt, Tt as assertId, U as readProgress, V as readMaterials, W as documentParts, X as masteryPercent, Y as createConceptState, Z as recommendNext, _ as profilePrompt, _t as normalizeLesson, a as blueprintPrompt, at as conceptIndex, b as questionnairePrompt, bt as normalizeQuestionnaire, c as correctionPrompt, ct as flattenLessons, d as digestPrompt, dt as lessonAfter, et as boardToPlainText, f as flashcardsPrompt, ft as nextLesson, g as practicePrompt, gt as normalizeItem, h as materialBriefPrompt, ht as normalizeCheatsheet, i as assistPrompt, it as blueprintOutline, j as generateJson, k as verifyStepPrompt, l as detectLanguage, lt as insertLesson, m as lessonPrompt, mt as normalizeCards, n as publishRuntime, nt as normalizeBoard, o as challengePrompt, ot as courseProgress, p as gradePrompt, pt as normalizeBlueprint, q as spreadPassages, r as askPrompt, rt as normalizeOp, s as cheatsheetPrompt, st as findLesson, tt as estimateSpeechMs, u as digestPartPrompt, ut as intakeSummary, v as projectReviewPrompt, vt as normalizePractice, w as revisePrompt, wt as plotToText, x as quizPrompt, xt as outlineForPrompt, y as projectsPrompt, yt as normalizeProject, z as materialsSummary } from "./runtime-B6zUpJjA.js";
+import { $ as passageRange, A as verifyItemPrompt, At as plotToText, B as materialImages, C as quizPrompt, Ct as normalizeLesson, D as reworkPrompt, Dt as outlineForPrompt, E as revisePrompt, Et as normalizeQuestionnaire, F as generateText, G as readProgress, H as passagesFor, I as streamCounter, J as masteryPercent, K as applyEvidence, L as EMPTY_PROFILE, M as TutorError, Mt as newId, N as generateJson, O as shortPrompt, Ot as safeRelativePath, P as generateSteps, Q as formatPassages, R as emptyProgress, S as questionnairePrompt, St as normalizeItem, T as researchQueriesPrompt, Tt as normalizeProject, U as readMaterials, V as materialsSummary, W as readProfile, X as buildIndex, Y as recommendNext, Z as documentParts, _ as materialsRevisePrompt, _t as nextLesson, a as blueprintPrompt, at as boardToPlainText, b as projectReviewPrompt, bt as normalizeCheatsheet, c as correctionPrompt, ct as normalizeOp, d as digestPrompt, dt as courseProgress, et as search, f as flashcardsPrompt, ft as findLesson, g as materialBriefPrompt, gt as lessonAfter, h as lessonPrompt, ht as intakeSummary, i as assistPrompt, it as BOARD_LIMITS, j as verifyStepPrompt, jt as assertId, k as summaryPrompt, kt as text, l as detectLanguage, lt as blueprintOutline, m as handoutPrompt, mt as insertLesson, n as publishRuntime, nt as spreadPassages, o as challengePrompt, ot as estimateSpeechMs, p as gradePrompt, pt as flattenLessons, q as createConceptState, r as askPrompt, rt as extractJson, s as cheatsheetPrompt, st as normalizeBoard, tt as snippetOf, u as digestPartPrompt, ut as conceptIndex, v as practicePrompt, vt as normalizeBlueprint, w as reexplainPrompt, wt as normalizePractice, x as projectsPrompt, xt as normalizeHandout, y as profilePrompt, yt as normalizeCards, z as masteryFor } from "./runtime-DfoeKFPj.js";
 import { createRequire } from "node:module";
 import { dirname, join, relative, sep } from "node:path";
 import { credentialKey } from "@deepseek-ai/dsh-credentials";
@@ -490,15 +490,76 @@ function createCourses({ store, llm, jobs, research, now = () => /* @__PURE__ */
 			meta: { courseId }
 		});
 	}
+	function addMaterials({ courseId, materialIds = [], instruction }) {
+		const wanted = [...new Set(materialIds)].filter((id) => /^mat_[a-z0-9]+$/u.test(id)).slice(0, 12);
+		if (!wanted.length) throw new TutorError("no-materials", "Choose at least one material");
+		const request = text(instruction, 600);
+		return jobs.start("craft/revise", async (api) => {
+			const course = await readCourse(courseId);
+			if (!course.units) throw new TutorError("no-blueprint", "There is no blueprint to revise yet");
+			const known = course.materialIds ?? [];
+			const added = (await readMaterials(store, wanted.filter((id) => !known.includes(id)))).slice(0, Math.max(0, 12 - known.length));
+			if (!added.length) throw new TutorError(wanted.every((id) => known.includes(id)) ? "materials-known" : known.length >= 12 ? "materials-full" : "not-found", "These materials cannot be added");
+			const current = {
+				title: course.title,
+				subtitle: course.subtitle,
+				emoji: course.emoji,
+				summary: course.summary,
+				level: course.level,
+				units: course.units,
+				projects: course.projects
+			};
+			const share = Math.floor(9e3 / added.length);
+			const passages = added.filter((item) => item.chunks.length).map((item) => formatPassages(spreadPassages(item.chunks, {
+				maxChars: share,
+				samples: 8
+			}), item.meta.title)).join("\n\n");
+			api.progress(0, 0, "blueprint");
+			const revised = await generateJson(llm, {
+				purpose: "teach",
+				prompt: materialsRevisePrompt({
+					blueprint: current,
+					materials: materialsSummary(added),
+					passages,
+					instruction: request,
+					language: course.language
+				}),
+				images: llm.supportsImages?.("teach") ? await materialImages(store, added) : void 0,
+				maxTokens: 16e3,
+				signal: api.signal,
+				onText: streamCounter("\"estMinutes\"", (count) => api.progress(count, 0, "blueprint")),
+				normalize: (raw) => attachProjectUnits(raw, normalizeBlueprint(raw, { language: course.language }))
+			});
+			const proposal = {
+				instruction: request,
+				materials: added.map((item) => ({
+					id: item.meta.id,
+					title: item.meta.title
+				})),
+				at: stamp(),
+				blueprint: revised
+			};
+			await store.writeJson(store.paths.proposal(courseId), proposal);
+			return {
+				course,
+				proposal
+			};
+		}, {
+			key: `blueprint:${courseId}`,
+			meta: { courseId }
+		});
+	}
 	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("no-proposal", "There is no proposed change");
+		const materialIds = [.../* @__PURE__ */ new Set([...course.materialIds ?? [], ...(proposal.materials ?? []).map((item) => item.id)])].slice(0, 12);
 		const next = {
 			...course,
 			...proposal.blueprint,
 			language: course.language,
-			status: course.status === "ready" ? "ready" : "blueprint"
+			status: course.status === "ready" ? "ready" : "blueprint",
+			...materialIds.length ? { materialIds } : {}
 		};
 		await saveCourse(next);
 		await store.removeDir(store.paths.proposal(courseId));
@@ -766,6 +827,7 @@ function createCourses({ store, llm, jobs, research, now = () => /* @__PURE__ */
 		startCraft,
 		submitIntake,
 		revise,
+		addMaterials,
 		applyProposal,
 		discardProposal,
 		reworkLesson,
@@ -2044,10 +2106,10 @@ 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}`;
+const itemKey$1 = (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)))];
+	const seen = new Set(saved.map(itemKey$1));
+	return [...saved, ...planned.filter((item) => !seen.has(itemKey$1(item)))];
 }
 function planCalendar({ today, agenda = {}, plan, done = {}, checks = [], ahead = 120 }) {
 	const lessonsDone = done.lessons ?? /* @__PURE__ */ new Map();
@@ -2056,7 +2118,7 @@ function planCalendar({ today, agenda = {}, plan, done = {}, checks = [], 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);
+		if (!list.some((entry) => itemKey$1(entry) === itemKey$1(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);
@@ -2106,9 +2168,10 @@ function createLearner({ store, llm, now = () => /* @__PURE__ */ new Date(), log
 		return readProfile(store);
 	}
 	async function saveProfile(patch = {}) {
+		const given = Object.fromEntries(Object.entries(patch).filter(([, value]) => value !== void 0));
 		return store.updateJson(store.paths.profile(), { ...EMPTY_PROFILE }, (current) => cleanProfile({
 			...current,
-			...patch,
+			...given,
 			updatedAt: now().toISOString()
 		}));
 	}
@@ -2428,6 +2491,7 @@ function list(value) {
 }
 function cleanProfile(profile) {
 	return {
+		name: text(profile.name, 20).replace(/[\r\n]+/gu, " "),
 		background: text(profile.background, 600),
 		goals: list(profile.goals) ?? [],
 		strengths: list(profile.strengths) ?? [],
@@ -2751,6 +2815,16 @@ function stateBefore(state, card) {
 function logEvidence(progress, entry) {
 	progress.evidenceLog = [...Array.isArray(progress.evidenceLog) ? progress.evidenceLog : [], entry].slice(-50);
 }
+function itemKey(source) {
+	if (source?.kind === "practice") return `practice:${source.lessonId}:${source.itemId}`;
+	if (source?.kind === "quiz") return `quiz:${source.unitId}:${source.itemId}`;
+	if (source?.kind === "check") return `check:${source.lessonId}:${source.stepId}`;
+	return null;
+}
+function answersTo(progress, key, except = null) {
+	if (!key) return [];
+	return (Array.isArray(progress?.evidenceLog) ? progress.evidenceLog : []).filter((entry) => entry.item?.key === key && entry.id !== except && scored(entry.evidence));
+}
 function correctEvidence(progress, id, patch, { known = (conceptId) => conceptId, at = (/* @__PURE__ */ new Date()).toISOString() } = {}) {
 	const log = Array.isArray(progress.evidenceLog) ? progress.evidenceLog : [];
 	const index = log.findIndex((entry) => entry.id === id);
@@ -2917,6 +2991,11 @@ function gradeObjective(item, response) {
 		gradable: true
 	};
 }
+function wrongLabel(item, response) {
+	if (item.kind === "choice") return `chose ${String(response).toUpperCase()}: ${(item.options?.find((option) => option.id === response)?.text ?? "").slice(0, 50)}`;
+	if (item.kind === "number" || item.kind === "blank") return `answered ${String(response).slice(0, 40)}`;
+	return "wrong";
+}
 function round2(value) {
 	return Math.round(value * 100) / 100;
 }
@@ -3088,6 +3167,32 @@ function regrade(item, response, checked) {
 		partial: verdict === "partial"
 	};
 }
+function earlierGrade(item, response, { verdict, score, grade = null }) {
+	if (verdict !== "wrong" && verdict !== "unclear") return null;
+	let next;
+	if (OBJECTIVE_KINDS.includes(item.kind)) {
+		const answer = cleanResponse(item, response);
+		const graded = gradeObjective(item, answer);
+		if (!graded.gradable) return null;
+		next = {
+			score: graded.score,
+			correct: graded.correct,
+			errorTag: graded.correct ? "" : wrongLabel(item, answer)
+		};
+	} else {
+		if (!grade || !Number.isFinite(Number(grade.score))) return null;
+		const value = Math.min(1, Math.max(0, Number(grade.score)));
+		const correct = grade.verdict ? grade.verdict === "correct" : value >= .8;
+		next = {
+			score: value,
+			correct,
+			errorTag: correct ? "" : text(grade.errorTag, 80)
+		};
+	}
+	const before = Math.min(1, Math.max(0, Number(score) || 0));
+	if (verdict === "unclear" && next.score <= before || Math.abs(next.score - before) < 1e-6) return null;
+	return next;
+}
 //#endregion
 //#region src/host/lessons.js
 const EVENTS_KEPT = 200;
@@ -3537,12 +3642,13 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 			};
 		});
 	}
-	async function record({ courseId, lessonId, conceptIds = [], evidence = {} }) {
+	async function record({ courseId, lessonId, conceptIds = [], evidence = {}, item = null }) {
 		const course = await courses.readCourse(courseId);
 		const index = conceptIndex(course);
 		const ids = (Array.isArray(conceptIds) && conceptIds.length ? conceptIds : findLesson(course, lessonId)?.lesson.concepts.map((concept) => concept.id) ?? []).filter((id) => index.has(id)).slice(0, 8);
 		const at = now().getTime();
 		const evidenceId = newId("evd");
+		const key = item?.source?.courseId === courseId ? itemKey(item.source) : null;
 		const next = await store.updateJson(store.paths.progress(courseId), null, (progress) => {
 			const value = progress ?? {
 				courseId,
@@ -3568,7 +3674,11 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 				lessonId: lessonId ?? null,
 				conceptIds: ids,
 				evidence: JSON.parse(JSON.stringify(evidence)),
-				before
+				before,
+				...key ? { item: {
+					key,
+					response: item.response ?? ""
+				} } : {}
 			});
 			pushEvent(value, {
 				type: "evidence",
@@ -3701,6 +3811,46 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 			save: rewrite(path, (value) => value?.items)
 		};
 	}
+	async function regradeEarlier({ course, key, item, verdict, except, language, signal }) {
+		const answers = answersTo(await store.readJson(store.paths.progress(course.id), null), key, except);
+		const open = !OBJECTIVE_KINDS.includes(item.kind);
+		const graded = await Promise.all((open ? answers.slice(-3) : answers).map(async (entry) => {
+			const again = open ? await grade({
+				item,
+				response: entry.item.response,
+				language,
+				signal
+			}).catch((error) => {
+				if (signal?.aborted) throw error;
+				return null;
+			}) : null;
+			if (open && !again) return null;
+			return {
+				id: entry.id,
+				next: earlierGrade(item, entry.item.response, {
+					verdict,
+					score: entry.evidence.score,
+					grade: again
+				})
+			};
+		}));
+		let found = null;
+		for (const { id, next } of graded.filter((entry) => entry?.next)) {
+			const corrected = await regradeEvidence(course, id, {
+				score: next.score,
+				errorTag: next.errorTag
+			});
+			if (corrected) found = {
+				count: (found?.count ?? 0) + 1,
+				mastery: {
+					...found?.mastery,
+					...corrected.mastery
+				},
+				recommendation: corrected.recommendation
+			};
+		}
+		return found;
+	}
 	function challengeItem({ source, response, shown = {}, evidenceId, note }) {
 		const doubt = text(note, 800);
 		return jobs.start("item/challenge", async (api) => {
@@ -3736,24 +3886,39 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 				score: result.score,
 				...result.correct ? { errorTag: "" } : result.errorTag ? { errorTag: result.errorTag } : {}
 			}) : null;
+			const earlier = checked.item && place.course ? await regradeEarlier({
+				course: place.course,
+				key: itemKey(source),
+				item,
+				verdict: checked.verdict,
+				except: evidenceId,
+				language: place.language,
+				signal: api.signal
+			}) : null;
 			if (place.course) await logEvent(place.course.id, {
 				type: "item-challenge",
 				lessonId: place.lessonId,
 				verdict: checked.verdict,
-				changed
+				changed,
+				earlier: earlier?.count ?? 0
 			});
+			const mastery = corrected || earlier ? {
+				...corrected?.mastery,
+				...earlier?.mastery
+			} : null;
 			return {
 				verdict: checked.verdict,
 				summary: checked.summary,
 				explanation: checked.explanation,
 				item: checked.item ? item : null,
 				result: changed ? result : null,
-				mastery: corrected?.mastery ?? null,
-				recommendation: corrected?.recommendation ?? null
+				earlier: earlier?.count ?? 0,
+				mastery,
+				recommendation: earlier?.recommendation ?? corrected?.recommendation ?? null
 			};
 		});
 	}
-	async function grade({ item, response, language = "zh-CN" }) {
+	async function grade({ item, response, language = "zh-CN", signal }) {
 		if (!item?.prompt) throw new TutorError("invalid", "Missing question");
 		const work = item.kind === "work";
 		const answer = text(response, 4e3);
@@ -3782,6 +3947,7 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 				language
 			}),
 			maxTokens: work ? 1800 : 1200,
+			signal,
 			normalize: (raw) => ({
 				score: Math.min(1, Math.max(0, Number(raw?.score) || 0)),
 				verdict: [
@@ -3961,6 +4127,44 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 			if (!exists && !jobs.running(`practice:${course.id}:${row.lecture.id}`)) lecturePractice(course, row);
 		}).catch(() => void 0);
 	}
+	async function handout({ courseId, lessonId, force = false }) {
+		const { course, row } = await context(courseId, lessonId);
+		if (!force) {
+			const existing = await store.readJson(store.paths.handout(courseId, lessonId), null);
+			if (existing) return { handout: existing };
+		}
+		const board = await store.readJson(store.paths.board(courseId, lessonId), null);
+		if (!board?.steps?.length) throw new TutorError("no-board", "The board is not written yet. Try again once its first step is up.");
+		return { job: jobs.start("lesson/handout", async (api) => {
+			const made = await generateJson(llm, {
+				purpose: "teach",
+				effort: "lowest",
+				prompt: handoutPrompt({
+					course,
+					lesson: row.lesson,
+					language: course.language,
+					board: boardToPlainText(board, { maxChars: 12e3 })
+				}),
+				maxTokens: 5e3,
+				signal: api.signal,
+				normalize: normalizeHandout
+			});
+			const saved = {
+				...made,
+				title: made.title || row.lesson.title,
+				lessonId,
+				createdAt: stamp()
+			};
+			await store.writeJson(store.paths.handout(courseId, lessonId), saved);
+			return { handout: saved };
+		}, {
+			key: `handout:${courseId}:${lessonId}`,
+			meta: {
+				courseId,
+				lessonId
+			}
+		}) };
+	}
 	async function unitSheet({ courseId, unitId, force = false }) {
 		const course = await courses.readCourse(courseId);
 		const unit = course.units?.find((item) => item.id === assertId(unitId, "unt"));
@@ -4117,6 +4321,7 @@ function createLessons({ store, llm, jobs, courses, learner, now = () => /* @__P
 		reexplain,
 		challenge,
 		challengeItem,
+		handout,
 		record,
 		grade,
 		correct,
@@ -4459,6 +4664,7 @@ function createStore({ root }) {
 		practice: (id, lessonId) => join(paths.courseDir(id), "practice", `${assertId(lessonId, "les")}.json`),
 		asides: (id, lessonId) => join(paths.courseDir(id), "asides", `${assertId(lessonId, "les")}.json`),
 		sheet: (id, unitId) => join(paths.courseDir(id), "sheets", `${assertId(unitId, "unt")}.json`),
+		handout: (id, lessonId) => join(paths.courseDir(id), "handouts", `${assertId(lessonId, "les")}.json`),
 		unitQuiz: (id, unitId) => join(paths.courseDir(id), "quizzes", `${assertId(unitId, "unt")}.json`),
 		materials: () => join(root, "materials"),
 		materialDir: (id) => join(root, "materials", assertId(id, "mat")),
@@ -5271,6 +5477,18 @@ function answerOf(value) {
 	if (typeof value === "number" && Number.isFinite(value)) return String(value);
 	return Array.isArray(value) ? value.filter((id) => typeof id === "string" && /^[a-z]$/u.test(id)).slice(0, 12) : "";
 }
+function answeredItem(payload, courseId) {
+	if (!payload?.source || payload.source.kind === "deck") return null;
+	try {
+		const source = itemSource(payload);
+		return source.courseId === courseId ? {
+			source,
+			response: answerOf(payload.response)
+		} : null;
+	} catch {
+		return null;
+	}
+}
 function shownGrade(value) {
 	const grade = value && typeof value === "object" ? value : {};
 	const words = (key, max) => typeof grade[key] === "string" ? grade[key].slice(0, max) : "";
@@ -5337,6 +5555,11 @@ function createRoutes({ courses, lessons, learner, studio, projects, jobs, setti
 			courseId: need(payload, "courseId", "crs"),
 			instruction: payload.instruction
 		}) }),
+		"course/add-materials": (payload) => ({ job: courses.addMaterials({
+			courseId: need(payload, "courseId", "crs"),
+			materialIds: idList(payload.materialIds, "mat", 12),
+			instruction: payload.instruction
+		}) }),
 		"course/save-blueprint": (payload) => courses.saveBlueprint({
 			courseId: need(payload, "courseId", "crs"),
 			blueprint: payload.blueprint
@@ -5402,6 +5625,7 @@ function createRoutes({ courses, lessons, learner, studio, projects, jobs, setti
 		"lesson/record": (payload) => lessons.record({
 			courseId: need(payload, "courseId", "crs"),
 			lessonId: optional(payload, "lessonId", "les"),
+			item: answeredItem(payload, need(payload, "courseId", "crs")),
 			conceptIds: (Array.isArray(payload.conceptIds) ? payload.conceptIds : []).filter((id) => /^cpt_[a-z0-9]{6,40}$/u.test(String(id))).slice(0, 8),
 			evidence: {
 				kind: payload.evidence?.kind,
@@ -5444,6 +5668,11 @@ function createRoutes({ courses, lessons, learner, studio, projects, jobs, setti
 			lessonId: need(payload, "lessonId", "les"),
 			selfRating: Number(payload.selfRating) || void 0
 		}),
+		"lesson/handout": (payload) => lessons.handout({
+			courseId: need(payload, "courseId", "crs"),
+			lessonId: need(payload, "lessonId", "les"),
+			force: payload.force === true
+		}),
 		"lesson/practice": (payload) => lessons.practice({
 			courseId: need(payload, "courseId", "crs"),
 			lessonId: need(payload, "lessonId", "les")
@@ -5465,6 +5694,7 @@ function createRoutes({ courses, lessons, learner, studio, projects, jobs, setti
 		}),
 		"profile/get": () => learner.getProfile(),
 		"profile/save": (payload) => learner.saveProfile({
+			name: payload.name,
 			background: payload.background,
 			goals: payload.goals,
 			strengths: payload.strengths,
@@ -5502,6 +5732,7 @@ function createRoutes({ courses, lessons, learner, studio, projects, jobs, setti
 		}) }),
 		"material/url": (payload) => ({ job: studio.addUrl({ url: payload.url }) }),
 		"material/list": () => studio.listMaterials(),
+		"material/search": (payload) => studio.searchMaterials({ query: typeof payload.query === "string" ? payload.query : "" }),
 		"material/get": (payload) => studio.getMaterial({ id: need(payload, "id", "mat") }),
 		"material/rename": (payload) => studio.renameMaterial({
 			id: need(payload, "id", "mat"),
@@ -6366,6 +6597,37 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 		const ids = await store.listIds(store.paths.materials(), "mat");
 		return (await Promise.all(ids.map((id) => store.readJson(store.paths.material(id), null)))).filter(Boolean).sort((a, b) => String(b.createdAt).localeCompare(String(a.createdAt)));
 	}
+	let libraryIndex = null;
+	const SEARCH_CHUNKS = 3e4;
+	async function searchMaterials({ query }) {
+		const wanted = text(query, 200);
+		if (!wanted) return { results: [] };
+		const metas = (await listMaterials()).filter((meta) => meta.kind !== "image");
+		const key = metas.map((meta) => `${meta.id}:${meta.title}:${meta.chars ?? meta.pages ?? ""}`).join("|");
+		if (libraryIndex?.key !== key) {
+			const chunks = [];
+			for (const meta of metas) {
+				if (chunks.length >= SEARCH_CHUNKS) break;
+				const own = await store.readJson(store.paths.materialChunks(meta.id), []) ?? [];
+				for (const chunk of own.slice(0, SEARCH_CHUNKS - chunks.length)) chunks.push({
+					...chunk,
+					materialId: meta.id,
+					materialTitle: meta.title
+				});
+			}
+			libraryIndex = {
+				key,
+				index: buildIndex(chunks)
+			};
+		}
+		return { results: search(libraryIndex.index, wanted, { limit: 12 }).map(({ chunk }) => ({
+			materialId: chunk.materialId,
+			title: chunk.materialTitle,
+			page: chunk.page ?? null,
+			slide: chunk.slide ?? null,
+			snippet: snippetOf(chunk.text, wanted)
+		})) };
+	}
 	async function getMaterial({ id }) {
 		const meta = await store.readJson(store.paths.material(assertId(id, "mat")), null);
 		if (!meta) throw new TutorError("not-found", "Material not found");
@@ -6806,6 +7068,7 @@ function createStudio({ store, llm, jobs, now = () => /* @__PURE__ */ new Date()
 		upload,
 		addUrl,
 		listMaterials,
+		searchMaterials,
 		getMaterial,
 		renameMaterial,
 		removeMaterial,