Third revision: web search, MCP sign-in, exams, intelligent UI, clarifying questions
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 1m0s

- Built-in Parallel web search (keyless; optional sign-in for higher limits and research)
  with its own settings page; OAuth sign-in (RFC 9728/8414/7591, PKCE, RFC 8707) for any
  MCP server, with token refresh and pre-registered client support
- Friendly tool steps (icon, name, status; details on click) and ids stripped from results;
  per-chat tool switches; taller thinking box
- Exams within classes: exam tabs, scoped lists, uploads, imports and Generate; exam-only
  material for generation; class setting for what the groups are called
- Assistant can ask clarifying questions in an inline form before generating
- OpenUI blocks (charts, questions, flashcards, inputs) in assistant, Explain and share chats
- Explain beside the quiz on wide screens, grounded in the cited source pages
- Quiz results: percentage ring coloured by score band, rainbow at 100
- Share links: assistant button like the owner's, hidden during quizzes; documents readable
  in the browser
- Live draft and library updates over server-sent events

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Elijah 2026-11-15 20:30:00 -07:00
parent 60cf2322f7
commit c595e0ff2c
54 changed files with 4710 additions and 387 deletions

View file

@ -114,9 +114,10 @@ function loadQuestionRows(db: DB, ids: string[]): (QuestionRow & { quiz_title: s
}
/** Question ids ordered from most to least troublesome, using recent responses. */
export function missedQuestionIds(db: DB, scope: { classId?: string; quizId?: string }, limit = 200): string[] {
const where = scope.quizId ? 'AND r.quiz_id = ?' : scope.classId ? 'AND r.class_id = ?' : '';
const params = scope.quizId ? [scope.quizId] : scope.classId ? [scope.classId] : [];
export function missedQuestionIds(db: DB, scope: { classId?: string; quizId?: string; folderId?: string }, limit = 200): string[] {
// A folder is an exam: only questions from that exam's quizzes.
const where = scope.quizId ? 'AND r.quiz_id = ?' : scope.folderId ? 'AND q.quiz_id IN (SELECT id FROM quizzes WHERE folder_id = ?)' : scope.classId ? 'AND r.class_id = ?' : '';
const params = scope.quizId ? [scope.quizId] : scope.folderId ? [scope.folderId] : scope.classId ? [scope.classId] : [];
const rows = db.all<{ question_id: string }>(
`SELECT r.question_id, COUNT(*) AS seen, SUM(CASE WHEN r.correct = 0 THEN 1 ELSE 0 END) AS wrong,
(SELECT r2.correct FROM responses r2 WHERE r2.question_id = r.question_id ORDER BY r2.answered_at DESC LIMIT 1) AS last_correct

View file

@ -30,6 +30,7 @@ export interface ClassRow {
color: string;
archived: number;
sort_order: number;
group_label: string;
created_at: number;
updated_at: number;
}
@ -106,6 +107,8 @@ export interface NoteRow {
export const mapClass = (r: ClassRow) => ({
id: r.id,
name: r.name,
/** What the class calls its groups: Exam (default), Unit, Module… */
groupLabel: r.group_label || 'Exam',
code: r.code,
description: r.description,
color: r.color,
@ -236,6 +239,7 @@ export const classInputSchema = z.object({
code: z.string().trim().max(40).optional().default(''),
description: z.string().max(2000).optional().default(''),
color: z.enum(CLASS_COLORS).optional(),
groupLabel: z.string().trim().min(1).max(24).optional(),
});
export function createClass(db: DB, input: z.input<typeof classInputSchema>): ClassRow {
@ -245,12 +249,13 @@ export function createClass(db: DB, input: z.input<typeof classInputSchema>): Cl
const count = db.get<{ n: number }>('SELECT COUNT(*) AS n FROM classes')?.n ?? 0;
const color = data.color ?? CLASS_COLORS[count % CLASS_COLORS.length];
db.run(
'INSERT INTO classes (id, name, code, description, color, sort_order, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)',
'INSERT INTO classes (id, name, code, description, color, group_label, sort_order, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)',
id,
data.name,
data.code,
data.description,
color,
data.groupLabel ?? 'Exam',
count,
at,
at,

40
server/services/events.ts Normal file
View file

@ -0,0 +1,40 @@
/**
* In-process change notifications for the owner's open tabs. Background work (a draft generated
* by the assistant, a document finishing processing) announces what changed, and /api/events
* streams it to the browser so lists update without a reload.
*/
export type ChangeTopic = 'drafts' | 'library' | 'documents';
type Listener = (topics: ChangeTopic[]) => void;
const listeners = new Set<Listener>();
let queued = new Set<ChangeTopic>();
let timer: ReturnType<typeof setTimeout> | null = null;
/** Announces a change. Bursts (progress updates) are coalesced into one message every 250 ms. */
export function notifyChange(topic: ChangeTopic): void {
if (listeners.size === 0) return;
queued.add(topic);
if (timer) return;
timer = setTimeout(() => {
timer = null;
const topics = [...queued];
queued = new Set();
for (const fn of listeners) fn(topics);
}, 250);
timer.unref?.();
}
export function onChange(listener: Listener): () => void {
listeners.add(listener);
return () => listeners.delete(listener);
}
const WRITE = /^\s*(?:INSERT(?:\s+OR\s+\w+)?\s+INTO|UPDATE|DELETE\s+FROM)\s+(\w+)/i;
const TOPIC: Record<string, ChangeTopic> = { drafts: 'drafts', documents: 'documents', quizzes: 'library', questions: 'library', decks: 'library', cards: 'library', notes: 'library', folders: 'library', classes: 'library' };
/** Maps a write statement to the topic it changes, if any. */
export function topicOfWrite(sql: string): ChangeTopic | null {
const table = WRITE.exec(sql)?.[1]?.toLowerCase();
return table ? (TOPIC[table] ?? null) : null;
}

View file

@ -74,10 +74,10 @@ export interface TopicStat {
}
/** Accuracy per topic over the trailing window. Topics need a few answers before they count. */
export function topicStats(db: DB, scope: { classId?: string }, windowDays = 90, at = clock()): TopicStat[] {
export function topicStats(db: DB, scope: { classId?: string; folderId?: string }, windowDays = 90, at = clock()): TopicStat[] {
const since = at - windowDays * DAY_MS;
const cls = scope.classId ? 'AND r.class_id = ?' : '';
const p = scope.classId ? [scope.classId] : [];
const cls = (scope.classId ? 'AND r.class_id = ? ' : '') + (scope.folderId ? 'AND r.quiz_id IN (SELECT id FROM quizzes WHERE folder_id = ?)' : '');
const p = [...(scope.classId ? [scope.classId] : []), ...(scope.folderId ? [scope.folderId] : [])];
const rows = db.all<{ topic: string; class_id: string | null; class_name: string | null; class_color: string | null; seen: number; acc: number; questions: number }>(
`SELECT r.topic AS topic, r.class_id AS class_id, k.name AS class_name, k.color AS class_color,
COUNT(*) AS seen, AVG(r.score) AS acc,
@ -100,7 +100,7 @@ export function topicStats(db: DB, scope: { classId?: string }, windowDays = 90,
}));
}
export function weakTopics(db: DB, scope: { classId?: string }, limit = 6): TopicStat[] {
export function weakTopics(db: DB, scope: { classId?: string; folderId?: string }, limit = 6): TopicStat[] {
return topicStats(db, scope)
.filter((t) => t.seen >= 3 && t.accuracy < 0.75 && t.questions > 0)
.slice(0, limit);