blackboard-upc 1.0.7 → 1.0.8

package/CHANGELOG.md

@@ -4,6 +4,16 @@ All notable changes to `blackboard-upc` will be documented here.
 
 ---
 
+## [1.0.8] — 2026-04-19
+
+### Added
+- **Soporte para preguntas `fimb`** (fill-in-multiple-blanks) en `get_quiz_questions`, `save_quiz_answer` y el tipo `QuizQuestion`:
+  - `QuizQuestion.blanks` — array con los nombres de los blanks (ej. `["BLANK-1", "BLANK-2"]`)
+  - `QuizQuestion.currentAnswer` — para fimb, devuelve `Record<string, string|null>` con el valor actual de cada blank
+  - `save_quiz_answer` ahora acepta un JSON string con el mapa `{blankName: value}` (ej. `'{"BLANK-1":"1438.62","BLANK-2":"140.62"}'`)
+
+---
+
 ## [1.0.7] — 2026-04-12
 
 ### Added

package/CLAUDE.md

@@ -33,6 +33,14 @@ If you get `Not authenticated`, ask the user to run `blackboard login`.
 4. submit_quiz (confirm first!)          → finalize and submit the attempt
 ```
 
+Supported question types in `save_quiz_answer`:
+
+| `question.type`   | `answer` format                                                                |
+|-------------------|--------------------------------------------------------------------------------|
+| `eitherOr`        | boolean (`true` = Verdadero, `false` = Falso)                                  |
+| `multipleanswer`  | number — 0-based index of the chosen option                                    |
+| `fimb`            | JSON string `'{"BLANK-1":"value1","BLANK-2":"value2"}'` — read names from `question.blanks` |
+
 ### Feedback workflow
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blackboard-upc",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "CLI no oficial para UPC Aula Virtual (Blackboard Learn) — acceso desde la terminal y MCP para Claude",
   "main": "run.js",
   "bin": {

package/src/api/quiz.ts

@@ -25,7 +25,7 @@ export interface QuizOption {
   index: number;
 }
 
-export type QuizQuestionType = 'eitherOr' | 'multipleanswer' | 'presentation' | string;
+export type QuizQuestionType = 'eitherOr' | 'multipleanswer' | 'fimb' | 'presentation' | string;
 
 export interface QuizQuestion {
   /** Question attempt ID — used as the URL segment for saving answers */
@@ -34,18 +34,21 @@ export interface QuizQuestion {
   questionId: string;
   /** Position within the quiz (1-based visible number) */
   position: number;
-  /** 'eitherOr' = true/false, 'multipleanswer' = MC, 'presentation' = text only */
+  /** 'eitherOr' = true/false, 'multipleanswer' = MC, 'fimb' = fill-in-multiple-blanks, 'presentation' = text only */
   type: QuizQuestionType;
   /** Plain text of the question (HTML stripped) */
   text: string;
   points: number;
   /** Answer options (present for eitherOr and multipleanswer) */
   options?: QuizOption[];
+  /** Blank names in order (present for fimb), e.g. ['BLANK-1', 'BLANK-2'] */
+  blanks?: string[];
   /** Currently saved answer:
    *   - eitherOr:       true | false | null
    *   - multipleanswer: boolean[] (one per option, in options order)
+   *   - fimb:           Record<string, string|null> (one per blank)
    */
-  currentAnswer?: boolean | boolean[] | null;
+  currentAnswer?: boolean | boolean[] | Record<string, string | null> | null;
   /** Raw question object from API (needed when saving eitherOr answers) */
   _raw: any;
 }
@@ -76,6 +79,8 @@ function parseQuestionAttempt(qa: any, idx: number): QuizQuestion {
   const text = stripHtml(q.questionText?.rawText || q.questionText?.displayText || '');
 
   let options: QuizOption[] | undefined;
+  let blanks: string[] | undefined;
+  let currentAnswer: QuizQuestion['currentAnswer'] = qa.givenAnswer ?? null;
 
   if (qa.questionType === 'eitherOr') {
     // True/False — always two options
@@ -89,6 +94,10 @@ function parseQuestionAttempt(qa: any, idx: number): QuizQuestion {
       text: stripHtml(a.answerText?.rawText || a.answerText?.displayText || ''),
       index: i,
     }));
+  } else if (qa.questionType === 'fimb' && qa.givenAnswers && typeof qa.givenAnswers === 'object') {
+    // Fill-in-multiple-blanks — blank names come from givenAnswers keys (e.g. BLANK-1, BLANK-2)
+    blanks = Object.keys(qa.givenAnswers);
+    currentAnswer = qa.givenAnswers as Record<string, string | null>;
   }
 
   return {
@@ -99,7 +108,8 @@ function parseQuestionAttempt(qa: any, idx: number): QuizQuestion {
     text,
     points: q.points ?? 0,
     options,
-    currentAnswer: qa.givenAnswer ?? null,
+    blanks,
+    currentAnswer,
     _raw: qa,
   };
 }
@@ -165,13 +175,14 @@ export async function getQuizQuestions(
  *   - eitherOr:       boolean  (true = Verdadero, false = Falso)
  *   - multipleanswer: number   (0-based index of the selected option)
  *                    OR boolean[] (one per option)
+ *   - fimb:           Record<string, string>  (one value per blank name, e.g. { "BLANK-1": "1438.62", "BLANK-2": "140.62" })
  */
 export async function saveQuizAnswer(
   client: AxiosInstance,
   courseId: string,
   attemptId: string,
   question: QuizQuestion,
-  answer: boolean | number | boolean[]
+  answer: boolean | number | boolean[] | Record<string, string>
 ): Promise<any> {
   const url = `/learn/api/v1/courses/${courseId}/gradebook/attempts/${attemptId}/assessment/answers/${question.questionAttemptId}`;
 
@@ -203,6 +214,28 @@ export async function saveQuizAnswer(
       order: question._raw.order || [],
       question: question._raw.question,
     };
+  } else if (question.type === 'fimb') {
+    if (typeof answer !== 'object' || Array.isArray(answer) || answer === null) {
+      throw new Error(
+        `fimb answers must be a Record<string, string> mapping blank name to value. ` +
+        `Expected blanks: ${question.blanks?.join(', ') || '(unknown)'}`
+      );
+    }
+
+    // Build givenAnswers using the question's known blank names — preserves order and
+    // ensures any blank not provided ends up as null (consistent with Blackboard behavior).
+    const blanks = question.blanks ?? Object.keys(answer);
+    const givenAnswers: Record<string, string | null> = {};
+    for (const name of blanks) {
+      const val = (answer as Record<string, string>)[name];
+      givenAnswers[name] = val !== undefined ? String(val) : null;
+    }
+
+    body = {
+      questionType: 'fimb',
+      givenAnswers,
+      question: question._raw.question,
+    };
   } else {
     throw new Error(`Unsupported question type: ${question.type}`);
   }

package/src/mcp/server.ts

@@ -400,20 +400,45 @@ export async function startMcpServer() {
       description:
         'Save a single answer for a quiz question (does NOT submit — use submit_quiz to finalize). ' +
         'question is the full question object from get_quiz_questions. ' +
-        'answer: boolean for true/false, or 0-based index number for multiple-choice.',
+        'answer format depends on question.type:\n' +
+        '  - eitherOr (true/false):       boolean (true = Verdadero)\n' +
+        '  - multipleanswer (MC):         number (0-based index of the chosen option)\n' +
+        '  - fimb (fill-in-multi-blanks): JSON string of an object mapping blank names to values, ' +
+        'e.g. \'{"BLANK-1":"1438.62","BLANK-2":"140.62"}\' (read blank names from question.blanks)',
       inputSchema: {
         courseId: z.string().describe('Course ID'),
         attemptId: z.string().describe('Quiz attempt ID (e.g. _94898825_1)'),
         question: z.string().describe('JSON string of the question object from get_quiz_questions'),
-        answer: z.union([z.boolean(), z.number()]).describe(
-          'For true/false: true or false. For multiple-choice: 0-based index of selected option.'
+        answer: z.union([z.boolean(), z.number(), z.string()]).describe(
+          'eitherOr: true/false. multipleanswer: 0-based index. ' +
+          'fimb: JSON string of {blankName: value} (e.g. \'{"BLANK-1":"1438.62"}\').'
         ),
       },
     },
     async ({ courseId, attemptId, question: questionJson, answer }) => {
       const { client } = await getClient();
       const question: QuizQuestion = JSON.parse(questionJson);
-      const result = await saveQuizAnswer(client, courseId, attemptId, question, answer as boolean | number);
+
+      // For fimb, the MCP transport gives us a JSON string — parse it into the Record<string, string>
+      // saveQuizAnswer expects. boolean / number pass through as-is.
+      let parsedAnswer: boolean | number | Record<string, string>;
+      if (typeof answer === 'string') {
+        try {
+          const obj = JSON.parse(answer);
+          if (obj === null || typeof obj !== 'object' || Array.isArray(obj)) {
+            throw new Error('fimb answer string must parse to a JSON object');
+          }
+          parsedAnswer = obj as Record<string, string>;
+        } catch (e: any) {
+          throw new Error(
+            `Invalid fimb answer: expected a JSON object string like '{"BLANK-1":"value"}'. ${e.message}`
+          );
+        }
+      } else {
+        parsedAnswer = answer;
+      }
+
+      const result = await saveQuizAnswer(client, courseId, attemptId, question, parsedAnswer);
       return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
     }
   );

package/.mcp.json

@@ -1,8 +0,0 @@
-{
-    "mcpServers": {
-      "blackboard": {
-        "command": "npx",
-        "args": ["blackboard-upc", "mcp"]
-      }
-    }
-  }