@thanh01.pmt/curriculum-kit 1.0.10 → 1.0.12

package/dist/index.cjs

@@ -13549,7 +13549,7 @@ function safeParseJson(rawText) {
     return null;
   }
 }
-async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onChunk) {
+async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onChunk, preferredModel, preferredProvider) {
   const alibabaKey = apiKeys.alibaba || apiKeys.dashscope || process.env.ALIBABA_API_KEY || process.env.DASHSCOPE_API_KEY;
   const nvidiaKey = apiKeys.nvidia || process.env.NVIDIA_API_KEY;
   const deepseekKey = apiKeys.deepseek || process.env.DEEPSEEK_API_KEY;
@@ -13557,6 +13557,11 @@ async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onC
   const geminiKey = apiKeys.gemini || process.env.GEMINI_API_KEY;
   const openrouterPreset = process.env.OPENROUTER_FREE_PRESET || "@preset/coding-free";
   const candidates = [];
+  if (preferredModel) {
+    const prov = preferredProvider || "openrouter";
+    const key = apiKeys[prov] || (prov === "openrouter" ? openrouterKey : prov === "nvidia" ? nvidiaKey : prov === "alibaba" ? alibabaKey : geminiKey) || "";
+    candidates.push({ provider: prov, model: preferredModel, apiKey: key });
+  }
   if (openrouterKey && isProviderEnabled("openrouter")) {
     const orModels = [
       openrouterPreset,
@@ -13564,40 +13569,49 @@ async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onC
       "nvidia/nemotron-3-super-120b-a12b:free",
       "nvidia/nemotron-3-ultra-550b-a55b:free",
       "nvidia/nemotron-3.5-lightning:free",
-      "minimax/minimax-m3:free",
       "cohere/north-mini-code:free"
     ].filter((m) => isModelAllowed(m));
     for (const m of Array.from(new Set(orModels))) {
-      candidates.push({ provider: "openrouter", model: m, apiKey: openrouterKey });
+      if (!candidates.some((c) => c.provider === "openrouter" && c.model === m)) {
+        candidates.push({ provider: "openrouter", model: m, apiKey: openrouterKey });
+      }
     }
   }
   if (nvidiaKey && isProviderEnabled("nvidia")) {
     const nemotronModels = [
-      "nvidia/nemotron-3-ultra-550b-a55b:free",
+      "nvidia/nemotron-3-ultra-550b-a55b",
       "nvidia/nemotron-3.5-lightning-30b-a3b",
       "nvidia/nemotron-3-super-120b-a12b",
       "nvidia/llama-3.1-nemotron-70b-instruct"
     ].filter((m) => isModelAllowed(m));
     for (const m of nemotronModels) {
-      candidates.push({ provider: "nvidia", model: m, apiKey: nvidiaKey });
+      if (!candidates.some((c) => c.provider === "nvidia" && c.model === m)) {
+        candidates.push({ provider: "nvidia", model: m, apiKey: nvidiaKey });
+      }
     }
   }
   if (alibabaKey && isProviderEnabled("alibaba")) {
     const aliModels = ["qwen-plus", "qwen-turbo", "qwen3.7-plus"].filter((m) => isModelAllowed(m));
     for (const m of aliModels) {
-      candidates.push({ provider: "alibaba", model: m, apiKey: alibabaKey });
+      if (!candidates.some((c) => c.provider === "alibaba" && c.model === m)) {
+        candidates.push({ provider: "alibaba", model: m, apiKey: alibabaKey });
+      }
     }
   }
   if (deepseekKey && isProviderEnabled("deepseek")) {
     const dsModels = ["deepseek-chat", "deepseek-coder"].filter((m) => isModelAllowed(m));
     for (const m of dsModels) {
-      candidates.push({ provider: "deepseek", model: m, apiKey: deepseekKey });
+      if (!candidates.some((c) => c.provider === "deepseek" && c.model === m)) {
+        candidates.push({ provider: "deepseek", model: m, apiKey: deepseekKey });
+      }
     }
   }
   if (geminiKey && (isProviderEnabled("gemini") || isProviderEnabled("google"))) {
     const gModels = ["gemini-1.5-flash", "gemini-2.0-flash", "gemini-1.5-pro"].filter((m) => isModelAllowed(m));
     for (const m of gModels) {
-      candidates.push({ provider: "google", model: m, apiKey: geminiKey });
+      if (!candidates.some((c) => c.provider === "google" && c.model === m)) {
+        candidates.push({ provider: "google", model: m, apiKey: geminiKey });
+      }
     }
   }
   const fallbackChain = getDesignatedFallbackChain();
@@ -13626,15 +13640,27 @@ THINKING DIRECTIVE: Keep reasoning concise, structured, and focused strictly on
         system: systemInstructions,
         prompt: userPrompt,
         temperature: 0.2,
-        abortSignal: AbortSignal.timeout(25e3)
+        includeRawChunks: true,
+        abortSignal: AbortSignal.timeout(6e4)
       });
       let fullContent = "";
       for await (const part of streamResult.fullStream) {
         if (part.type === "reasoning-delta") {
-          onChunk?.(part.text, "thought");
+          const thoughtText = part.text ?? part.delta ?? "";
+          if (thoughtText) onChunk?.(thoughtText, "thought");
+        } else if (part.type === "raw") {
+          const raw = part.rawValue;
+          const delta = raw?.choices?.[0]?.delta;
+          const reasoning = delta?.reasoning_content || delta?.reasoning;
+          if (reasoning) {
+            onChunk?.(reasoning, "thought");
+          }
         } else if (part.type === "text-delta") {
-          fullContent += part.text;
-          onChunk?.(part.text, "content");
+          const textDelta = part.text ?? part.delta ?? "";
+          if (textDelta) {
+            fullContent += textDelta;
+            onChunk?.(textDelta, "content");
+          }
         }
       }
       if (fullContent.trim()) {
@@ -13697,6 +13723,68 @@ Return concise JSON matching:
   }
   return parsedResearch;
 }
+var CONTEXT_KEY_LABELS = {
+  domain: "Domain",
+  customDomain: "Custom Domain",
+  context: "Educational Context (Tier)",
+  contextLabel: "Educational Context",
+  customContext: "Custom Educational Context",
+  targetAgeTier: "Target Age Tier",
+  targetAge: "Target Age & Audience",
+  customAge: "Custom Age Group",
+  courseDurationTier: "Course Duration Tier",
+  courseDuration: "Planned Course Duration",
+  customDuration: "Custom Course Duration",
+  hardwareReadinessTier: "Hardware Readiness Tier",
+  hardwareReadiness: "Hardware & Tool Readiness",
+  customHardware: "Custom Hardware Setup",
+  language: "Artifact Output Language",
+  totalWeeks: "Total Weeks",
+  sessionsPerWeek: "Sessions Per Week",
+  sessionDurationMinutes: "Session Duration (minutes)",
+  totalSessions: "Total Sessions",
+  isConsecutiveSessions: "Consecutive (Block) Sessions",
+  projectName: "Course Title",
+  projectCode: "Project Identifier",
+  courseDescription: "Idea Description"
+};
+var STRUCTURED_PROMPT_KEYS = /* @__PURE__ */ new Set([
+  "projectName",
+  "projectCode",
+  "courseDescription",
+  "language",
+  "primaryGoal",
+  "exitVision",
+  "cognitiveDepth",
+  "valueAndCertification",
+  "entryBridge",
+  "pedagogy",
+  "classDynamic",
+  "hardwareDeployment",
+  "teacherRole",
+  "lessonPacingModel",
+  "voiceAndTone"
+]);
+function buildRemainingContextBlock(accumulatedData) {
+  const lines = [];
+  for (const [key, rawVal] of Object.entries(accumulatedData)) {
+    if (STRUCTURED_PROMPT_KEYS.has(key)) continue;
+    if (rawVal === void 0 || rawVal === null || rawVal === "") continue;
+    if (key.endsWith("_ids") || key.endsWith("_id")) continue;
+    const label = CONTEXT_KEY_LABELS[key] || key.replace(/([A-Z])/g, " $1").replace(/_/g, " ").replace(/^./, (c) => c.toUpperCase()).trim();
+    let valueStr;
+    if (Array.isArray(rawVal)) {
+      valueStr = rawVal.map((v) => typeof v === "object" ? JSON.stringify(v) : String(v)).join("; ");
+    } else if (typeof rawVal === "object") {
+      valueStr = JSON.stringify(rawVal);
+    } else {
+      valueStr = String(rawVal);
+    }
+    if (!valueStr.trim()) continue;
+    lines.push(`- ${label}: ${valueStr}`);
+  }
+  return lines.join("\n");
+}
 async function streamLayerPrefillWithFallback(options, onChunk) {
   const { action = "prefill", targetLayer = 1, accumulatedData = {}, apiKeys = {} } = options;
   if (action === "research") {
@@ -13707,26 +13795,21 @@ async function streamLayerPrefillWithFallback(options, onChunk) {
     projectName = "Curriculum Course",
     projectCode = "curriculum-course",
     courseDescription = "",
-    domain = "tech",
-    context = "center",
-    contextLabel = "STEM Academy",
     targetAgeTier = "secondary",
     targetAge = "Secondary (Ages 11-15 / Grades 6-9)",
     courseDurationTier = "standard",
     courseDuration = "Standard Course (16-24 sessions / 24-36 hours)",
-    hardwareReadinessTier = "none_budget",
-    hardwareReadiness = "No dedicated hardware (Plug-and-play simulator or economical kit)",
     primaryGoal = "",
     exitVision = "",
     valueAndCertification = "",
-    coreLearningOutcomes = "",
+    entryBridge = "",
     pedagogy = "5E Instructional Model",
-    capstoneTheme = "",
-    teacherProfile = "Facilitator / STEM Teacher",
-    instructionalModality = "Teacher-led step-by-step",
-    cognitiveDepth = "Apply",
-    budgetOrExistingSpecs = "",
-    cognitiveScaffolding = ""
+    lessonPacingModel = "",
+    voiceAndTone = "",
+    classDynamic = "",
+    hardwareDeployment = "",
+    teacherRole = "",
+    cognitiveDepth = "Apply"
   } = accumulatedData;
   const language = typeof options.language === "string" && options.language ? options.language : typeof accumulatedData.language === "string" && accumulatedData.language ? accumulatedData.language : "vi";
   const textLangMandate = language === "vi" ? "natural, fluent Vietnamese (Ti\u1EBFng Vi\u1EC7t)" : language === "en" ? "natural, fluent English" : `natural, fluent ${language}`;
@@ -13762,7 +13845,7 @@ ${targetLayer === 1 ? `
 - Field 2 (id: 'brandingAndTone', type: 'single_choice'): Art Direction & Visual Mood (ART_DIRECTION: Future Maker Lab high-contrast vs Clean Minimalist Studio vs Gamified Playful).
 - Field 3 (id: 'differentiationStrategy', type: 'single_choice'): Differentiation & Scaffolding Strategy (CONTENT_STYLE_GUIDE: Tier 1/2/3 Bronze/Silver/Gold + EXT Challenges vs Open-ended Rubric Studio).
 - Field 4 (id: 'cognitiveScaffolding', type: 'textarea'): Concrete scaffolding methods (Starter Code, color-coded breadboards, 4-step debug poster, simulator preview).
-- Field 5 (id: 'recommendedToolchain', type: 'single_choice'): 3 concrete toolchain/IDE options matching '${hardwareReadiness}'.
+- Field 5 (id: 'recommendedToolchain', type: 'single_choice'): 3 concrete toolchain/IDE options matching the confirmed Hardware & Tool Readiness from FULL ACCUMULATED CONTEXT.
 - Field 6 (id: 'artifactScope', type: 'multi_choice'): Deliverable artifacts (LESSON mandatory + ACT, QUIZ, SLIDE, WKS, HANDOUT, GUIDE, CODE).
 - Field 7 (id: 'assessmentStrategy', type: 'single_choice'): Grading weights (e.g. 40% Formative Process + 60% Capstone Rubric).
 `}
@@ -13792,10 +13875,8 @@ RETURN STRICT VALID JSON ONLY adhering exactly to this format:
 - Course Title: "${projectName}"
 - Project Identifier: "${projectCode}"
 - Idea Description: "${courseDescription}"
-- Target Age & Audience: ${targetAge} (Tier: ${targetAgeTier})
-- Planned Course Duration: ${courseDuration} (Tier: ${courseDurationTier})
-- Hardware & Tool Readiness: ${hardwareReadiness} (Tier: ${hardwareReadinessTier})
-- Educational Context: ${contextLabel || context} | Domain: ${domain}
+- Target Age & Audience: ${targetAge}
+- Planned Course Duration: ${courseDuration}
 
 ${targetLayer >= 2 ? `
 APPROVED PARAMETERS FROM LAYER 1 (STRATEGIC INTENT & OUTCOMES):
@@ -13803,17 +13884,23 @@ APPROVED PARAMETERS FROM LAYER 1 (STRATEGIC INTENT & OUTCOMES):
 - Competency Exit Vision: "${exitVision}"
 - Target Cognitive Depth: "${cognitiveDepth}"
 - Value & Recognition: "${valueAndCertification}"
+- Prerequisite Entry Bridge: "${entryBridge}"
 ` : ""}
 
 ${targetLayer >= 3 ? `
 APPROVED PARAMETERS FROM LAYER 2 (PEDAGOGY & LOGISTICS):
-- Selected Pedagogy Model: ${pedagogy}
-- Class Dynamics / Hardware Ratio: ${accumulatedData.classDynamic || "1:1 Individual"}
-- Lab Deployment Mode: ${accumulatedData.hardwareDeployment || "Lab provided"}
-- Instructional Role: ${accumulatedData.teacherRole || "Teacher-led"}
+- Lesson Pacing Model: "${lessonPacingModel}"
+- Selected Pedagogy Model: "${pedagogy}"
+- Voice & Tone: "${voiceAndTone}"
+- Class Dynamics / Hardware Ratio: "${classDynamic}"
+- Lab Deployment Mode: "${hardwareDeployment}"
+- Instructional Role: "${teacherRole}"
 ` : ""}
 
-REQUIREMENT: Synthesize all parameters above and produce the high-fidelity pre-fill configuration for LAYER ${targetLayer}.`;
+FULL ACCUMULATED CONTEXT (ALL CONFIRMED PARAMETERS FROM EVERY PREVIOUS STEP \u2014 user decisions, organization/instructor/template profiles, schedules and constraints; every line below MUST be honored in your output):
+${buildRemainingContextBlock(accumulatedData) || "(no additional context)"}
+
+REQUIREMENT: Synthesize ALL parameters above \u2014 every single line in FULL ACCUMULATED CONTEXT is a confirmed user decision or system constraint and MUST influence the generated configuration. Produce the high-fidelity pre-fill configuration for LAYER ${targetLayer}.`;
   let rawContent = "";
   await streamLLMWithFallback(
     systemPrompt,
@@ -13822,7 +13909,9 @@ REQUIREMENT: Synthesize all parameters above and produce the high-fidelity pre-f
     (chunk, type) => {
       if (type === "content") rawContent += chunk;
       onChunk?.(chunk, type);
-    }
+    },
+    options.model,
+    options.provider
   );
   const parsed = safeParseJson(rawContent);
   return {