@tinyweb_dev/oe-exam-sdk 0.1.0

package/dist/mcp/http-client.js

@@ -0,0 +1,49 @@
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { loadMcpConfig } from './config.js';
+export async function mcpRequest(opts) {
+    const config = loadMcpConfig();
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), config.OE_HTTP_TIMEOUT_MS);
+    try {
+        const response = await fetch(`${config.OE_API_URL}${opts.url}`, {
+            method: opts.method,
+            signal: controller.signal,
+            headers: {
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+                ...authHeaders(config.OE_API_TOKEN),
+            },
+            body: opts.body === undefined ? undefined : JSON.stringify(opts.body),
+        });
+        const text = await response.text();
+        const data = text ? JSON.parse(text) : undefined;
+        if (!response.ok) {
+            const message = getErrorMessage(data) ?? response.statusText;
+            const code = response.status === 400 || response.status === 404 || response.status === 422 ? ErrorCode.InvalidParams : ErrorCode.InternalError;
+            throw new McpError(code, `[${opts.method} ${opts.url}] ${response.status}: ${message}`);
+        }
+        return data;
+    }
+    catch (error) {
+        if (error instanceof McpError)
+            throw error;
+        throw new McpError(ErrorCode.InternalError, error instanceof Error ? error.message : 'Unknown HTTP error');
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+function authHeaders(token) {
+    if (!token)
+        return {};
+    return token.startsWith('oeexam_') ? { 'X-API-Key': token } : { Authorization: `Bearer ${token}` };
+}
+function getErrorMessage(data) {
+    if (!data || typeof data !== 'object')
+        return undefined;
+    const message = data.message;
+    if (Array.isArray(message))
+        return message.join('; ');
+    return typeof message === 'string' ? message : undefined;
+}
+//# sourceMappingURL=http-client.js.map

package/dist/mcp/http-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/mcp/http-client.ts"],"names":[],"mappings":"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"}

package/dist/mcp/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+export declare function startOeExamMcpServer(): Promise<void>;
+export { loadMcpConfig } from './config.js';
+export { registerAllMcpTools } from './tools/index.js';
+export { registerExamTools } from './tools/exams.js';
+export { registerResultTools } from './tools/results.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AAMA,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB1D;AASD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadMcpConfig } from './config.js';
+import { registerAllMcpTools } from './tools/index.js';
+export async function startOeExamMcpServer() {
+    const config = loadMcpConfig();
+    const server = new McpServer({ name: config.packageName, version: config.packageVersion }, {
+        capabilities: { tools: {}, logging: {} },
+        instructions: 'OE Exam MCP server. Use exam_json_template_generate then exam_create_from_json to create an exam, and exam_result_get to view a result review.',
+    });
+    registerAllMcpTools(server);
+    await server.connect(new StdioServerTransport());
+    const shutdown = async () => {
+        await server.close().catch((error) => console.error('[oe-exam-mcp] server.close failed', error));
+        process.exit(0);
+    };
+    process.on('SIGINT', () => void shutdown());
+    process.on('SIGTERM', () => void shutdown());
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    startOeExamMcpServer().catch((error) => {
+        console.error('[oe-exam-mcp] Fatal startup error', error);
+        process.exit(1);
+    });
+}
+export { loadMcpConfig } from './config.js';
+export { registerAllMcpTools } from './tools/index.js';
+export { registerExamTools } from './tools/exams.js';
+export { registerResultTools } from './tools/results.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,EAAE,EAC5D;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACxC,YAAY,EAAE,gJAAgJ;KAC/J,CACF,CAAC;IAEF,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IAEjD,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpD,oBAAoB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACrC,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mcp/tools/_helpers.d.ts

@@ -0,0 +1,5 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare function buildToolResult<T>(value: T): CallToolResult;
+export declare function wrapHandler<TInput extends Record<string, unknown>>(toolName: string, fn: (input: TInput) => Promise<CallToolResult>): (input: TInput) => Promise<CallToolResult>;
+export declare function unwrapData<T>(value: unknown): T;
+//# sourceMappingURL=_helpers.d.ts.map

package/dist/mcp/tools/_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,cAAc,CAK3D;AAED,wBAAgB,WAAW,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAC7C,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAU5C;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAG/C"}

package/dist/mcp/tools/_helpers.js

@@ -0,0 +1,26 @@
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+export function buildToolResult(value) {
+    return {
+        content: [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }],
+        ...(value && typeof value === 'object' ? { structuredContent: value } : {}),
+    };
+}
+export function wrapHandler(toolName, fn) {
+    return async (input) => {
+        try {
+            return await fn(input);
+        }
+        catch (error) {
+            if (error instanceof McpError)
+                throw error;
+            console.error(`[oe-exam-mcp] ${toolName} failed`, error);
+            throw new McpError(ErrorCode.InternalError, error instanceof Error ? error.message : 'Unknown error');
+        }
+    };
+}
+export function unwrapData(value) {
+    if (value && typeof value === 'object' && 'data' in value)
+        return value.data;
+    return value;
+}
+//# sourceMappingURL=_helpers.js.map

package/dist/mcp/tools/_helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_helpers.js","sourceRoot":"","sources":["../../../src/mcp/tools/_helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,UAAU,eAAe,CAAI,KAAQ;IACzC,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QACrG,GAAG,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAgC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,EAA8C;IAE9C,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACrB,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,QAAQ;gBAAE,MAAM,KAAK,CAAC;YAC3C,OAAO,CAAC,KAAK,CAAC,iBAAiB,QAAQ,SAAS,EAAE,KAAK,CAAC,CAAC;YACzD,MAAM,IAAI,QAAQ,CAAC,SAAS,CAAC,aAAa,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;QACxG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,KAAc;IAC1C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK;QAAE,OAAQ,KAAqB,CAAC,IAAI,CAAC;IAC9F,OAAO,KAAU,CAAC;AACpB,CAAC"}

package/dist/mcp/tools/exams.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerExamTools(server: McpServer): void;
+//# sourceMappingURL=exams.d.ts.map

package/dist/mcp/tools/exams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exams.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/exams.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsJzD"}

package/dist/mcp/tools/exams.js

@@ -0,0 +1,440 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { z } from 'zod';
+import { mcpRequest } from '../http-client.js';
+import { buildToolResult, unwrapData, wrapHandler } from './_helpers.js';
+const questionSchema = z.record(z.string(), z.unknown()).describe('Full API question payload or short form: { question, options, answer, points?, partId?, partNo? }.');
+const partSchema = z.record(z.string(), z.unknown()).describe('Part payload: { name?, partId?, questions: [...] }.');
+const templateSchema = z.record(z.string(), z.unknown()).describe('Template payload accepted by PATCH /manage/exams/:id/template.');
+const examLevelSchema = z.enum(['PRE_A1', 'A1', 'A2', 'B1', 'B2', 'C1', 'C2']);
+export function registerExamTools(server) {
+    server.registerTool('exam_templates_search', {
+        title: 'Search exam templates',
+        description: 'Search available OE Exam templates. Use this before exam_create_with_questions to choose examTemplateId.',
+        inputSchema: {
+            search: z.string().optional().describe('Template name keyword.'),
+            page: z.number().int().positive().default(1).describe('1-based page number.'),
+            limit: z.number().int().positive().max(50).default(9).describe('Page size sent as API size.'),
+        },
+    }, wrapHandler('exam_templates_search', async (input) => {
+        const query = new URLSearchParams({ page: String(input.page ?? 1), size: String(input.limit ?? 9) });
+        if (input.search)
+            query.set('filter', `name:like:${input.search}`);
+        const result = await mcpRequest({ method: 'GET', url: `/api/v1/exam-templates?${query}` });
+        return buildToolResult({ templates: unwrapList(result) });
+    }));
+    server.registerTool('exam_template_get', {
+        title: 'Get exam template',
+        description: 'Get one OE Exam template by id. The returned templatePayload can be passed as template to exam_create_with_questions.',
+        inputSchema: {
+            id: z.string().min(1).describe('Template id from exam_templates_search.'),
+        },
+    }, wrapHandler('exam_template_get', async (input) => {
+        const template = unwrapData(await mcpRequest({ method: 'GET', url: `/api/v1/exam-templates/${encodeURIComponent(String(input.id))}` }));
+        return buildToolResult({ template, templatePayload: toTemplatePayload(template) });
+    }));
+    server.registerTool('exam_question_template_get', {
+        title: 'Get question payload template',
+        description: 'Return easy-to-fill question JSON templates for exam_create_with_questions. Use this before creating questions if you need the expected shape.',
+        inputSchema: {
+            templateId: z.string().min(1).optional().describe('Template id. If provided, generate question payloads from template.parts.'),
+            type: z.string().default('CHOOSE_THE_CORRECT_ANSWER').describe('Fallback question type when templateId is omitted.'),
+            count: z.number().int().positive().max(100).default(1).describe('Fallback count when templateId is omitted.'),
+            partId: z.union([z.string(), z.number()]).default(1),
+            partNo: z.number().int().positive().default(1),
+            skill: z.string().default('READING'),
+        },
+    }, wrapHandler('exam_question_template_get', async (input) => {
+        const template = typeof input.templateId === 'string'
+            ? unwrapData(await mcpRequest({ method: 'GET', url: `/api/v1/exam-templates/${encodeURIComponent(input.templateId)}` }))
+            : undefined;
+        return buildToolResult({
+            usage: 'Pass questions directly into exam_create_with_questions.questions. Fill content/correctAnswer for each generated API-format payload.',
+            templateId: template?.id,
+            questions: template ? questionsFromTemplate(template) : fallbackQuestions(input),
+        });
+    }));
+    server.registerTool('exam_json_template_generate', {
+        title: 'Get exam JSON template',
+        description: 'Generate a user-friendly examJson skeleton from templateTitle or templateId. Edit this JSON, then pass it to exam_create_from_json.',
+        inputSchema: {
+            templateTitle: z.string().optional().describe('Template title to search, e.g. Achievers 2026 Round 1.'),
+            templateId: z.string().optional().describe('Exact template id. Preferred when known.'),
+            name: z.string().optional().describe('Exam name to put in the JSON.'),
+            examLevel: examLevelSchema.optional().describe('Optional exam level for the generated JSON.'),
+            difficulty: z.enum(['EASY', 'MEDIUM', 'HARD']).optional().describe('Optional difficulty for the generated JSON.'),
+            durationMinutes: z.number().int().positive().optional().describe('Optional duration for the generated JSON.'),
+        },
+    }, wrapHandler('exam_json_template_generate', async (input) => {
+        const template = await resolveTemplate({ templateId: input.templateId, templateTitle: input.templateTitle });
+        const examJson = examJsonTemplate(template, input);
+        const examJsonString = JSON.stringify(examJson, null, 2);
+        const filePath = resolve(`${slugFromTitle(String(input.name ?? template.title ?? template.name ?? 'exam'))}.json`);
+        await mkdir(dirname(filePath), { recursive: true });
+        await writeFile(filePath, `${examJsonString}\n`, 'utf8');
+        return buildToolResult({
+            usage: 'Edit filePath, then call exam_create_from_json with the edited JSON string.',
+            templateId: template.id,
+            templateTitle: template.title ?? template.name,
+            filePath,
+            examJson,
+            examJsonString,
+        });
+    }));
+    server.registerTool('exam_create_from_json', {
+        title: 'Create exam from JSON',
+        description: 'Create an exam from a user-friendly JSON payload grouped by parts. Searches template by title, patches template, maps questions to template.parts, then creates questions.',
+        inputSchema: {
+            examJson: z.string().optional().describe('JSON string with { name, templateTitle/templateId, parts: [{ questions: [...] }] }. Use this for copy/paste.'),
+            exam: z.record(z.string(), z.unknown()).optional().describe('Same payload as object if the client supports object arguments.'),
+        },
+    }, wrapHandler('exam_create_from_json', async (input) => {
+        const examInput = parseExamJsonInput(input.examJson, input.exam);
+        const template = await resolveTemplate(examInput);
+        const questions = questionsFromExamJson(examInput, template);
+        const payload = examPayloadFromJson(examInput, template.id, questions);
+        const exam = unwrapData(await mcpRequest({ method: 'POST', url: '/api/v1/manage/exams', body: payload.exam }));
+        await mcpRequest({ method: 'PATCH', url: `/api/v1/manage/exams/${encodeURIComponent(exam.id)}/template`, body: { template: toTemplatePayload(template) } });
+        const savedQuestions = questions.length === 0 ? null : await mcpRequest({ method: 'POST', url: '/api/v1/manage/questions/batch', body: { examId: exam.id, questions } });
+        return buildToolResult({ exam, templateId: template.id, questions: savedQuestions, generatedQuestionCount: questions.length });
+    }));
+    server.registerTool('exam_create_with_questions', {
+        title: 'Create exam with questions',
+        description: 'Create an exam, optionally patch template, then bulk create questions via /api/v1/manage/questions/batch. If you do not know examTemplateId/template, call exam_templates_search then exam_template_get first.',
+        inputSchema: {
+            name: z.string().min(1),
+            code: z.string().min(1).optional(),
+            examLevel: examLevelSchema.optional().describe('Valid exam level only: PRE_A1, A1, A2, B1, B2, C1, C2. Do not use template title/id here.'),
+            difficulty: z.enum(['EASY', 'MEDIUM', 'HARD']).optional(),
+            totalScore: z.number().nonnegative().optional(),
+            durationMinutes: z.number().int().positive().optional(),
+            description: z.string().optional(),
+            isComplete: z.boolean().optional(),
+            isActive: z.boolean().optional(),
+            examTemplateId: z.string().min(1).optional(),
+            template: templateSchema.optional(),
+            questions: z.array(questionSchema).default([]),
+        },
+    }, wrapHandler('exam_create_with_questions', async (input) => {
+        const { template, questions, ...examPayload } = input;
+        const exam = unwrapData(await mcpRequest({ method: 'POST', url: '/api/v1/manage/exams', body: clean(examPayload) }));
+        const templatePayload = isNonEmptyRecord(template) ? template : await getTemplatePayload(examPayload.examTemplateId);
+        if (isNonEmptyRecord(templatePayload)) {
+            await mcpRequest({ method: 'PATCH', url: `/api/v1/manage/exams/${encodeURIComponent(exam.id)}/template`, body: { template: templatePayload } });
+        }
+        const normalizedQuestions = questions.map(normalizeQuestion);
+        const savedQuestions = normalizedQuestions.length === 0 ? null : await mcpRequest({ method: 'POST', url: '/api/v1/manage/questions/batch', body: { examId: exam.id, questions: normalizedQuestions } });
+        return buildToolResult({ exam, questions: savedQuestions });
+    }));
+}
+function clean(input) {
+    return Object.fromEntries(Object.entries(input).filter(([, value]) => value !== undefined));
+}
+function isNonEmptyRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value) && Object.keys(value).length > 0);
+}
+function parseExamJsonInput(examJson, exam) {
+    if (isNonEmptyRecord(exam))
+        return exam;
+    if (typeof examJson !== 'string' || !examJson.trim())
+        throw new Error('examJson or exam is required');
+    const parsed = JSON.parse(examJson);
+    if (!isNonEmptyRecord(parsed))
+        throw new Error('examJson must be a JSON object');
+    return parsed;
+}
+async function resolveTemplate(input) {
+    const templateId = stringOrUndefined(input.templateId);
+    if (templateId)
+        return unwrapData(await mcpRequest({ method: 'GET', url: `/api/v1/exam-templates/${encodeURIComponent(templateId)}` }));
+    const templateTitle = stringOrUndefined(input.templateTitle);
+    if (!templateTitle)
+        throw new Error('templateTitle or templateId is required');
+    const query = new URLSearchParams({ page: '1', size: '10', filter: `name:like:${templateTitle}` });
+    const templates = unwrapList(await mcpRequest({ method: 'GET', url: `/api/v1/exam-templates?${query}` }));
+    const exact = templates.find((template) => (template.title ?? template.name) === templateTitle);
+    const template = exact ?? templates[0];
+    if (!template?.id)
+        throw new Error(`No exam template found for title: ${templateTitle}`);
+    return unwrapData(await mcpRequest({ method: 'GET', url: `/api/v1/exam-templates/${encodeURIComponent(template.id)}` }));
+}
+function examPayloadFromJson(input, templateId, questions) {
+    return {
+        exam: clean({
+            name: stringValue(input.name, 'New OE Exam'),
+            code: stringOrUndefined(input.code) ?? codeFromName(stringValue(input.name, 'New OE Exam')),
+            totalScore: numberValue(input.totalScore, questions.length || 100),
+            description: stringOrUndefined(input.description) ?? stringOrUndefined(input.templateTitle) ?? '',
+            isComplete: booleanValue(input.isComplete, false),
+            isActive: booleanValue(input.isActive, false),
+            examTemplateId: templateId,
+            examLevel: validExamLevel(input.examLevel),
+            difficulty: validDifficulty(input.difficulty),
+            durationMinutes: numberOrUndefined(input.durationMinutes),
+        }),
+    };
+}
+function examJsonTemplate(template, options) {
+    const parts = Array.isArray(template.parts) ? template.parts.filter(isNonEmptyRecord) : [];
+    return {
+        name: stringValue(options.name, `${template.title ?? template.name ?? 'OE Exam'} Draft`),
+        templateId: template.id,
+        templateTitle: template.title ?? template.name,
+        totalScore: numberValue(template.totalScore ?? template.total_questions, totalQuestionCount(parts)),
+        examLevel: validExamLevel(options.examLevel) ?? validExamLevel(template.examLevel ?? template.exam_level ?? template.level) ?? 'A1',
+        difficulty: validDifficulty(options.difficulty) ?? 'MEDIUM',
+        durationMinutes: numberValue(options.durationMinutes, 45),
+        isComplete: false,
+        isActive: false,
+        parts: parts.map((part, index) => examJsonPartTemplate(part, index)),
+    };
+}
+function examJsonPartTemplate(part, index) {
+    const startIndex = numberValue(part.startIndex, 0);
+    const count = numberValue(part.questionCount, numberValue(part.endIndex, startIndex) - startIndex + 1);
+    return {
+        id: part.id ?? index + 1,
+        name: part.name ?? `Part ${index + 1}`,
+        questionType: stringValue(part.questionType, 'CHOOSE_THE_CORRECT_ANSWER'),
+        skill: stringValue(part.skill, 'READING'),
+        questions: Array.from({ length: Math.max(count, 0) }, (_, offset) => simpleQuestionTemplate(part, startIndex + offset + 1)),
+    };
+}
+function simpleQuestionTemplate(part, questionNumber) {
+    const questionType = stringValue(part.questionType, 'CHOOSE_THE_CORRECT_ANSWER');
+    const options = (Array.isArray(part.defaultValue) && part.defaultValue.length > 0
+        ? part.defaultValue
+        : Array.from({ length: numberValue(part.optionCount, 4) }, (_, index) => String.fromCharCode(65 + index))).map(String);
+    if (questionType.includes('FILL') || questionType.includes('WRITE'))
+        return { question: `Question ${questionNumber}`, answer: '' };
+    if (questionType.includes('SPEAK'))
+        return { prompt: `Question ${questionNumber}`, expectedAnswer: '' };
+    return { question: `Question ${questionNumber}`, options, answer: options[0] ?? 'A' };
+}
+function totalQuestionCount(parts) {
+    return parts.reduce((total, part) => total + numberValue(part.questionCount, 0), 0);
+}
+function questionsFromExamJson(input, template) {
+    const templateParts = Array.isArray(template.parts) ? template.parts.filter(isNonEmptyRecord) : [];
+    const parts = Array.isArray(input.parts) ? input.parts.filter(isNonEmptyRecord) : [{ questions: input.questions }];
+    return parts.flatMap((part, partIndex) => {
+        const templatePart = findTemplatePart(part, templateParts, partIndex);
+        const questions = Array.isArray(part.questions) ? part.questions.filter(isNonEmptyRecord) : [];
+        return questions.map((question, questionIndex) => questionFromPart(question, templatePart, partIndex, questionIndex));
+    });
+}
+function findTemplatePart(part, templateParts, index) {
+    const partId = stringOrUndefined(part.partId ?? part.id);
+    const name = stringOrUndefined(part.name);
+    return templateParts.find((item) => String(item.id) === partId)
+        ?? templateParts.find((item) => typeof item.name === 'string' && item.name === name)
+        ?? templateParts[index]
+        ?? { id: index + 1, questionType: 'CHOOSE_THE_CORRECT_ANSWER', skill: 'READING', optionCount: 4 };
+}
+function questionFromPart(question, part, partIndex, questionIndex) {
+    const startIndex = numberValue(part.startIndex, 0);
+    const base = questionPayload({
+        questionType: stringValue(question.questionType ?? question.type ?? part.questionType, 'CHOOSE_THE_CORRECT_ANSWER'),
+        questionNumber: numberValue(question.questionNumber, startIndex + questionIndex + 1),
+        partId: String(question.partId ?? part.id ?? partIndex + 1),
+        partNo: numberValue(question.partNo, partIndex + 1),
+        sectionId: numberOrUndefined(question.sectionId ?? part.sectionId),
+        skill: stringValue(question.questionSkillType ?? question.skill ?? part.skill, 'READING'),
+        optionCount: numberValue(part.optionCount, 4),
+        defaultValue: Array.isArray(part.defaultValue) ? part.defaultValue : undefined,
+    });
+    return normalizeQuestion(applySimpleQuestionFields({ ...base, ...question }), questionIndex);
+}
+function applySimpleQuestionFields(question) {
+    const content = isNonEmptyRecord(question.content) ? { ...question.content } : {};
+    if (typeof question.question === 'string')
+        content.question = question.question;
+    if (typeof question.text === 'string')
+        content.question = question.text;
+    if (Array.isArray(question.options)) {
+        content.optionType = content.optionType ?? 'text';
+        content.options = question.options;
+    }
+    return clean({
+        ...question,
+        content: isNonEmptyRecord(content) ? content : question.content,
+        correctAnswer: question.answer === undefined && question.expectedAnswer === undefined
+            ? question.correctAnswer
+            : simpleCorrectAnswer(question.questionType, question.answer ?? question.expectedAnswer, content.options),
+    });
+}
+function simpleCorrectAnswer(questionType, answer, options) {
+    if (answer === undefined)
+        return undefined;
+    const type = String(questionType ?? '');
+    if (type.includes('FILL') || type.includes('WRITE'))
+        return { answers: [String(answer)] };
+    if (type.includes('SPEAK'))
+        return { expectedAnswer: String(answer) };
+    return { answer: answerIndexFromOptions(answer, options) };
+}
+function answerIndexFromOptions(answer, options) {
+    if (typeof answer === 'string' && Array.isArray(options)) {
+        const index = options.map(String).findIndex((option) => option === answer);
+        if (index >= 0)
+            return index;
+    }
+    return answerIndex(answer);
+}
+function codeFromName(name) {
+    return name.toUpperCase().replace(/[^A-Z0-9]+/g, '_').replace(/^_|_$/g, '').slice(0, 40) || 'OE_EXAM';
+}
+function slugFromTitle(title) {
+    return title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '').slice(0, 80) || 'exam';
+}
+function stringOrUndefined(value) {
+    return typeof value === 'string' && value ? value : undefined;
+}
+function booleanValue(value, fallback) {
+    return typeof value === 'boolean' ? value : fallback;
+}
+function validExamLevel(value) {
+    return typeof value === 'string' && examLevelSchema.safeParse(value).success ? value : undefined;
+}
+function validDifficulty(value) {
+    return typeof value === 'string' && ['EASY', 'MEDIUM', 'HARD'].includes(value) ? value : undefined;
+}
+function normalizeQuestion(question, index) {
+    if (question.questionType)
+        return clean({
+            ...question,
+            partId: question.partId === undefined ? undefined : String(question.partId),
+            partNo: question.partNo ?? 1,
+            questionNumber: question.questionNumber ?? index + 1,
+            points: question.points ?? 1,
+            addToQuestionBank: question.addToQuestionBank ?? false,
+            isExample: question.isExample ?? false,
+        });
+    const options = Array.isArray(question.options) ? question.options : ['A', 'B', 'C', 'D'];
+    return clean({
+        questionType: question.type ?? 'CHOOSE_THE_CORRECT_ANSWER',
+        content: question.content ?? {
+            question: String(question.question ?? question.text ?? `Question ${index + 1}`),
+            optionType: 'text',
+            options,
+        },
+        correctAnswer: question.correctAnswer ?? { answer: answerIndex(question.answer ?? question.correctAnswerIndex ?? 0) },
+        points: question.points ?? 1,
+        explanation: question.explanation ?? '',
+        questionNumber: question.questionNumber ?? index + 1,
+        partId: String(question.partId ?? 1),
+        partNo: question.partNo ?? 1,
+        sectionId: question.sectionId,
+        questionSkillType: question.questionSkillType ?? question.skill ?? 'READING',
+        addToQuestionBank: question.addToQuestionBank ?? false,
+        isExample: question.isExample ?? false,
+    });
+}
+function answerIndex(value) {
+    if (typeof value === 'number')
+        return value;
+    if (typeof value === 'string' && /^[A-E]$/i.test(value))
+        return value.toUpperCase().charCodeAt(0) - 65;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function fallbackQuestions(input) {
+    return Array.from({ length: Number(input.count ?? 1) }, (_, index) => questionPayload({
+        questionType: String(input.type ?? 'CHOOSE_THE_CORRECT_ANSWER'),
+        questionNumber: index + 1,
+        partId: String(input.partId ?? 1),
+        partNo: Number(input.partNo ?? 1),
+        skill: String(input.skill ?? 'READING'),
+    }));
+}
+function questionsFromTemplate(template) {
+    const parts = Array.isArray(template.parts) ? template.parts.filter(isNonEmptyRecord) : [];
+    return parts.flatMap((part, partIndex) => {
+        const startIndex = numberValue(part.startIndex, 0);
+        const count = numberValue(part.questionCount, numberValue(part.endIndex, startIndex) - startIndex + 1);
+        return Array.from({ length: Math.max(count, 0) }, (_, offset) => questionPayload({
+            questionType: stringValue(part.questionType, 'CHOOSE_THE_CORRECT_ANSWER'),
+            questionNumber: startIndex + offset + 1,
+            partId: String(part.id ?? partIndex + 1),
+            partNo: partIndex + 1,
+            sectionId: numberOrUndefined(part.sectionId),
+            skill: stringValue(part.skill, 'READING'),
+            optionCount: numberValue(part.optionCount, 4),
+            defaultValue: Array.isArray(part.defaultValue) ? part.defaultValue : undefined,
+        }));
+    });
+}
+function questionPayload(input) {
+    return clean({
+        questionType: input.questionType,
+        content: contentTemplate(input.questionType, input.questionNumber, input.optionCount, input.defaultValue),
+        correctAnswer: correctAnswerTemplate(input.questionType),
+        points: 1,
+        explanation: '',
+        questionNumber: input.questionNumber,
+        partId: input.partId,
+        partNo: input.partNo,
+        sectionId: input.sectionId,
+        questionSkillType: input.skill,
+        addToQuestionBank: false,
+        isExample: false,
+    });
+}
+function contentTemplate(questionType, questionNumber, optionCount = 4, defaultValue) {
+    const options = (defaultValue?.length ? defaultValue : Array.from({ length: optionCount }, (_, index) => String.fromCharCode(65 + index))).map(String);
+    if (questionType.includes('FILL') || questionType.includes('WRITE'))
+        return { question: `Question ${questionNumber}`, text: '' };
+    if (questionType.includes('SPEAK'))
+        return { prompt: `Question ${questionNumber}` };
+    if (questionType.includes('LISTEN'))
+        return { question: `Question ${questionNumber}`, audioUrl: '', optionType: 'text', options };
+    return { question: `Question ${questionNumber}`, optionType: 'text', options };
+}
+function correctAnswerTemplate(questionType) {
+    if (questionType.includes('FILL') || questionType.includes('WRITE'))
+        return { answers: [''] };
+    if (questionType.includes('SPEAK'))
+        return { expectedAnswer: '' };
+    return { answer: 0 };
+}
+function stringValue(value, fallback) {
+    return typeof value === 'string' && value ? value : fallback;
+}
+function numberValue(value, fallback) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : fallback;
+}
+function numberOrUndefined(value) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function unwrapList(value) {
+    const data = unwrapData(value);
+    if (Array.isArray(data))
+        return data;
+    if (data && typeof data === 'object' && 'data' in data && Array.isArray(data.data))
+        return data.data;
+    return [];
+}
+async function getTemplatePayload(id) {
+    if (typeof id !== 'string' || !id)
+        return undefined;
+    const template = unwrapData(await mcpRequest({ method: 'GET', url: `/api/v1/exam-templates/${encodeURIComponent(id)}` }));
+    return toTemplatePayload(template);
+}
+function toTemplatePayload(template) {
+    const parts = Array.isArray(template.parts) ? template.parts : [];
+    return clean({
+        id: template.id,
+        title: template.title ?? template.name,
+        subTitle: template.subTitle ?? template.sub_title ?? '',
+        theme: template.theme,
+        totalQuestions: template.totalQuestions ?? template.total_questions,
+        totalParts: template.totalParts ?? template.total_parts ?? parts.length,
+        description: template.description ?? '',
+        examLevel: template.examLevel ?? template.exam_level ?? template.level ?? '',
+        type: template.type ?? null,
+        parts,
+    });
+}
+//# sourceMappingURL=exams.js.map