@thanh01.pmt/curriculum-kit 1.4.12 → 1.4.14

package/dist/ai/index.d.ts

@@ -227,23 +227,32 @@ declare function streamLessonMasterFlow(input: StreamLessonMasterInput): Promise
     lessonId?: string | undefined;
     title?: string | undefined;
     language?: string | undefined;
-    topic?: string | undefined;
-    targetGradeOrAudience?: string | undefined;
-    overview?: string | undefined;
     learningObjectives?: ({
         code?: string | undefined;
-        name?: string | undefined;
+        successCriteria?: string | undefined;
         description?: string | undefined;
+        name?: string | undefined;
         bloomLevel?: string | undefined;
-        successCriteria?: string | undefined;
         standardRefs?: (string | undefined)[] | undefined;
         conceptRefs?: (string | undefined)[] | undefined;
     } | undefined)[] | undefined;
+    teacherNotes?: {
+        commonPitfalls?: (string | undefined)[] | undefined;
+        troubleshootingMatrix?: ({
+            issue?: string | undefined;
+            potentialCause?: string | undefined;
+            solution?: string | undefined;
+        } | undefined)[] | undefined;
+        extensionNotes?: string | undefined;
+    } | undefined;
+    hookScenario?: string | undefined;
+    keywords?: (string | undefined)[] | undefined;
+    topic?: string | undefined;
+    targetGradeOrAudience?: string | undefined;
+    overview?: string | undefined;
     prerequisites?: string | undefined;
     materialsSummary?: string | undefined;
-    keywords?: (string | undefined)[] | undefined;
     hookTitle?: string | undefined;
-    hookScenario?: string | undefined;
     hookQuestions?: (string | undefined)[] | undefined;
     coreConcepts?: ({
         name?: string | undefined;
@@ -261,8 +270,8 @@ declare function streamLessonMasterFlow(input: StreamLessonMasterInput): Promise
         goldTier?: string | undefined;
     } | undefined;
     sections?: ({
-        title?: string | undefined;
         durationMinutes?: number | undefined;
+        title?: string | undefined;
         teacherActions?: string | undefined;
         studentActions?: string | undefined;
         analogies?: (string | undefined)[] | undefined;
@@ -273,15 +282,6 @@ declare function streamLessonMasterFlow(input: StreamLessonMasterInput): Promise
         expectedAnswerOrRubric?: string | undefined;
         metacognitivePrompt?: string | undefined;
     } | undefined;
-    teacherNotes?: {
-        commonPitfalls?: (string | undefined)[] | undefined;
-        troubleshootingMatrix?: ({
-            issue?: string | undefined;
-            potentialCause?: string | undefined;
-            solution?: string | undefined;
-        } | undefined)[] | undefined;
-        extensionNotes?: string | undefined;
-    } | undefined;
     guidedPractice?: {
         title?: string | undefined;
         explanation?: string | undefined;
@@ -290,31 +290,40 @@ declare function streamLessonMasterFlow(input: StreamLessonMasterInput): Promise
         mermaidDiagram?: string | undefined;
     } | undefined;
     independentPractice?: {
-        title?: string | undefined;
         description?: string | undefined;
+        title?: string | undefined;
     } | undefined;
 }, {
     artifactType: "LESSON";
     lessonId: string;
     title: string;
     language: string;
-    topic: string;
-    targetGradeOrAudience: string;
-    overview: string;
     learningObjectives: {
         code: string;
-        name: string;
+        successCriteria: string;
         description: string;
+        name: string;
         bloomLevel: string;
-        successCriteria: string;
         standardRefs?: string[] | undefined;
         conceptRefs?: string[] | undefined;
     }[];
+    teacherNotes: {
+        commonPitfalls: string[];
+        troubleshootingMatrix: {
+            issue: string;
+            potentialCause: string;
+            solution: string;
+        }[];
+        extensionNotes: string;
+    };
+    hookScenario: string;
+    keywords: string[];
+    topic: string;
+    targetGradeOrAudience: string;
+    overview: string;
     prerequisites: string;
     materialsSummary: string;
-    keywords: string[];
     hookTitle: string;
-    hookScenario: string;
     hookQuestions: string[];
     coreConcepts: {
         name: string;
@@ -332,8 +341,8 @@ declare function streamLessonMasterFlow(input: StreamLessonMasterInput): Promise
         goldTier: string;
     };
     sections: {
-        title: string;
         durationMinutes: number;
+        title: string;
         teacherActions: string;
         studentActions: string;
         analogies: string[];
@@ -344,15 +353,6 @@ declare function streamLessonMasterFlow(input: StreamLessonMasterInput): Promise
         expectedAnswerOrRubric: string;
         metacognitivePrompt: string;
     };
-    teacherNotes: {
-        commonPitfalls: string[];
-        troubleshootingMatrix: {
-            issue: string;
-            potentialCause: string;
-            solution: string;
-        }[];
-        extensionNotes: string;
-    };
     guidedPractice?: {
         title: string;
         explanation: string;
@@ -361,8 +361,8 @@ declare function streamLessonMasterFlow(input: StreamLessonMasterInput): Promise
         mermaidDiagram: string;
     } | undefined;
     independentPractice?: {
-        title: string;
         description: string;
+        title: string;
     } | undefined;
 }, never>>;
 
@@ -385,11 +385,11 @@ declare function streamSelfLabFlow(input: StreamSelfLabInput): Promise<ai.Stream
     techStack?: (string | undefined)[] | undefined;
     challenges?: {
         bronze?: {
-            title?: string | undefined;
             objective?: string | undefined;
-            tier?: "bronze" | "silver" | "gold" | undefined;
+            title?: string | undefined;
             expectedOutput?: string | undefined;
             estimatedMinutes?: number | undefined;
+            tier?: "bronze" | "silver" | "gold" | undefined;
             tasks?: (string | undefined)[] | undefined;
             verifyCommand?: string | undefined;
             hints?: {
@@ -402,11 +402,11 @@ declare function streamSelfLabFlow(input: StreamSelfLabInput): Promise<ai.Stream
             } | undefined;
         } | undefined;
         silver?: {
-            title?: string | undefined;
             objective?: string | undefined;
-            tier?: "bronze" | "silver" | "gold" | undefined;
+            title?: string | undefined;
             expectedOutput?: string | undefined;
             estimatedMinutes?: number | undefined;
+            tier?: "bronze" | "silver" | "gold" | undefined;
             tasks?: (string | undefined)[] | undefined;
             verifyCommand?: string | undefined;
             hints?: {
@@ -419,11 +419,11 @@ declare function streamSelfLabFlow(input: StreamSelfLabInput): Promise<ai.Stream
             } | undefined;
         } | undefined;
         gold?: {
-            title?: string | undefined;
             objective?: string | undefined;
-            tier?: "bronze" | "silver" | "gold" | undefined;
+            title?: string | undefined;
             expectedOutput?: string | undefined;
             estimatedMinutes?: number | undefined;
+            tier?: "bronze" | "silver" | "gold" | undefined;
             tasks?: (string | undefined)[] | undefined;
             verifyCommand?: string | undefined;
             hints?: {
@@ -454,11 +454,11 @@ declare function streamSelfLabFlow(input: StreamSelfLabInput): Promise<ai.Stream
     techStack: string[];
     challenges: {
         bronze: {
-            title: string;
             objective: string;
-            tier: "bronze" | "silver" | "gold";
+            title: string;
             expectedOutput: string;
             estimatedMinutes: number;
+            tier: "bronze" | "silver" | "gold";
             tasks: string[];
             verifyCommand: string;
             hints: {
@@ -471,11 +471,11 @@ declare function streamSelfLabFlow(input: StreamSelfLabInput): Promise<ai.Stream
             };
         };
         silver: {
-            title: string;
             objective: string;
-            tier: "bronze" | "silver" | "gold";
+            title: string;
             expectedOutput: string;
             estimatedMinutes: number;
+            tier: "bronze" | "silver" | "gold";
             tasks: string[];
             verifyCommand: string;
             hints: {
@@ -488,11 +488,11 @@ declare function streamSelfLabFlow(input: StreamSelfLabInput): Promise<ai.Stream
             };
         };
         gold: {
-            title: string;
             objective: string;
-            tier: "bronze" | "silver" | "gold";
+            title: string;
             expectedOutput: string;
             estimatedMinutes: number;
+            tier: "bronze" | "silver" | "gold";
             tasks: string[];
             verifyCommand: string;
             hints: {
@@ -524,21 +524,14 @@ declare function streamDiagnosticQuizFlow(input: StreamDiagnosticQuizInput): Pro
     artifactType?: "QUIZ" | undefined;
     title?: string | undefined;
     language?: string | undefined;
-    rubric?: ({
-        exemplary?: string | undefined;
-        proficient?: string | undefined;
-        developing?: string | undefined;
-        competencyDimension?: string | undefined;
-        advanced?: string | undefined;
-    } | undefined)[] | undefined;
     quizId?: string | undefined;
     totalQuestions?: number | undefined;
     timeAllocationMinutes?: number | undefined;
     passingScorePct?: number | undefined;
     assessmentObjectives?: ({
-        bloomLevel?: "Remember" | "Understand" | "Apply" | "Analyze" | "Evaluate" | "Create" | undefined;
-        standardRefs?: (string | undefined)[] | undefined;
         objective?: string | undefined;
+        standardRefs?: (string | undefined)[] | undefined;
+        bloomLevel?: "Create" | "Evaluate" | "Remember" | "Understand" | "Apply" | "Analyze" | undefined;
         aoCode?: string | undefined;
         alignedLO?: string | undefined;
     } | undefined)[] | undefined;
@@ -549,10 +542,10 @@ declare function streamDiagnosticQuizFlow(input: StreamDiagnosticQuizInput): Pro
             text?: string | undefined;
             isCorrect?: boolean | undefined;
         } | undefined)[] | undefined;
-        bloomLevel?: "understand" | "create" | "Remember" | "Understand" | "Apply" | "Analyze" | "Evaluate" | "Create" | "remember" | "apply" | "analyze" | "evaluate" | undefined;
+        bloomLevel?: "create" | "Create" | "Evaluate" | "understand" | "Remember" | "Understand" | "Apply" | "Analyze" | "remember" | "apply" | "analyze" | "evaluate" | undefined;
         codeLanguage?: string | undefined;
         id?: string | undefined;
-        questionType?: "multiple_choice" | "code_analysis" | "matching" | "open_ended" | undefined;
+        questionType?: "multiple_choice" | "matching" | "code_analysis" | "open_ended" | undefined;
         codeSnippet?: string | undefined;
         alignedAO?: string | undefined;
         scenarioOrStem?: string | undefined;
@@ -562,25 +555,25 @@ declare function streamDiagnosticQuizFlow(input: StreamDiagnosticQuizInput): Pro
         teacherNote?: string | undefined;
         takeawayMessage?: string | undefined;
     } | undefined)[] | undefined;
+    rubric?: ({
+        proficient?: string | undefined;
+        advanced?: string | undefined;
+        competencyDimension?: string | undefined;
+        developing?: string | undefined;
+        exemplary?: string | undefined;
+    } | undefined)[] | undefined;
 }, {
     artifactType: "QUIZ";
     title: string;
     language: string;
-    rubric: {
-        exemplary: string;
-        proficient: string;
-        developing: string;
-        competencyDimension: string;
-        advanced: string;
-    }[];
     quizId: string;
     totalQuestions: number;
     timeAllocationMinutes: number;
     passingScorePct: number;
     assessmentObjectives: {
-        bloomLevel: "Remember" | "Understand" | "Apply" | "Analyze" | "Evaluate" | "Create";
-        standardRefs: string[];
         objective: string;
+        standardRefs: string[];
+        bloomLevel: "Create" | "Evaluate" | "Remember" | "Understand" | "Apply" | "Analyze";
         aoCode: string;
         alignedLO: string;
     }[];
@@ -591,10 +584,10 @@ declare function streamDiagnosticQuizFlow(input: StreamDiagnosticQuizInput): Pro
             text: string;
             isCorrect: boolean;
         }[];
-        bloomLevel: "understand" | "create" | "Remember" | "Understand" | "Apply" | "Analyze" | "Evaluate" | "Create" | "remember" | "apply" | "analyze" | "evaluate";
+        bloomLevel: "create" | "Create" | "Evaluate" | "understand" | "Remember" | "Understand" | "Apply" | "Analyze" | "remember" | "apply" | "analyze" | "evaluate";
         codeLanguage: string;
         id: string;
-        questionType: "multiple_choice" | "code_analysis" | "matching" | "open_ended";
+        questionType: "multiple_choice" | "matching" | "code_analysis" | "open_ended";
         codeSnippet?: string | undefined;
         alignedAO?: string | undefined;
         scenarioOrStem?: string | undefined;
@@ -604,6 +597,13 @@ declare function streamDiagnosticQuizFlow(input: StreamDiagnosticQuizInput): Pro
         teacherNote?: string | undefined;
         takeawayMessage?: string | undefined;
     }[];
+    rubric: {
+        proficient: string;
+        advanced: string;
+        competencyDimension: string;
+        developing: string;
+        exemplary: string;
+    }[];
 }, never>>;
 
 /**
@@ -850,6 +850,7 @@ declare const contentTools: {
             }>, "many">;
             durationMinutes: z.ZodDefault<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
+            durationMinutes: number;
             lessonId: string;
             title: string;
             learningObjectives: {
@@ -857,7 +858,6 @@ declare const contentTools: {
                 statement: string;
                 standardRefs?: string[] | undefined;
             }[];
-            durationMinutes: number;
         }, {
             lessonId: string;
             title: string;
@@ -1017,19 +1017,19 @@ declare const assessorTools: {
                 levels: Record<string, string>;
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
-            lessonId: string;
             criteria: {
                 criterionName: string;
                 weight: number;
                 levels: Record<string, string>;
             }[];
-        }, {
             lessonId: string;
+        }, {
             criteria: {
                 criterionName: string;
                 weight: number;
                 levels: Record<string, string>;
             }[];
+            lessonId: string;
         }>;
     };
 };
@@ -1072,12 +1072,12 @@ declare const techSmeTools: {
             code: z.ZodString;
             expectedOutput: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            language: "swift" | "python" | "javascript" | "html_css";
             code: string;
+            language: "swift" | "python" | "javascript" | "html_css";
             expectedOutput?: string | undefined;
         }, {
-            language: "swift" | "python" | "javascript" | "html_css";
             code: string;
+            language: "swift" | "python" | "javascript" | "html_css";
             expectedOutput?: string | undefined;
         }>;
     };
@@ -1088,11 +1088,11 @@ declare const techSmeTools: {
             language: z.ZodString;
             code: z.ZodString;
         }, "strip", z.ZodTypeAny, {
-            language: string;
             code: string;
-        }, {
             language: string;
+        }, {
             code: string;
+            language: string;
         }>;
     };
 };

package/dist/index.cjs

@@ -1289,7 +1289,7 @@ var init_lessonFlowParser = __esm({
 
 // src/ai/prompts/slideBlueprintPrompt.ts
 function buildSlideBlueprintPrompt(params) {
-  const { lessonFlow, targetSlideCount = 20, stylePresetName = "Blue Professional" } = params;
+  const { lessonFlow, targetSlideCount, stylePresetName = "Blue Professional" } = params;
   const activitiesSummary = lessonFlow.activities.map(
     (a) => `Seq ${a.seq} [${a.phase}]: ${a.purpose} (Teacher: ${a.teacherMove} | Student: ${a.studentAction} | Time: ${a.time})`
   ).join("\n");
@@ -1297,9 +1297,12 @@ function buildSlideBlueprintPrompt(params) {
     (p) => `Phase "${p.phaseName}" (${p.timing || "Standard"}):
 ${p.content.slice(0, 500)}...`
   ).join("\n\n");
+  const countGuidance = targetSlideCount ? `The target is approximately ${targetSlideCount} slides.` : `Determine the organic, optimal number of slides based directly on the canonical LESSON plan: every instructional move, concept explanation, code walkthrough, activity phase, and quiz checkpoint must receive adequate slide coverage without artificial cramming or stretching.`;
+  const outputGuidance = targetSlideCount ? `Output ONLY a valid JSON array of ${targetSlideCount} objects.` : `Output ONLY a valid JSON array of objects (one object per planned slide).`;
   return `
 You are @illustrator, Chief Slide Architect for the Course Builder OS.
-Your task is to analyze the canonical LESSON plan and architect an authoritative, high-fidelity **SLIDE BLUEPRINT** of EXACTLY ${targetSlideCount} slides.
+Your task is to analyze the canonical LESSON plan and architect an authoritative, high-fidelity **SLIDE BLUEPRINT**.
+${countGuidance}
 
 ### \u{1F3DB}\uFE0F PEDAGOGICAL GROUND TRUTH (FROM CANONICAL LESSON):
 - Lesson Title: "${lessonFlow.lessonTitle}"
@@ -1317,17 +1320,18 @@ ${phasesSummary || lessonFlow.rawContent.slice(0, 3e3)}
 ---
 
 ### \u{1F3AF} ARCHITECTURAL RULES (STRICTLY INVARIANT):
-1. **PEDAGOGICAL FIDELITY (1-TO-1 PROJECTION)**:
+1. **ORGANIC PEDAGOGICAL FIDELITY (1-TO-1 PROJECTION)**:
    - The slide sequence MUST follow the EXACT flow of the LESSON phases (${lessonFlow.pedagogicalModel.toUpperCase()}).
+   - The number of slides is determined by the substance of the lesson \u2014 do NOT stretch thin content or cram rich multi-step labs into too few slides.
    - Do NOT invent artificial phases that do not exist in the lesson plan.
    - For example:
-     * If 5E: Engage (slides 1-4) -> Explore (slides 5-8) -> Explain (slides 9-13) -> Elaborate (slides 14-17) -> Evaluate (slides 18-20).
-     * If EDP: Ask/Problem (slides 1-4) -> Imagine & Plan (slides 5-8) -> Create & Prototype (slides 9-14) -> Test & Debug (slides 15-17) -> Improve & Share (slides 18-20).
-     * If PBL: Driving Question (slides 1-4) -> Inquiry (slides 5-9) -> Milestone Sprint (slides 10-15) -> Review & Exhibition (slides 16-20).
+     * If 5E: Engage -> Explore -> Explain -> Elaborate -> Evaluate.
+     * If EDP: Ask/Problem -> Imagine & Plan -> Create & Prototype -> Test & Debug -> Improve & Share.
+     * If PBL: Driving Question -> Inquiry -> Milestone Sprint -> Review & Exhibition.
 
-2. **CHUNKY CLUSTERS (3 TO 4 CLUSTERS)**:
-   - Group the ${targetSlideCount} slides into 3 to 4 natural clusters (each cluster contains 4 to 6 slides).
-   - Each cluster corresponds to a major pedagogical transition in the lesson.
+2. **CHUNKY CLUSTERS (4 TO 6 SLIDES PER CLUSTER)**:
+   - Partition the slides into natural clusters corresponding to the major pedagogical transitions in the lesson.
+   - Each cluster MUST contain 4 to 6 slides to ensure downstream token generation remains focused, high-fidelity, and non-repetitive.
 
 3. **SEMANTIC LAYOUT SLOTS (CHOOSE FROM VERIFIED TEMPLATES)**:
    Use one of these valid layoutIds for each slide:
@@ -1344,7 +1348,7 @@ ${phasesSummary || lessonFlow.rawContent.slice(0, 3e3)}
 ---
 
 ### \u{1F4E4} OUTPUT FORMAT:
-Output ONLY a valid JSON array of ${targetSlideCount} objects. Do NOT include markdown text outside the JSON.
+${outputGuidance} Do NOT include markdown text outside the JSON.
 Format:
 \`\`\`json
 [
@@ -1474,7 +1478,7 @@ async function executeSlideProductionWorkflow(options) {
     lessonMarkdown,
     lessonCode,
     lessonTitle,
-    targetSlideCount = 20,
+    targetSlideCount,
     stylePresetId = "blue-professional",
     language = "Vietnamese",
     languageDirective = "",
@@ -1493,7 +1497,8 @@ async function executeSlideProductionWorkflow(options) {
     presentationKitCore = await import('@thanh01.pmt/presentation-kit');
   } catch {
   }
-  onProgress?.("@illustrator", `[1/4] Ph\xE2n t\xEDch m\u1EA1ch b\xE0i gi\u1EA3ng LESSON & L\u1EADp D\xE0n \xFD ${targetSlideCount} Slides...`);
+  const countLabel = targetSlideCount ? `${targetSlideCount} ` : "h\u1EEFu c\u01A1 ";
+  onProgress?.("@illustrator", `[1/4] Ph\xE2n t\xEDch m\u1EA1ch b\xE0i gi\u1EA3ng LESSON & L\u1EADp D\xE0n \xFD ${countLabel}Slides...`);
   const lessonFlow = parseLessonFlow(lessonMarkdown);
   const stylePreset = presentationKitSkills?.getStylePreset ? presentationKitSkills.getStylePreset(stylePresetId) : { name: "Blue Professional" };
   const blueprintPrompt = buildSlideBlueprintPrompt({
@@ -1517,12 +1522,13 @@ async function executeSlideProductionWorkflow(options) {
       blueprintItems = JSON.parse(jsonrepair.jsonrepair(extractCleanJson(rawBlueprint)));
     } catch (e) {
       console.warn(`[SlideProductionWorkflow] Failed parsing blueprint JSON, constructing fallback:`, e);
-      blueprintItems = Array.from({ length: targetSlideCount }, (_, i) => ({
+      const fallbackCount = targetSlideCount || Math.max(12, Math.min(24, Math.max(lessonFlow.phases.length, 4) * 4));
+      blueprintItems = Array.from({ length: fallbackCount }, (_, i) => ({
         slideIndex: i + 1,
         clusterId: Math.floor(i / 5) + 1,
         clusterTitle: `Cluster ${Math.floor(i / 5) + 1}`,
         lessonPhase: lessonFlow.phases[Math.min(i, lessonFlow.phases.length - 1)]?.phaseName || "Content",
-        layoutId: i === 0 ? "hero-cover" : i === targetSlideCount - 1 ? "summary-takeaways" : "split-concept-code",
+        layoutId: i === 0 ? "hero-cover" : i === fallbackCount - 1 ? "summary-takeaways" : "split-concept-code",
         title: `Slide ${i + 1}: ${lessonTitle}`,
         pedagogicalGoal: `Teach step ${i + 1} of ${lessonTitle}`,
         contentFocus: ["Key point 1", "Key point 2", "Key point 3"]
@@ -25827,7 +25833,6 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
         lessonMarkdown: lessonContent || "",
         lessonCode,
         lessonTitle,
-        targetSlideCount: 20,
         stylePresetId: "blue-professional",
         language: targetLang || "Vietnamese",
         languageDirective,