Study/web/src/lib/assistantStore.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

78 lines
2.6 KiB
TypeScript

import { useEffect, useSyncExternalStore } from 'react';
/** Drag-and-drop payload for library items: set by class pages, read by the assistant panel. */
export const ITEM_DRAG_TYPE = 'application/x-studydesk-item';
export interface AssistantSeed {
id: number;
prompt?: string;
autoSend?: boolean;
newChat?: boolean;
classId?: string | null;
documentIds?: string[];
}
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; folderId?: string | null };
}
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 };
listeners.forEach((fn) => fn());
};
let seedId = 0;
/** The drawer's conversation, kept while the drawer is closed so reopening continues it. */
let drawerConversation: string | null = null;
export const assistant = {
/** Opens the assistant, optionally with a prepared prompt. */
open(seed: Omit<AssistantSeed, 'id'> = {}) {
seedId += 1;
set({ open: true, seed: { id: seedId, ...seed } });
},
close() {
set({ open: false });
},
toggle() {
set({ open: !state.open });
},
consumeSeed() {
if (state.seed) set({ seed: null });
},
get drawerConversation() {
return drawerConversation;
},
rememberDrawerConversation(id: string | null) {
drawerConversation = id;
},
setContext(context: State['context']) {
const cur = state.context;
if (cur.classId === context.classId && cur.label === context.label && (cur.folderId ?? null) === (context.folderId ?? null) && cur.documentIds.join() === context.documentIds.join()) return;
set({ context });
},
};
export function useAssistantState(): State {
return useSyncExternalStore(
(fn) => {
listeners.add(fn);
return () => listeners.delete(fn);
},
() => state,
() => state,
);
}
/** 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, folderId });
return () => assistant.setContext({ classId: null, documentIds: [], label: '', folderId: null });
}, [classId, label, key, folderId]);
}