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

@ -16,10 +16,10 @@ interface State {
open: boolean;
seed: AssistantSeed | null;
/** What the user is currently looking at; supplied by pages. */
context: { classId: string | null; documentIds: string[]; label: string };
context: { classId: string | null; documentIds: string[]; label: string; folderId?: string | null };
}
let state: State = { open: false, seed: null, context: { classId: null, documentIds: [], label: '' } };
let state: State = { open: false, seed: null, context: { classId: null, documentIds: [], label: '', folderId: null } };
const listeners = new Set<() => void>();
const set = (patch: Partial<State>) => {
state = { ...state, ...patch };
@ -52,7 +52,7 @@ export const assistant = {
},
setContext(context: State['context']) {
const cur = state.context;
if (cur.classId === context.classId && cur.label === context.label && cur.documentIds.join() === context.documentIds.join()) return;
if (cur.classId === context.classId && cur.label === context.label && (cur.folderId ?? null) === (context.folderId ?? null) && cur.documentIds.join() === context.documentIds.join()) return;
set({ context });
},
};
@ -68,11 +68,11 @@ export function useAssistantState(): State {
);
}
/** Pages call this so the assistant knows which class or document "this" refers to. */
export function useAssistantContext(classId: string | null | undefined, label = '', documentIds: string[] = []): void {
/** Pages call this so the assistant knows which class, exam or document "this" refers to. */
export function useAssistantContext(classId: string | null | undefined, label = '', documentIds: string[] = [], folderId: string | null = null): void {
const key = documentIds.join(',');
useEffect(() => {
assistant.setContext({ classId: classId ?? null, documentIds: key ? key.split(',') : [], label });
return () => assistant.setContext({ classId: null, documentIds: [], label: '' });
}, [classId, label, key]);
assistant.setContext({ classId: classId ?? null, documentIds: key ? key.split(',') : [], label, folderId });
return () => assistant.setContext({ classId: null, documentIds: [], label: '', folderId: null });
}, [classId, label, key, folderId]);
}

View file

@ -1,5 +1,5 @@
import { useQuery, useQueryClient } from '@tanstack/react-query';
import { useCallback } from 'react';
import { useCallback, useEffect } from 'react';
import { api } from './api';
import type { AiModel, AiStatus, ClassDetail, ClassListItem, DeckDetail, Overview, QuizDetail } from './types';
@ -52,3 +52,28 @@ export function useRefresh() {
[qc],
);
}
/**
* Listens to /api/events and refreshes what changed elsewhere: a draft the assistant created,
* a quiz saved in another tab, a change the assistant confirmed. Reconnects by itself.
*/
export function useLiveChanges() {
const qc = useQueryClient();
useEffect(() => {
if (typeof EventSource === 'undefined') return;
const source = new EventSource('/api/events');
source.onmessage = (e) => {
let msg: { type?: string; topics?: string[] } = {};
try {
msg = JSON.parse(e.data);
} catch {
return;
}
if (msg.type !== 'change' || !msg.topics) return;
if (msg.topics.includes('drafts')) void qc.invalidateQueries({ queryKey: qk.drafts });
// Document processing is already polled by the pages that show it; its progress writes are skipped here.
if (msg.topics.includes('library')) void qc.invalidateQueries({ predicate: (q) => ['classes', 'class', 'overview', 'quiz', 'deck', 'note'].includes(String(q.queryKey[0])) });
};
return () => source.close();
}, [qc]);
}

View file

@ -5,6 +5,8 @@ export type { Card, ClassColor, ContentDraft, Option, Question, QuestionType };
export interface ClassInfo {
id: string;
name: string;
/** What the class calls its groups (folders): Exam by default. */
groupLabel: string;
code: string;
description: string;
color: ClassColor;
@ -456,14 +458,43 @@ export type UiItem =
| { type: 'draft'; draftId: string; kind: 'quiz' | 'deck' | 'note'; title: string; count: number; status: string }
| { type: 'action'; actionId: string; summary: string; changes: string[]; status: 'pending' | 'confirmed' | 'cancelled' | 'failed'; result?: string }
| { type: 'sources'; items: { ref: string; chunkId: number; documentId: string; label: string }[] }
| { type: 'link'; kind: 'quiz' | 'deck' | 'note' | 'document' | 'class' | 'attempt'; id: string; title: string };
| { type: 'link'; kind: 'quiz' | 'deck' | 'note' | 'document' | 'class' | 'attempt'; id: string; title: string }
| { type: 'questions'; id: string; intro?: string; questions: AskQuestion[] };
export interface AskQuestion {
id: string;
question: string;
input: 'choice' | 'text' | 'number';
options?: { label: string; description?: string }[];
multi?: boolean;
defaults?: string[];
placeholder?: string;
}
export type ToolKind = 'web_search' | 'web_fetch' | 'web_research' | 'mcp' | 'tool';
export interface WebSource {
title: string;
url: string;
}
export interface ToolActivity {
id: string;
name: string;
label: string;
status: 'running' | 'done' | 'error';
summary?: string;
kind?: ToolKind;
server?: string;
subject?: string;
sources?: WebSource[];
input?: string;
output?: string;
}
/** A web search or MCP server the chat can use, for the per-chat switches. */
export interface ChatToolSource {
id: string;
name: string;
kind: 'web' | 'mcp';
}
export type TagKind = 'quiz' | 'deck' | 'note' | 'document' | 'folder';
export interface TaggedItem {