@noesis-brain/mcp-server 2.1.1 → 2.1.3

package/dist/tools/exam/examNoteTemplate.js

@@ -0,0 +1,110 @@
+const CHOICE_LABELS = ['A', 'B', 'C', 'D', 'E', 'F'];
+const ROMAN = ['I', 'II', 'III', 'IV', 'V'];
+export function buildAnchorText(questionId, blankIndex) {
+    if (typeof blankIndex === 'number' && blankIndex > 0) {
+        return `Answer ${questionId}.${blankIndex}:`;
+    }
+    return `Answer ${questionId}:`;
+}
+function renderQuestion(q) {
+    switch (q.type) {
+        case 'translation':
+            return renderTranslation(q);
+        case 'sentence-completion':
+            return renderSentenceCompletion(q);
+        case 'vocab-in-context':
+            return renderVocabInContext(q);
+        case 'multiple-choice':
+            return renderMultipleChoice(q);
+        case 'calculation':
+            return renderCalculation(q);
+        case 'short-answer':
+            return renderShortAnswer(q);
+        case 'fill-in-the-blank':
+            return renderFillInBlank(q);
+    }
+}
+function renderTranslation(q) {
+    return `**${q.questionNum}.** ${q.zhPrompt}\n\n> **${buildAnchorText(q.id)}** _______________________`;
+}
+function renderSentenceCompletion(q) {
+    const choices = q.choices
+        .map((c, i) => `- (${CHOICE_LABELS[i]}) ${c}`)
+        .join('\n');
+    return `**${q.questionNum}.** ${q.sentenceWithBlank}\n\n${choices}\n\n> **${buildAnchorText(q.id)}** _ (A/B/C/D)`;
+}
+function renderVocabInContext(q) {
+    const sentence = q.sentence.replace(new RegExp(`\\b${q.underlinedWord.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\b`, 'i'), (match) => `<u>${match}</u>`);
+    const choices = q.choices
+        .map((c, i) => `- (${CHOICE_LABELS[i]}) ${c}`)
+        .join('\n');
+    return `**${q.questionNum}.** ${sentence}\n\n*The underlined word is closest in meaning to:*\n\n${choices}\n\n> **${buildAnchorText(q.id)}** _ (A/B/C/D)`;
+}
+function renderMultipleChoice(q) {
+    const choices = q.choices
+        .map((c, i) => `- (${CHOICE_LABELS[i]}) ${c}`)
+        .join('\n');
+    const letterHint = q.choices
+        .map((_, i) => CHOICE_LABELS[i])
+        .filter(Boolean)
+        .join('/');
+    return `**${q.questionNum}.** ${q.prompt}\n\n${choices}\n\n> **${buildAnchorText(q.id)}** _ (${letterHint})`;
+}
+function renderCalculation(q) {
+    const unitHint = q.unit ? ` ${q.unit}` : '';
+    return `**${q.questionNum}.** ${q.prompt}\n\n> **${buildAnchorText(q.id)}** _______________________${unitHint}`;
+}
+function renderShortAnswer(q) {
+    return `**${q.questionNum}.** ${q.prompt}\n\n> **${buildAnchorText(q.id)}** _______________________`;
+}
+function renderFillInBlank(q) {
+    const blankCount = countBlanks(q.prompt);
+    if (blankCount <= 1) {
+        return `**${q.questionNum}.** ${q.prompt}\n\n> **${buildAnchorText(q.id)}** _______________________`;
+    }
+    const answerLines = Array.from({ length: blankCount }, (_, i) => {
+        const oneBased = i + 1;
+        return `> **${buildAnchorText(q.id, oneBased)}** _______________________`;
+    }).join('\n');
+    return `**${q.questionNum}.** ${q.prompt}\n\n${answerLines}`;
+}
+function countBlanks(prompt) {
+    return (prompt.match(/_{3,}/g) ?? []).length;
+}
+function renderSection(section, sectionNum) {
+    const numeral = ROMAN[sectionNum - 1] || String(sectionNum);
+    const pointsLabel = `${section.points} point${section.points !== 1 ? 's' : ''}`;
+    const body = section.questions.map(renderQuestion).join('\n\n');
+    return `## ${numeral}. ${section.title} (${pointsLabel})\n\n*${section.instructions}*\n\n${body}`;
+}
+/**
+ * Build the markdown representation of an exam for storage as a note, plus
+ * the anchor list the backend needs to pre-create one text_note marker per
+ * question. Mirrors the frontend's buildExamMarkdown exactly (no
+ * referenceImageDataUri support here — that's an AI-generated-source feature
+ * not needed for hand-authored exams created via create_exam_note).
+ */
+export function buildExamMarkdown(examData) {
+    const header = `# ${examData.title}\n\n*${examData.date} — ${examData.totalPoints} points total*\n\n**Name:** _________________________   **Score:** _______ / ${examData.totalPoints}`;
+    const sectionsMd = examData.sections
+        .map((section, i) => renderSection(section, i + 1))
+        .join('\n\n---\n\n');
+    const markdown = `${header}\n\n---\n\n${sectionsMd}\n`;
+    const anchors = [];
+    for (const section of examData.sections) {
+        for (const q of section.questions) {
+            if (q.type === 'fill-in-the-blank') {
+                const blanks = countBlanks(q.prompt);
+                if (blanks > 1) {
+                    for (let i = 1; i <= blanks; i++) {
+                        anchors.push({ id: q.id, anchorText: buildAnchorText(q.id, i), blankIndex: i });
+                    }
+                    continue;
+                }
+            }
+            anchors.push({ id: q.id, anchorText: buildAnchorText(q.id) });
+        }
+    }
+    return { markdown, anchors };
+}
+//# sourceMappingURL=examNoteTemplate.js.map

package/dist/tools/exam/examNoteTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examNoteTemplate.js","sourceRoot":"","sources":["../../../src/tools/exam/examNoteTemplate.ts"],"names":[],"mappings":"AA2BA,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AACrD,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;AAE5C,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,UAAmB;IACrE,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,UAAU,UAAU,IAAI,UAAU,GAAG,CAAC;IAC/C,CAAC;IACD,OAAO,UAAU,UAAU,GAAG,CAAC;AACjC,CAAC;AAED,SAAS,cAAc,CAAC,CAAe;IACrC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,aAAa;YAChB,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC9B,KAAK,qBAAqB;YACxB,OAAO,wBAAwB,CAAC,CAAC,CAAC,CAAC;QACrC,KAAK,kBAAkB;YACrB,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC;QACjC,KAAK,iBAAiB;YACpB,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC;QACjC,KAAK,aAAa;YAChB,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC9B,KAAK,cAAc;YACjB,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC9B,KAAK,mBAAmB;YACtB,OAAO,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAsB;IAC/C,OAAO,KAAK,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,QAAQ,WAAW,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,4BAA4B,CAAC;AACzG,CAAC;AAED,SAAS,wBAAwB,CAAC,CAA6B;IAC7D,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;SAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,KAAK,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,iBAAiB,OAAO,OAAO,WAAW,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC;AACpH,CAAC;AAED,SAAS,oBAAoB,CAAC,CAAyB;IACrD,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CACjC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,EACnF,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,MAAM,CAC7B,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;SAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,KAAK,CAAC,CAAC,WAAW,OAAO,QAAQ,0DAA0D,OAAO,WAAW,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,gBAAgB,CAAC;AAC5J,CAAC;AAED,SAAS,oBAAoB,CAAC,CAAyB;IACrD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;SAC7C,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO;SACzB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SAC/B,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,OAAO,KAAK,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,WAAW,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,UAAU,GAAG,CAAC;AAC/G,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAsB;IAC/C,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5C,OAAO,KAAK,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,MAAM,WAAW,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,6BAA6B,QAAQ,EAAE,CAAC;AAClH,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAsB;IAC/C,OAAO,KAAK,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,MAAM,WAAW,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,4BAA4B,CAAC;AACvG,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAsB;IAC/C,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,UAAU,IAAI,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,MAAM,WAAW,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,4BAA4B,CAAC;IACvG,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC9D,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,OAAO,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,4BAA4B,CAAC;IAC5E,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO,KAAK,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,MAAM,OAAO,WAAW,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;AAC/C,CAAC;AAED,SAAS,aAAa,CAAC,OAAoB,EAAE,UAAkB;IAC7D,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,GAAG,OAAO,CAAC,MAAM,SAAS,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAChF,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,OAAO,MAAM,OAAO,KAAK,OAAO,CAAC,KAAK,KAAK,WAAW,SAAS,OAAO,CAAC,YAAY,QAAQ,IAAI,EAAE,CAAC;AACpG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAkB;IAKlB,MAAM,MAAM,GAAG,KAAK,QAAQ,CAAC,KAAK,QAAQ,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,WAAW,gFAAgF,QAAQ,CAAC,WAAW,EAAE,CAAC;IAExL,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ;SACjC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SAClD,IAAI,CAAC,aAAa,CAAC,CAAC;IAEvB,MAAM,QAAQ,GAAG,GAAG,MAAM,cAAc,UAAU,IAAI,CAAC;IAEvD,MAAM,OAAO,GAAmE,EAAE,CAAC;IACnF,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAClC,IAAI,CAAC,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBACrC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;oBACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;wBACjC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;oBAClF,CAAC;oBACD,SAAS;gBACX,CAAC;YACH,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/tools/exam/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * ExamData shape accepted by the backend's POST /api/notes/from-exam.
+ *
+ * Ported from the frontend repo's
+ * src/frontend/src/components/Chat/tools/exam/types.ts — kept as a verbatim
+ * copy (zero external imports there, so this is safe) rather than shared via
+ * a package, since the MCP server is a separate git repo/npm package with no
+ * dependency path to the frontend. Keep in sync by hand if the frontend
+ * shape changes; the backend's validateExamData
+ * (src/backend/services/examSources/examDataValidator.ts) is the real,
+ * authoritative gate either way.
+ */
+export interface TranslationQuestion {
+    type: 'translation';
+    id: string;
+    questionNum: number;
+    zhPrompt: string;
+    answerEn: string;
+    sourceWord?: string;
+}
+export interface SentenceCompletionQuestion {
+    type: 'sentence-completion';
+    id: string;
+    questionNum: number;
+    sentenceWithBlank: string;
+    choices: string[];
+    correctIndex: number;
+    sourceWord?: string;
+}
+export interface VocabInContextQuestion {
+    type: 'vocab-in-context';
+    id: string;
+    questionNum: number;
+    sentence: string;
+    underlinedWord: string;
+    choices: string[];
+    correctIndex: number;
+    sourceWord?: string;
+}
+export interface MultipleChoiceQuestion {
+    type: 'multiple-choice';
+    id: string;
+    questionNum: number;
+    prompt: string;
+    choices: string[];
+    correctIndex: number;
+    explanation?: string;
+}
+export interface CalculationQuestion {
+    type: 'calculation';
+    id: string;
+    questionNum: number;
+    prompt: string;
+    answer: string;
+    acceptedForms?: string[];
+    tolerance?: number;
+    unit?: string;
+    explanation?: string;
+}
+export interface ShortAnswerQuestion {
+    type: 'short-answer';
+    id: string;
+    questionNum: number;
+    prompt: string;
+    referenceAnswer: string;
+    rubric?: string;
+}
+export interface FillInBlankQuestion {
+    type: 'fill-in-the-blank';
+    id: string;
+    questionNum: number;
+    prompt: string;
+    answer: string;
+    acceptedForms?: string[];
+}
+export type ExamQuestion = TranslationQuestion | SentenceCompletionQuestion | VocabInContextQuestion | MultipleChoiceQuestion | CalculationQuestion | ShortAnswerQuestion | FillInBlankQuestion;
+export interface ExamSection {
+    title: string;
+    instructions: string;
+    points: number;
+    questions: ExamQuestion[];
+}
+export interface ExamData {
+    title: string;
+    date: string;
+    sections: ExamSection[];
+    totalPoints: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/exam/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/exam/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,kBAAkB,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,iBAAiB,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,YAAY,GACpB,mBAAmB,GACnB,0BAA0B,GAC1B,sBAAsB,GACtB,sBAAsB,GACtB,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/tools/exam/types.js

@@ -0,0 +1,14 @@
+/**
+ * ExamData shape accepted by the backend's POST /api/notes/from-exam.
+ *
+ * Ported from the frontend repo's
+ * src/frontend/src/components/Chat/tools/exam/types.ts — kept as a verbatim
+ * copy (zero external imports there, so this is safe) rather than shared via
+ * a package, since the MCP server is a separate git repo/npm package with no
+ * dependency path to the frontend. Keep in sync by hand if the frontend
+ * shape changes; the backend's validateExamData
+ * (src/backend/services/examSources/examDataValidator.ts) is the real,
+ * authoritative gate either way.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/exam/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/exam/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/tools/exam.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Exam creation tool for the md-manager MCP server.
+ *
+ * Creates a real, DB-backed exam note (fillable answer markers, hidden answer
+ * key, gradeable via the app's own grading pipeline) from a hand-authored
+ * ExamData object — the same shape the app's AI exam generator produces, so
+ * the resulting note is indistinguishable from one created in-app.
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { NoesisClient } from '../api/NoesisClient.js';
+export declare function registerExamTools(server: McpServer, client: NoesisClient): void;
+//# sourceMappingURL=exam.d.ts.map

package/dist/tools/exam.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exam.d.ts","sourceRoot":"","sources":["../../src/tools/exam.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAuB3D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAuB/E"}

package/dist/tools/exam.js

@@ -0,0 +1,46 @@
+/**
+ * Exam creation tool for the md-manager MCP server.
+ *
+ * Creates a real, DB-backed exam note (fillable answer markers, hidden answer
+ * key, gradeable via the app's own grading pipeline) from a hand-authored
+ * ExamData object — the same shape the app's AI exam generator produces, so
+ * the resulting note is indistinguishable from one created in-app.
+ */
+import { z } from 'zod';
+// Top-level shape is strongly typed; sections[].questions[] is intentionally
+// loose (z.record(z.any())) rather than re-encoding the 7-question-type
+// discriminated union a third time (it already lives in the frontend's
+// types.ts and the backend's examDataValidator.ts) — the backend's
+// validateExamData is the real gate and feedback loop (a malformed shape
+// comes back as a descriptive error with a retry hint, not a silent failure).
+const examSectionShape = z.object({
+    title: z.string().describe('Section heading, e.g. "Technical Architecture"'),
+    instructions: z.string().describe('One-line instructions shown under the section heading'),
+    points: z.number().describe('Total points for this section (individual questions do not carry their own point value)'),
+    questions: z.array(z.record(z.any())).min(1).describe('Array of question objects. Each needs at minimum {type, id, questionNum}. ' +
+        'Supported types: translation {zhPrompt, answerEn}, sentence-completion {sentenceWithBlank, choices[], correctIndex}, ' +
+        'vocab-in-context {sentence, underlinedWord, choices[], correctIndex}, multiple-choice {prompt, choices[], correctIndex}, ' +
+        'calculation {prompt, answer, acceptedForms?, tolerance?, unit?}, short-answer {prompt, referenceAnswer, rubric?}, ' +
+        'fill-in-the-blank {prompt (with "____" placeholders), answer, acceptedForms?}. ' +
+        'Question ids must be unique across the whole exam.'),
+});
+export function registerExamTools(server, client) {
+    // ─── create_exam_note ────────────────────────────────────────
+    server.tool('create_exam_note', 'Create a real, DB-backed exam note — fillable answer-marker boxes at each question, a hidden answer key, and gradeable via the app\'s own grading pipeline (POST /:id/exam/grade). This is the actual "exam" note type the app recognizes (NoteTypeBadge, grading UI) — not just markdown that looks like one. On a malformed examData, returns a descriptive error including a retry hint; fix the shape and call again.', {
+        title: z.string().describe('Exam title, shown as the note\'s H1 heading'),
+        date: z.string().describe('Date string shown under the title, e.g. "2026-07-31"'),
+        totalPoints: z.number().describe('Must equal the sum of all sections\' points'),
+        sections: z.array(examSectionShape).min(1).describe('At least one section, each with at least one question'),
+    }, async (args) => {
+        const examData = args;
+        const result = await client.createExamFromData(examData);
+        const questionCount = Object.keys(result.questionMarks).length;
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Created exam note #${result.noteId}: "${examData.title}" (${examData.totalPoints} points, ${questionCount} question${questionCount === 1 ? '' : 's'} across ${examData.sections.length} section${examData.sections.length === 1 ? '' : 's'}). Fillable answer markers and the hidden answer key are already in place — open the note in the app to answer, then grade via the app's exam UI (or POST /api/notes/${result.noteId}/exam/grade).`
+                }]
+        };
+    });
+}
+//# sourceMappingURL=exam.js.map

package/dist/tools/exam.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exam.js","sourceRoot":"","sources":["../../src/tools/exam.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,6EAA6E;AAC7E,wEAAwE;AACxE,uEAAuE;AACvE,mEAAmE;AACnE,yEAAyE;AACzE,8EAA8E;AAC9E,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IAC5E,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uDAAuD,CAAC;IAC1F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yFAAyF,CAAC;IACtH,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CACnD,4EAA4E;QAC5E,uHAAuH;QACvH,2HAA2H;QAC3H,oHAAoH;QACpH,iFAAiF;QACjF,oDAAoD,CACrD;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAoB;IACvE,gEAAgE;IAChE,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,2ZAA2Z,EAC3Z;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QACzE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;QACjF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;QAC/E,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uDAAuD,CAAC;KAC7G,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,IAAgB,CAAC;QAClC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACzD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC;QAC/D,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,sBAAsB,MAAM,CAAC,MAAM,MAAM,QAAQ,CAAC,KAAK,MAAM,QAAQ,CAAC,WAAW,YAAY,aAAa,YAAY,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,QAAQ,CAAC,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,wKAAwK,MAAM,CAAC,MAAM,eAAe;iBACtb,CAAC;SACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAyC,KAAK,IAAI,EAA2D,MAAM,wBAAwB,CAAC;AAqIjK;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1C;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAejD;AAqBD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CA44F7E;AA0DD;;;;GAIG;AACH,KAAK,YAAY,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAYxF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,EACpB,KAAK,GAAE,OAAe,EACtB,kBAAkB,GAAE,OAAe,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAigBhF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAI9F;AA+DD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE,MAAM,CA2FR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAqBA;AA4SD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAY/E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAyC,KAAK,IAAI,EAA2D,MAAM,wBAAwB,CAAC;AAsIjK;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAC1C;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAejD;AAqBD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CA64F7E;AA0DD;;;;GAIG;AACH,KAAK,YAAY,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAYxF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EAAE,EACnB,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,YAAY,EACpB,KAAK,GAAE,OAAe,EACtB,kBAAkB,GAAE,OAAe,GAClC,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAigBhF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAI9F;AA+DD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GACrE,MAAM,CA2FR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAqBA;AA4SD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAY/E"}

package/dist/tools/index.js

@@ -13,6 +13,7 @@ import { initEmbeddingService, generateEmbedding, generateEmbeddingsBatch } from
 import { SyncStateManager, determineSyncDirection } from './SyncStateManager.js';
 import { registerNaviTools } from './navis.js';
 import { registerBacklogTools } from './backlog.js';
+import { registerExamTools } from './exam.js';
 import { suggestOtherOsPath } from '../utils/suggestPath.js';
 import { diff3Merge, diffPatch } from 'node-diff3';
 // ============================================
@@ -185,6 +186,7 @@ export function registerTools(server, services) {
     // Register Navi management tools
     registerNaviTools(server, client);
     registerBacklogTools(server, client);
+    registerExamTools(server, client);
     // Register search_notes tool
     server.tool('search_notes', 'Search your knowledge base using full-text search. Returns relevant notes ranked by BM25 relevance.', {
         query: z.string().describe('Search query (natural language or keywords)'),