Study/server/services/events.ts
Elijah c595e0ff2c
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 1m0s
Third revision: web search, MCP sign-in, exams, intelligent UI, clarifying questions
- 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>
2026-11-15 20:30:00 -07:00

40 lines
1.6 KiB
TypeScript

/**
* 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;
}