Second revision: MCP servers, shared-link AI, flashcard modes, document previews
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 30s
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 30s
Generation - Every quiz is NCLEX style; "Practice exam" writes 50 questions. - Calculation questions only when the material involves calculations (max 5 per exam). - Broad topics: the class's topics are listed in the prompt, a quick grouping call maps narrow labels onto broad ones, and leftover variants are merged. - Exact select-all count per batch; option order shuffled. - Python check: at most 3 runs, fixed problems count as passed, cosmetic remarks ignored. Assistant - Text, tool steps and cards appear in the order they happen, with paragraph breaks between steps. - Optional thinking box: fixed height, follows the newest text, can be scrolled back. - "+" opens a material picker listing recent items; items can be dragged in from class pages; shorter placeholder. MCP servers - Streamable HTTP client; encrypted headers. - Per-server instructions and switches for chat, Explain, generation and the quiz check. - Settings UI. Share links - Optional "Explain this" and "Ask about this material" per link, off by default. - Items are loaded on the server and checked against the share; no tools; rate-limited. - Migration 4 stores the switches. Study and documents - Standard flashcard mode (optionally repeat missed cards until known) next to spaced repetition. - Streak visuals restyled in the app palette. - Side by side / Original document views, with sandboxed previews of Word and PowerPoint files. Other - Built-in embedding model baked into the image; sharp stubbed if it cannot load; real load error shown in Settings. - Python runner blocks network and process modules in JavaScript too. - "View questions and answers" removed from the quiz start screen. - Docs updated. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
parent
5ea61c882c
commit
031f7bec31
45 changed files with 2918 additions and 397 deletions
|
|
@ -19,6 +19,7 @@ import {
|
|||
startImprove,
|
||||
updateDraftPayload,
|
||||
} from '../ai/generate.ts';
|
||||
import { deleteMcpServer, listMcpServers, mcpServerInputSchema, mcpServerPatchSchema, saveMcpServer, testMcpServer } from '../ai/mcp.ts';
|
||||
import { CATALOG_UPDATED, listAdapterMeta } from '../ai/providers/index.ts';
|
||||
import {
|
||||
addManualModel,
|
||||
|
|
@ -34,6 +35,7 @@ import {
|
|||
patchModel,
|
||||
providerInputSchema,
|
||||
runChat,
|
||||
runChatWithMcp,
|
||||
saveProvider,
|
||||
saveTaskSettings,
|
||||
TASK_INFO,
|
||||
|
|
@ -41,13 +43,14 @@ import {
|
|||
usageSummary,
|
||||
} from '../ai/service.ts';
|
||||
import { embedTexts, embeddingSettingsSchema, getEmbeddingSettings, embeddingStatus, rebuildIndex, saveEmbeddingSettings, scheduleIndexing } from '../services/semantic.ts';
|
||||
import { EXPLAIN_SYSTEM, explainPrompt } from '../ai/explain.ts';
|
||||
import { AIError } from '../ai/types.ts';
|
||||
import { badRequest, HttpError, idParam, notFound, readBody, type AppContext } from '../http.ts';
|
||||
|
||||
type Emit<T> = (event: T) => void;
|
||||
|
||||
/** Server-sent events with ordered writes, keep-alive pings and abort propagation. */
|
||||
function sse<T extends { type: string }>(c: Context, run: (emit: Emit<T>, signal: AbortSignal) => Promise<void>) {
|
||||
export function sse<T extends { type: string }>(c: Context, run: (emit: Emit<T>, signal: AbortSignal) => Promise<void>) {
|
||||
c.header('X-Accel-Buffering', 'no');
|
||||
c.header('Cache-Control', 'no-cache, no-transform');
|
||||
return streamSSE(c, async (stream) => {
|
||||
|
|
@ -96,8 +99,6 @@ const contentDraftSchema = z.discriminatedUnion('kind', [
|
|||
z.object({ kind: z.literal('note'), title: z.string().max(200), content: z.string().max(400000) }),
|
||||
]);
|
||||
|
||||
const EXPLAIN_SYSTEM = `You are a patient nursing instructor helping a student while they study. Explain clearly and briefly (aim for under 200 words unless asked for more).
|
||||
Use Markdown. Lead with the key idea, explain the reasoning, and connect it to patient care. If answer choices are given, say why the correct one is right and, in a line each, why the others are wrong. Do not restate the whole question.`;
|
||||
|
||||
export function aiRoutes(app: AppContext): Hono {
|
||||
const { db } = app;
|
||||
|
|
@ -131,6 +132,16 @@ export function aiRoutes(app: AppContext): Hono {
|
|||
return c.json({ ...result, models: listModels(db) });
|
||||
});
|
||||
|
||||
// MCP servers the assistant can call as tools.
|
||||
r.get('/ai/mcp', (c) => c.json({ servers: listMcpServers(app) }));
|
||||
r.post('/ai/mcp', async (c) => c.json({ server: saveMcpServer(app, null, await readBody(c, mcpServerInputSchema)) }, 201));
|
||||
r.patch('/ai/mcp/:id', async (c) => c.json({ server: saveMcpServer(app, idParam(c), await readBody(c, mcpServerPatchSchema)) }));
|
||||
r.delete('/ai/mcp/:id', (c) => {
|
||||
deleteMcpServer(app, idParam(c));
|
||||
return c.json({ ok: true });
|
||||
});
|
||||
r.post('/ai/mcp/:id/test', async (c) => c.json({ result: await testMcpServer(app, idParam(c)) }));
|
||||
|
||||
r.get('/ai/models', (c) => c.json({ models: listModels(db) }));
|
||||
r.post('/ai/models', async (c) => c.json({ model: addManualModel(app, await readBody(c, manualModelSchema)) }, 201));
|
||||
r.patch('/ai/models/:id', async (c) => c.json({ model: patchModel(db, idParam(c), await readBody(c, modelPatchSchema)) }));
|
||||
|
|
@ -278,36 +289,35 @@ export function aiRoutes(app: AppContext): Hono {
|
|||
|
||||
r.post('/ai/explain', async (c) => {
|
||||
const body = await readBody(c, explainSchema);
|
||||
let prompt: string;
|
||||
if (body.kind === 'question') {
|
||||
prompt = [
|
||||
`Question:\n${body.stem}`,
|
||||
`Choices:\n${body.options.map((o) => `- ${o.text}${o.correct ? ' (correct)' : ''}`).join('\n')}`,
|
||||
body.selected?.length ? `The student chose: ${body.selected.join('; ')}` : '',
|
||||
body.rationale ? `Existing rationale:\n${body.rationale}` : '',
|
||||
body.ask ? `The student asks: ${body.ask}` : 'Explain this question so it finally makes sense. If the student chose wrongly, address the misunderstanding behind their choice.',
|
||||
]
|
||||
.filter(Boolean)
|
||||
.join('\n\n');
|
||||
} else if (body.kind === 'card') {
|
||||
prompt = `Flashcard front:\n${body.front}\n\nFlashcard back:\n${body.back}\n\n${body.ask ? `The student asks: ${body.ask}` : 'Explain this card in more depth and give one way to remember it.'}`;
|
||||
} else {
|
||||
prompt = `${body.text}\n\n${body.ask ? `The student asks: ${body.ask}` : 'Explain this passage in simpler terms and point out what is most important to remember.'}`;
|
||||
}
|
||||
const prompt = explainPrompt(body);
|
||||
if (!prompt.trim()) throw badRequest('Nothing to explain');
|
||||
return sse<{ type: 'text'; delta: string } | { type: 'error'; message: string; code: string } | { type: 'done' }>(c, async (emit, signal) => {
|
||||
try {
|
||||
await runChat(app, {
|
||||
task: 'quick',
|
||||
purpose: 'explanation',
|
||||
system: EXPLAIN_SYSTEM,
|
||||
messages: [{ role: 'user', content: [{ type: 'text', text: prompt }] }],
|
||||
maxOutputTokens: 1500,
|
||||
signal,
|
||||
onEvent: (e) => {
|
||||
if (e.type === 'text') emit({ type: 'text', delta: e.delta });
|
||||
let wrote = false;
|
||||
await runChatWithMcp(
|
||||
app,
|
||||
{
|
||||
task: 'quick',
|
||||
purpose: 'explanation',
|
||||
system: EXPLAIN_SYSTEM,
|
||||
messages: [{ role: 'user', content: [{ type: 'text', text: prompt }] }],
|
||||
maxOutputTokens: 1500,
|
||||
signal,
|
||||
onEvent: (e) => {
|
||||
if (e.type !== 'text') return;
|
||||
wrote = true;
|
||||
emit({ type: 'text', delta: e.delta });
|
||||
},
|
||||
},
|
||||
});
|
||||
'explain',
|
||||
{
|
||||
// Text before a tool call ends its paragraph.
|
||||
onTool: () => {
|
||||
if (wrote) emit({ type: 'text', delta: '\n\n' });
|
||||
wrote = false;
|
||||
},
|
||||
},
|
||||
);
|
||||
} catch (err) {
|
||||
const ai = err instanceof AIError ? err : null;
|
||||
if (ai?.code !== 'aborted') emit({ type: 'error', code: ai?.code ?? 'server', message: ai?.message ?? 'The explanation could not be generated.' });
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue