Study/server/python-runner.mjs
Elijah 031f7bec31
All checks were successful
Verify and publish V2 container / build-and-push (push) Successful in 30s
Second revision: MCP servers, shared-link AI, flashcard modes, document previews
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>
2026-11-15 15:48:54 -07:00

124 lines
5.2 KiB
JavaScript

/**
* Sandboxed Python runner (Pyodide / WebAssembly). Started by server/ai/sandbox.ts as a
* separate Node process with the permission model on:
* --permission --allow-fs-read=<pyodide dir> --allow-fs-read=<this file>
* so even code that escaped the WebAssembly sandbox could not read the data folder, write
* anything, start processes or load native addons. It also gets an empty environment, so
* there are no secrets in `process.env`.
*
* Inside Python, `js` is an empty object (jsglobals: {}) and the bridges back to JavaScript
* (pyodide_js, pyodide.http, micropip) are removed, so code cannot reach fetch, require or
* the host file system. Only the standard library is available.
*
* Protocol (IPC): { id, code, timeoutMs } -> { id, ok, stdout, stderr, result, error, ms }.
* The parent kills this process when a run exceeds its time limit.
*/
import { constants as fsConstants } from 'node:fs';
import { pathToFileURL } from 'node:url';
// Emscripten's NODEFS reads open-flag constants through process.binding('constants'), which
// the permission model forbids. Answer that one call from the public fs.constants instead.
process.binding = (name) => {
if (name === 'constants') return { fs: fsConstants };
throw new Error(`process.binding('${name}') is not available in the Python sandbox`);
};
const pyodideEntry = process.argv[2];
const OUTPUT_LIMIT = 20_000;
const { loadPyodide } = await import(pathToFileURL(pyodideEntry).href);
let stdout = '';
let stderr = '';
const append = (which, text) => {
if (which === 'out') {
if (stdout.length < OUTPUT_LIMIT) stdout += `${text}\n`;
} else if (stderr.length < OUTPUT_LIMIT) stderr += `${text}\n`;
};
const pyodide = await loadPyodide({
jsglobals: {},
stdout: (t) => append('out', t),
stderr: (t) => append('err', t),
stdin: () => null,
});
pyodide.runPython(`
import sys, importlib.abc
_BLOCKED = ('js', 'pyodide_js', 'micropip', 'pyodide.http', 'pyodide.webloop', 'pyodide_http')
for _name in list(sys.modules):
if _name in _BLOCKED or _name.split('.')[0] in ('js', 'pyodide_js', 'micropip'):
del sys.modules[_name]
class _Sandbox(importlib.abc.MetaPathFinder):
blocked = _BLOCKED
roots = ('js', 'pyodide_js', 'micropip')
def find_spec(self, fullname, path=None, target=None):
if fullname in self.blocked or fullname.split('.')[0] in self.roots:
raise ImportError(f"{fullname} is not available in this sandbox (no network, files or JavaScript)")
return None
sys.meta_path.insert(0, _Sandbox())
del _Sandbox, _BLOCKED
`);
/*
* Pyodide is loaded; from here on nothing in this process needs the network or new modules.
* Node 24's permission model does not restrict network access (Node 26's does), so close
* those doors here as well: no fetch/WebSocket globals and no loading of network, process or
* worker modules, whether by import, require or process.getBuiltinModule.
*/
const BLOCKED_MODULES = new Set(['net', 'http', 'https', 'http2', 'tls', 'dns', 'dgram', 'child_process', 'worker_threads', 'cluster', 'inspector', 'vm', 'module']);
const isBlocked = (id) => BLOCKED_MODULES.has(String(id).replace(/^node:/, ''));
const nodeModule = process.getBuiltinModule('node:module');
nodeModule.registerHooks?.({
resolve(specifier, context, next) {
if (isBlocked(specifier)) throw new Error(`${specifier} is not available in the Python sandbox`);
return next(specifier, context);
},
});
const getBuiltin = process.getBuiltinModule.bind(process);
process.getBuiltinModule = (id) => {
if (isBlocked(id)) throw new Error(`${id} is not available in the Python sandbox`);
return getBuiltin(id);
};
for (const name of ['fetch', 'WebSocket', 'EventSource', 'XMLHttpRequest', 'Request', 'Response']) {
try {
Object.defineProperty(globalThis, name, { value: undefined, configurable: false, writable: false });
} catch {
/* not defined in this Node version */
}
}
/** Runs one snippet in a fresh namespace. The value of a final expression is returned as `result`. */
async function run(code) {
stdout = '';
stderr = '';
const ns = pyodide.globals.get('dict')();
const started = Date.now();
try {
const value = await pyodide.runPythonAsync(code, { globals: ns });
let result = null;
if (value !== undefined && value !== null) {
result = typeof value === 'object' && typeof value.toString === 'function' ? String(value) : String(value);
if (typeof value?.destroy === 'function') value.destroy();
}
return { ok: true, stdout: stdout.slice(0, OUTPUT_LIMIT), stderr: stderr.slice(0, OUTPUT_LIMIT), result: result && result.slice(0, OUTPUT_LIMIT), error: null, ms: Date.now() - started };
} catch (err) {
const message = String(err?.message ?? err);
// Keep the Python traceback, drop the Pyodide/JavaScript frames above it.
const tb = message.includes('Traceback') ? message.slice(message.indexOf('Traceback')) : message;
return { ok: false, stdout: stdout.slice(0, OUTPUT_LIMIT), stderr: stderr.slice(0, OUTPUT_LIMIT), result: null, error: tb.slice(-4000), ms: Date.now() - started };
} finally {
ns.destroy();
}
}
process.on('message', async (msg) => {
if (!msg || typeof msg.code !== 'string') return;
const reply = await run(msg.code);
process.send?.({ id: msg.id, ...reply });
});
process.send?.({ ready: true });