@classroomio/mcp 0.0.6 → 0.0.7

package/README.md

@@ -164,6 +164,12 @@ Drafts support:
 - safer updates to existing courses
 - auditability of AI-generated structure
 
+Lesson authoring rule:
+
+- `lessonLanguages[].content` should contain only the lesson body HTML
+- do not include the lesson title or a top-level heading that repeats `lessons[].title`
+- ClassroomIO already renders the lesson title in the course UI
+
 ## After Publish
 
 Once a draft has been published, the live course becomes the safer source of truth.

package/dist/index.js

@@ -114,13 +114,10 @@ var ClassroomIoApiClient = class {
     });
   }
   async tagCourses(payload) {
-    return this.request(
-      "/organization/tags/courses/assign",
-      {
-        method: "PUT",
-        body: payload
-      }
-    );
+    return this.request("/organization/tags/courses/assign", {
+      method: "PUT",
+      body: payload
+    });
   }
   async request(path, options) {
     const response = await fetch(new URL(path, this.config.CLASSROOMIO_API_URL), {
@@ -1147,7 +1144,7 @@ var ZCourseLandingPageUpdate = z12.object({
   overview: z12.string().optional(),
   cost: z12.number().int().min(0).optional(),
   currency: z12.enum(["NGN", "USD"]).optional(),
-  imageUrl: z12.string().url().optional(),
+  imageUrl: z12.url().optional(),
   generateImage: z12.boolean().optional(),
   imageQuery: z12.string().min(1).max(120).optional(),
   metadata: ZCourseLandingPageMetadataUpdate.optional()
@@ -1168,6 +1165,7 @@ var ZCourseUserAnalyticsParam = z12.object({
 
 // ../utils/dist/validation/course-import/course-import.js
 var ZSupportedLocale = z13.enum(["en", "hi", "fr", "pt", "de", "vi", "ru", "es", "pl", "da"]);
+var LESSON_BODY_HTML_DESCRIPTION = "Lesson body HTML only. Do not include the lesson title or a top-level heading that repeats lessons[].title because the ClassroomIO UI already renders the lesson title separately.";
 var ZCourseImportWarning = z13.object({
   code: z13.string().min(1),
   message: z13.string().min(1),
@@ -1202,7 +1200,7 @@ var ZCourseImportDraftLesson = z13.object({
 var ZCourseImportDraftLessonLanguage = z13.object({
   lessonExternalId: z13.string().min(1),
   locale: ZSupportedLocale,
-  content: z13.string().min(1)
+  content: z13.string().min(1).describe(LESSON_BODY_HTML_DESCRIPTION)
 });
 var ZCourseImportDraftPayload = z13.object({
   course: ZCourseImportDraftCourse,
@@ -1414,6 +1412,7 @@ var publishCourseDraftShape = ZPublishCourseDraftToolInput.shape;
 var publishCourseDraftToExistingCourseShape = ZPublishCourseDraftToExistingCourseToolInput.shape;
 var tagCoursesShape = ZAutomationCourseTagAssignment.shape;
 var SUPPORTED_QUESTION_TYPES_GUIDE = "Supported questionTypeId values: RADIO=1 (Single answer), CHECKBOX=2 (Multiple answers), TEXTAREA=3 (Paragraph), TRUE_FALSE=4 (True/False), SHORT_ANSWER=5 (Short answer), NUMERIC=6 (Numeric answer), FILL_BLANK=7 (Fill in the blank), FILE_UPLOAD=8 (File upload), MATCHING=9 (Matching), ORDERING=10 (Ordering), HOTSPOT=11 (Hotspot), LINK=12 (Links). Use the numeric ids in exercise payloads.";
+var LESSON_HTML_GUIDE = "For draft lesson HTML, put only the lesson body in lessonLanguages[].content. Do not include the lesson title or a top-level heading that repeats lessons[].title because the ClassroomIO UI already renders the lesson title.";
 function registerCourseDraftTools(server, apiClient) {
   server.tool(
     "list_org_courses",
@@ -1447,7 +1446,7 @@ function registerCourseDraftTools(server, apiClient) {
   );
   server.tool(
     "create_course_draft",
-    "Create a new unpublished course draft from structured course JSON. Use this before the first publish.",
+    `Create a new unpublished course draft from structured course JSON. Use this before the first publish. ${LESSON_HTML_GUIDE}`,
     createCourseDraftShape,
     async (args) => {
       const payload = ZCourseImportDraftCreate.parse(args);
@@ -1527,7 +1526,7 @@ function registerCourseDraftTools(server, apiClient) {
   );
   server.tool(
     "update_course_draft",
-    "Update an unpublished draft. If the draft is already published, do not keep editing it blindly; create a fresh draft from the live course first.",
+    `Update an unpublished draft. If the draft is already published, do not keep editing it blindly; create a fresh draft from the live course first. ${LESSON_HTML_GUIDE}`,
     updateCourseDraftShape,
     async (args) => {
       const { draftId, ...payload } = ZUpdateCourseDraftToolInput.parse(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classroomio/mcp",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -42,6 +42,7 @@
   "scripts": {
     "build": "tsc --noEmit && rm -rf dist tsconfig.tsbuildinfo && node ./scripts/build.mjs",
     "dev": "tsx src/index.ts",
-    "start": "node dist/index.js"
+    "start": "node dist/index.js",
+    "format": "prettier --write \"src/**/*.ts\""
   }
 }