@thanh01.pmt/curriculum-kit 1.4.15 → 1.4.17

package/dist/index.cjs

@@ -2,12 +2,13 @@
 
 var fs2 = require('fs');
 var path3 = require('path');
-var jsonrepair = require('jsonrepair');
-var zod = require('zod');
 var google = require('@ai-sdk/google');
 var openai = require('@ai-sdk/openai');
 var deepseek = require('@ai-sdk/deepseek');
+var zod = require('zod');
 var ai = require('ai');
+var pRetry = require('p-retry');
+var jsonrepair = require('jsonrepair');
 var pLimit = require('p-limit');
 var fsPromises = require('fs/promises');
 var crypto = require('crypto');
@@ -20,6 +21,7 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var fs2__default = /*#__PURE__*/_interopDefault(fs2);
 var path3__default = /*#__PURE__*/_interopDefault(path3);
+var pRetry__default = /*#__PURE__*/_interopDefault(pRetry);
 var pLimit__default = /*#__PURE__*/_interopDefault(pLimit);
 var fsPromises__default = /*#__PURE__*/_interopDefault(fsPromises);
 var crypto__default = /*#__PURE__*/_interopDefault(crypto);
@@ -889,6 +891,132 @@ var init_streamRunner = __esm({
     exports.DEFAULT_ARTIFACT_STREAM_TOTAL_MS = 48e4;
   }
 });
+function getAIModel(options = {}) {
+  const designated = getDesignatedFallbackConfig();
+  const defaultProvider = process.env.DEFAULT_AI_PROVIDER || process.env.LLM_PROVIDER || detectDefaultProvider();
+  let provider = (options.provider || defaultProvider).toLowerCase();
+  if (!isProviderEnabled(provider)) {
+    console.warn(`[provider-factory] Provider "${provider}" is disabled via environment toggle. Falling back to designated provider "${designated.provider}".`);
+    provider = designated.provider;
+  }
+  let resolvedModelName = options.modelName || process.env.DEFAULT_AI_MODEL || process.env.LLM_MODEL || DEFAULT_MODELS[provider] || designated.model;
+  if (!isModelAllowed(resolvedModelName)) {
+    console.warn(`[provider-factory] Model "${resolvedModelName}" is not permitted by ALLOWED_AI_MODELS. Using designated model "${designated.model}".`);
+    resolvedModelName = designated.model;
+  }
+  if (provider === "nvidia") {
+    const apiKey = options.apiKey || process.env.NVIDIA_API_KEY || "";
+    const nvidia = openai.createOpenAI({
+      apiKey,
+      baseURL: options.baseURL || "https://integrate.api.nvidia.com/v1"
+    });
+    return nvidia.chat(resolvedModelName || "nvidia/nemotron-3-ultra-550b-a55b:free");
+  }
+  if (provider === "openrouter") {
+    const apiKey = options.apiKey || process.env.OPENROUTER_API_KEY || process.env.OPENAI_API_KEY || "";
+    const openrouter = openai.createOpenAI({
+      apiKey,
+      baseURL: options.baseURL || "https://openrouter.ai/api/v1"
+    });
+    return openrouter.chat(resolvedModelName || "@preset/coding-free");
+  }
+  if (provider === "alibaba" || provider === "dashscope") {
+    const effectiveKey = options.apiKey || process.env.ALIBABA_API_KEY || process.env.DASHSCOPE_API_KEY || process.env.SAAS_ALIBABA_API_KEY || process.env.SAAS_DASHSCOPE_API_KEY || "";
+    let defaultBaseURL = "https://dashscope-intl.aliyuncs.com/compatible-mode/v1";
+    if (effectiveKey.startsWith("sk-sp-")) {
+      defaultBaseURL = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1";
+    }
+    const rawUrl = options.baseURL || process.env.ALIBABA_BASE_URL || process.env.DASHSCOPE_BASE_URL || defaultBaseURL;
+    const cleanBaseURL = rawUrl.replace(/^["']|["']$/g, "").trim();
+    const alibaba = openai.createOpenAI({
+      apiKey: effectiveKey,
+      baseURL: cleanBaseURL
+      // Passthrough: no forced format injection — the Vercel AI SDK's generateObject
+      // already instructs the model to return JSON via its schema definition.
+      // Injecting 'Output format: JSON.' into markdown-based lesson prompts caused
+      // model confusion (mixed markdown + JSON output).
+    });
+    return alibaba.chat(resolvedModelName);
+  }
+  if (provider === "google") {
+    const apiKey = options.apiKey || process.env.GOOGLE_GENERATIVE_AI_API_KEY || process.env.GEMINI_API_KEY || "";
+    const google$1 = google.createGoogleGenerativeAI({ apiKey });
+    return google$1(resolvedModelName);
+  }
+  if (provider === "deepseek") {
+    const apiKey = options.apiKey || process.env.DEEPSEEK_API_KEY || process.env.SAAS_DEEPSEEK_API_KEY || "";
+    const deepseek$1 = deepseek.createDeepSeek({ apiKey });
+    return deepseek$1(resolvedModelName);
+  }
+  if (provider === "openai") {
+    const apiKey = options.apiKey || process.env.OPENAI_API_KEY || "";
+    const openai$1 = openai.createOpenAI({
+      apiKey,
+      baseURL: options.baseURL || process.env.OPENAI_BASE_URL
+    });
+    return openai$1.chat(resolvedModelName);
+  }
+  if (provider === "ollama") {
+    const apiKey = options.apiKey || process.env.OLLAMA_API_KEY || "ollama";
+    const baseURL = options.baseURL || process.env.OLLAMA_BASE_URL || process.env.OPENAI_BASE_URL || "http://127.0.0.1:11434/v1";
+    const ollama = openai.createOpenAI({
+      apiKey,
+      baseURL
+    });
+    return ollama.chat(resolvedModelName || "qwen2.5:latest");
+  }
+  const fallback = openai.createOpenAI({
+    apiKey: options.apiKey || process.env.OPENAI_API_KEY || "",
+    baseURL: options.baseURL || process.env.OPENAI_BASE_URL
+  });
+  return fallback.chat(resolvedModelName);
+}
+function detectDefaultProvider() {
+  if (process.env.NVIDIA_API_KEY && isProviderEnabled("nvidia")) {
+    return "nvidia";
+  }
+  if (process.env.OPENROUTER_API_KEY && isProviderEnabled("openrouter")) {
+    return "openrouter";
+  }
+  if ((process.env.ALIBABA_API_KEY || process.env.DASHSCOPE_API_KEY || process.env.SAAS_ALIBABA_API_KEY) && isProviderEnabled("alibaba")) {
+    return "alibaba";
+  }
+  if ((process.env.GOOGLE_GENERATIVE_AI_API_KEY || process.env.GEMINI_API_KEY) && (isProviderEnabled("gemini") || isProviderEnabled("google"))) {
+    return "google";
+  }
+  if ((process.env.DEEPSEEK_API_KEY || process.env.SAAS_DEEPSEEK_API_KEY) && isProviderEnabled("deepseek")) {
+    return "deepseek";
+  }
+  if (process.env.OPENAI_API_KEY && process.env.OPENAI_API_KEY !== "ollama" && isProviderEnabled("openai")) {
+    return "openai";
+  }
+  return getDesignatedFallbackConfig().provider;
+}
+var DEFAULT_MODELS; exports.NVIDIA_MODELS = void 0;
+var init_provider_factory = __esm({
+  "src/ai/provider-factory.ts"() {
+    init_streamRunner();
+    DEFAULT_MODELS = {
+      nvidia: "nvidia/nemotron-3-ultra-550b-a55b:free",
+      openrouter: "@preset/coding-free",
+      alibaba: "qwen3.7-plus",
+      dashscope: "qwen3.7-plus",
+      google: "gemini-1.5-flash",
+      deepseek: "deepseek-chat",
+      openai: "gpt-4o-mini",
+      ollama: "deepseek-v4-flash:0731"
+    };
+    exports.NVIDIA_MODELS = {
+      codingFast: "nvidia/nemotron-3.5-lightning-30b-a3b",
+      reasoningUltra: "nvidia/nemotron-3-ultra-550b-a55b:free",
+      superMoE: "nvidia/nemotron-3-super-120b-a12b",
+      llamaNemotron: "nvidia/llama-3.1-nemotron-70b-instruct",
+      translation: "nvidia/riva-translate-4b-instruct-v2",
+      embedding: "nvidia/nemotron-3-embed-1b",
+      visionLlama: "meta/llama-3.2-11b-vision-instruct"
+    };
+  }
+});
 
 // src/pipeline/artifactLinter.ts
 var artifactLinter_exports = {};
@@ -1300,8 +1428,9 @@ ${p.content.slice(0, 500)}...`
   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**.
+You are @illustrator, Chief Slide Architect.
+Your task is to analyze the canonical LESSON plan ("${lessonFlow.lessonTitle}") and architect an authoritative, high-fidelity **SLIDE BLUEPRINT** (a slide-by-slide presentation deck outline for this single lesson).
+IMPORTANT: Do NOT output a course outline or lessons list. You are designing presentation SLIDES for this lesson.
 ${countGuidance}
 
 ### \u{1F3DB}\uFE0F PEDAGOGICAL GROUND TRUTH (FROM CANONICAL LESSON):
@@ -1466,12 +1595,52 @@ var init_slideBatchPrompt = __esm({
 // src/services/slideProductionWorkflow.ts
 var slideProductionWorkflow_exports = {};
 __export(slideProductionWorkflow_exports, {
+  GeneratedSlideArraySchema: () => exports.GeneratedSlideArraySchema,
+  GeneratedSlideSchema: () => exports.GeneratedSlideSchema,
+  SlideBlueprintArraySchema: () => exports.SlideBlueprintArraySchema,
+  SlideBlueprintItemSchema: () => exports.SlideBlueprintItemSchema,
   executeSlideProductionWorkflow: () => executeSlideProductionWorkflow
 });
-function extractCleanJson(raw) {
-  const fenceMatch = raw.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
-  const candidate = fenceMatch ? fenceMatch[1] : raw;
-  return candidate.trim();
+async function inferStructured(schema, systemPrompt, userPrompt, options, label) {
+  try {
+    const model = getAIModel(options.modelOptions);
+    const { object } = await ai.generateObject({
+      model,
+      schema,
+      system: systemPrompt || void 0,
+      prompt: userPrompt
+    });
+    const validated = schema.safeParse(object);
+    if (validated.success) return validated.data;
+    console.warn(
+      `[SlideProductionWorkflow] AI SDK output failed schema validation for ${label}:`,
+      validated.error?.message
+    );
+  } catch (aiSdkErr) {
+    console.warn(`[SlideProductionWorkflow] AI SDK generateObject failed for ${label}:`, aiSdkErr?.message || aiSdkErr);
+  }
+  if (options.allowLegacyFallback === false) return null;
+  try {
+    const messages = [
+      { role: "user", content: [systemPrompt, userPrompt].filter(Boolean).join("\n\n") }
+    ];
+    const raw = await runCurriculumAIInference(messages, options.satelliteContext || "", options.runnerOptions);
+    const fenceMatch = raw.match(/```(?:json)?\s*([\s\S]*?)\s*```/i);
+    const candidate = (fenceMatch ? fenceMatch[1] : raw).trim();
+    let parsed;
+    try {
+      parsed = JSON.parse(candidate);
+    } catch {
+      parsed = JSON.parse(jsonrepair.jsonrepair(candidate));
+    }
+    const result = schema.safeParse(parsed);
+    if (result.success) return result.data;
+    console.warn(`[SlideProductionWorkflow] Legacy fallback output failed schema validation for ${label}:`, result.error?.message);
+    return null;
+  } catch (legacyErr) {
+    console.warn(`[SlideProductionWorkflow] Legacy fallback failed for ${label}:`, legacyErr?.message || legacyErr);
+    return null;
+  }
 }
 async function executeSlideProductionWorkflow(options) {
   const {
@@ -1483,8 +1652,7 @@ async function executeSlideProductionWorkflow(options) {
     language = "Vietnamese",
     languageDirective = "",
     headingDirective = "",
-    satelliteContext,
-    runnerOptions,
+    maxRetries = 3,
     onProgress
   } = options;
   let presentationKitSkills = null;
@@ -1500,41 +1668,44 @@ async function executeSlideProductionWorkflow(options) {
   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 getStylePreset = presentationKitSkills?.getStylePreset;
+  const stylePreset = getStylePreset ? getStylePreset(stylePresetId) : { name: "Blue Professional" };
   const blueprintPrompt = buildSlideBlueprintPrompt({
     lessonFlow,
     targetSlideCount,
     stylePresetName: stylePreset?.name || "Blue Professional"
   });
-  const rawBlueprint = await runCurriculumAIInference(
-    [{ role: "user", content: blueprintPrompt }],
-    satelliteContext,
-    runnerOptions,
-    (chunk, type) => {
-      onProgress?.("@illustrator", chunk, { type: type || "content", artifactType: "SLIDE" });
-    }
-  );
-  let blueprintItems = [];
-  try {
-    blueprintItems = JSON.parse(extractCleanJson(rawBlueprint));
-  } catch {
-    try {
-      blueprintItems = JSON.parse(jsonrepair.jsonrepair(extractCleanJson(rawBlueprint)));
-    } catch (e) {
-      console.warn(`[SlideProductionWorkflow] Failed parsing blueprint JSON, constructing fallback:`, e);
-      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 === 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"]
+  const blueprintItems = await pRetry__default.default(
+    async () => {
+      const items = await inferStructured(
+        exports.SlideBlueprintArraySchema,
+        "",
+        blueprintPrompt,
+        options,
+        "blueprint"
+      );
+      if (!items || items.length === 0) {
+        throw new Error("Blueprint generation returned empty or schema-invalid output");
+      }
+      return items.sort((a, b) => a.slideIndex - b.slideIndex).map((item, idx) => ({
+        ...item,
+        slideIndex: idx + 1,
+        clusterId: item.clusterId || Math.floor(idx / 5) + 1,
+        clusterTitle: item.clusterTitle || "Cluster",
+        lessonPhase: item.lessonPhase || "Content",
+        pedagogicalGoal: item.pedagogicalGoal || "",
+        contentFocus: item.contentFocus || []
       }));
+    },
+    {
+      retries: maxRetries - 1,
+      onFailedAttempt: (err) => {
+        onProgress?.("@illustrator", `\u26A0\uFE0F Blueprint attempt ${err.attemptNumber}/${maxRetries} failed \u2014 retrying...`, {
+          type: "warning"
+        });
+      }
     }
-  }
+  );
   const clustersMap = /* @__PURE__ */ new Map();
   for (const item of blueprintItems) {
     const cId = item.clusterId || Math.floor((item.slideIndex - 1) / 5) + 1;
@@ -1542,17 +1713,16 @@ async function executeSlideProductionWorkflow(options) {
     clustersMap.get(cId).push(item);
   }
   const clusters = Array.from(clustersMap.entries()).sort(([a], [b]) => a - b);
-  const allGeneratedSlides = [];
   const skillPrompt = presentationKitSkills?.getFrontendSlidesSkillPrompt ? presentationKitSkills.getFrontendSlidesSkillPrompt({ stylePresetId }) : "";
+  const allGeneratedSlides = [];
+  const failedClusters = [];
   let clusterIdx = 0;
   for (const [cId, clusterSlides] of clusters) {
     clusterIdx++;
     const clusterTitle = clusterSlides[0]?.clusterTitle || `Giai \u0111o\u1EA1n ${clusterIdx}`;
     onProgress?.("@illustrator", `[2/4] Sinh chi ti\u1EBFt C\u1EE5m ${clusterIdx}/${clusters.length}: "${clusterTitle}" (${clusterSlides.length} slides)...`);
     const clusterPhaseNames = new Set(clusterSlides.map((s) => s.lessonPhase.toLowerCase()));
-    const matchingPhases = lessonFlow.phases.filter(
-      (p) => clusterPhaseNames.has(p.phaseName.toLowerCase())
-    );
+    const matchingPhases = lessonFlow.phases.filter((p) => clusterPhaseNames.has(p.phaseName.toLowerCase()));
     const lessonExcerpt = matchingPhases.length > 0 ? matchingPhases.map((p) => `### ${p.phaseName}
 ${p.content}`).join("\n\n") : lessonFlow.rawContent.slice(0, 3500);
     const { systemPrompt, userPrompt } = buildSlideBatchPrompt({
@@ -1566,44 +1736,41 @@ ${p.content}`).join("\n\n") : lessonFlow.rawContent.slice(0, 3500);
       languageDirective,
       headingDirective
     });
-    const rawBatch = await runCurriculumAIInference(
-      [
-        { role: "system", content: systemPrompt },
-        { role: "user", content: userPrompt }
-      ],
-      satelliteContext,
-      runnerOptions,
-      (chunk, type) => {
-        onProgress?.("@illustrator", chunk, { type: type || "content", artifactType: "SLIDE" });
-      }
-    );
-    let batchSlides = [];
     try {
-      batchSlides = JSON.parse(extractCleanJson(rawBatch));
-    } catch {
-      try {
-        batchSlides = JSON.parse(jsonrepair.jsonrepair(extractCleanJson(rawBatch)));
-      } catch (err) {
-        console.warn(`[SlideProductionWorkflow] Batch ${cId} JSON parse failed, synthesizing slides:`, err);
-        batchSlides = clusterSlides.map((s) => ({
-          id: `slide-${s.slideIndex}`,
-          layoutId: s.layoutId,
-          title: s.title,
-          slots: {
-            lead: s.pedagogicalGoal,
-            bullets: s.contentFocus,
-            code: s.codeSnippetIntent || "// Executable demo code"
-          },
-          notes: `SCRIPT: Spoken explanation for ${s.title}.
-COLD CALL: What happens when this logic runs?
-SCAFFOLDING: Ensure proper syntax and indentation.`
-        }));
-      }
-    }
-    if (Array.isArray(batchSlides)) {
+      const batchSlides = await pRetry__default.default(
+        async () => {
+          const slides = await inferStructured(
+            exports.GeneratedSlideArraySchema,
+            systemPrompt,
+            userPrompt,
+            options,
+            `cluster-${cId}`
+          );
+          if (!slides || slides.length === 0) {
+            throw new Error(`Cluster ${cId} returned empty or schema-invalid output`);
+          }
+          return slides;
+        },
+        {
+          retries: maxRetries - 1,
+          onFailedAttempt: (err) => {
+            onProgress?.("@illustrator", `\u26A0\uFE0F C\u1EE5m ${clusterIdx} l\u1EA7n ${err.attemptNumber}/${maxRetries} l\u1ED7i \u2014 retry ri\xEAng c\u1EE5m n\xE0y...`, {
+              type: "warning"
+            });
+          }
+        }
+      );
       allGeneratedSlides.push(...batchSlides);
+    } catch (clusterErr) {
+      failedClusters.push(cId);
+      console.error(`[SlideProductionWorkflow] Cluster ${cId} permanently failed after ${maxRetries} attempts:`, clusterErr?.message || clusterErr);
     }
   }
+  if (failedClusters.length > 0) {
+    throw new Error(
+      `[SlideProductionWorkflow] Failed to generate ${failedClusters.length}/${clusters.length} cluster(s) (clusterId: ${failedClusters.join(", ")}) after ${maxRetries} attempts each. Aborting to prevent placeholder/degraded slide output. Review provider keys/model availability and retry.`
+    );
+  }
   onProgress?.("@illustrator", `[3/4] Chu\u1EA9n h\xF3a b\u1ED1 c\u1EE5c v\xE0 bi\xEAn d\u1ECBch 1920\xD71080 Stage Deck (${allGeneratedSlides.length} slides)...`);
   const normalizer = presentationKitCore?.normalizeSlideSlots;
   const normalizedSlides = allGeneratedSlides.map((s, idx) => {
@@ -1626,7 +1793,7 @@ SCAFFOLDING: Ensure proper syntax and indentation.`
         compiledHtml = compiled.html;
       }
     } catch (compErr) {
-      console.warn(`[SlideProductionWorkflow] Failed compiling HTML deck:`, compErr);
+      console.warn(`[SlideProductionWorkflow] Failed compiling HTML deck:`, compErr?.message || compErr);
     }
   }
   const markdownWrapper = `---
@@ -1645,7 +1812,7 @@ date: "${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}"
 ${JSON.stringify(deckJson, null, 2)}
 \`\`\`
 `;
-  onProgress?.("@illustrator", `[4/4] Ho\xE0n t\u1EA5t b\u1ED9 tr\xECnh chi\u1EBFu HTML 20 trang \u0111\u1EA1t chu\u1EA9n Fixed 16:9 Stage!`);
+  onProgress?.("@illustrator", `[4/4] Ho\xE0n t\u1EA5t b\u1ED9 tr\xECnh chi\u1EBFu HTML \u0111\u1EA1t chu\u1EA9n Fixed 16:9 Stage!`);
   return {
     deckJson,
     compiledHtml,
@@ -1654,12 +1821,45 @@ ${JSON.stringify(deckJson, null, 2)}
     slideCount: normalizedSlides.length
   };
 }
+exports.SlideBlueprintItemSchema = void 0; exports.SlideBlueprintArraySchema = void 0; exports.GeneratedSlideSchema = void 0; exports.GeneratedSlideArraySchema = void 0;
 var init_slideProductionWorkflow = __esm({
   "src/services/slideProductionWorkflow.ts"() {
     init_lessonFlowParser();
     init_slideBlueprintPrompt();
     init_slideBatchPrompt();
+    init_provider_factory();
     init_streamRunner();
+    exports.SlideBlueprintItemSchema = zod.z.object({
+      slideIndex: zod.z.number().int().min(1),
+      clusterId: zod.z.number().int().min(1).default(1),
+      clusterTitle: zod.z.string().default("Cluster"),
+      lessonPhase: zod.z.string().default("Content"),
+      layoutId: zod.z.enum([
+        "hero-cover",
+        "split-concept-code",
+        "two-columns-compare",
+        "three-cards-grid",
+        "timeline-steps",
+        "metric-callout",
+        "checkpoint-quiz",
+        "tiered-practice-3cards",
+        "summary-takeaways"
+      ]),
+      title: zod.z.string().min(1),
+      pedagogicalGoal: zod.z.string().default(""),
+      contentFocus: zod.z.array(zod.z.string()).default([]),
+      codeSnippetIntent: zod.z.string().optional(),
+      visualIntent: zod.z.string().optional()
+    });
+    exports.SlideBlueprintArraySchema = zod.z.array(exports.SlideBlueprintItemSchema);
+    exports.GeneratedSlideSchema = zod.z.object({
+      id: zod.z.string().optional(),
+      layoutId: zod.z.string(),
+      title: zod.z.string().min(1),
+      slots: zod.z.record(zod.z.any()).default({}),
+      notes: zod.z.string().default("")
+    });
+    exports.GeneratedSlideArraySchema = zod.z.array(exports.GeneratedSlideSchema);
   }
 });
 var LearningObjectiveRowSchema = zod.z.object({
@@ -3186,128 +3386,8 @@ var RoadmapInputSchema = zod.z.object({
   phases: zod.z.array(PhaseInputSchema).default([])
 });
 
-// src/ai/provider-factory.ts
-init_streamRunner();
-var DEFAULT_MODELS = {
-  nvidia: "nvidia/nemotron-3-ultra-550b-a55b:free",
-  openrouter: "@preset/coding-free",
-  alibaba: "qwen3.7-plus",
-  dashscope: "qwen3.7-plus",
-  google: "gemini-1.5-flash",
-  deepseek: "deepseek-chat",
-  openai: "gpt-4o-mini",
-  ollama: "deepseek-v4-flash:0731"
-};
-var NVIDIA_MODELS = {
-  codingFast: "nvidia/nemotron-3.5-lightning-30b-a3b",
-  reasoningUltra: "nvidia/nemotron-3-ultra-550b-a55b:free",
-  superMoE: "nvidia/nemotron-3-super-120b-a12b",
-  llamaNemotron: "nvidia/llama-3.1-nemotron-70b-instruct",
-  translation: "nvidia/riva-translate-4b-instruct-v2",
-  embedding: "nvidia/nemotron-3-embed-1b",
-  visionLlama: "meta/llama-3.2-11b-vision-instruct"
-};
-function getAIModel(options = {}) {
-  const designated = getDesignatedFallbackConfig();
-  const defaultProvider = process.env.DEFAULT_AI_PROVIDER || process.env.LLM_PROVIDER || detectDefaultProvider();
-  let provider = (options.provider || defaultProvider).toLowerCase();
-  if (!isProviderEnabled(provider)) {
-    console.warn(`[provider-factory] Provider "${provider}" is disabled via environment toggle. Falling back to designated provider "${designated.provider}".`);
-    provider = designated.provider;
-  }
-  let resolvedModelName = options.modelName || process.env.DEFAULT_AI_MODEL || process.env.LLM_MODEL || DEFAULT_MODELS[provider] || designated.model;
-  if (!isModelAllowed(resolvedModelName)) {
-    console.warn(`[provider-factory] Model "${resolvedModelName}" is not permitted by ALLOWED_AI_MODELS. Using designated model "${designated.model}".`);
-    resolvedModelName = designated.model;
-  }
-  if (provider === "nvidia") {
-    const apiKey = options.apiKey || process.env.NVIDIA_API_KEY || "";
-    const nvidia = openai.createOpenAI({
-      apiKey,
-      baseURL: options.baseURL || "https://integrate.api.nvidia.com/v1"
-    });
-    return nvidia.chat(resolvedModelName || "nvidia/nemotron-3-ultra-550b-a55b:free");
-  }
-  if (provider === "openrouter") {
-    const apiKey = options.apiKey || process.env.OPENROUTER_API_KEY || process.env.OPENAI_API_KEY || "";
-    const openrouter = openai.createOpenAI({
-      apiKey,
-      baseURL: options.baseURL || "https://openrouter.ai/api/v1"
-    });
-    return openrouter.chat(resolvedModelName || "@preset/coding-free");
-  }
-  if (provider === "alibaba" || provider === "dashscope") {
-    const effectiveKey = options.apiKey || process.env.ALIBABA_API_KEY || process.env.DASHSCOPE_API_KEY || process.env.SAAS_ALIBABA_API_KEY || process.env.SAAS_DASHSCOPE_API_KEY || "";
-    let defaultBaseURL = "https://dashscope-intl.aliyuncs.com/compatible-mode/v1";
-    if (effectiveKey.startsWith("sk-sp-")) {
-      defaultBaseURL = "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1";
-    }
-    const rawUrl = options.baseURL || process.env.ALIBABA_BASE_URL || process.env.DASHSCOPE_BASE_URL || defaultBaseURL;
-    const cleanBaseURL = rawUrl.replace(/^["']|["']$/g, "").trim();
-    const alibaba = openai.createOpenAI({
-      apiKey: effectiveKey,
-      baseURL: cleanBaseURL
-      // Passthrough: no forced format injection — the Vercel AI SDK's generateObject
-      // already instructs the model to return JSON via its schema definition.
-      // Injecting 'Output format: JSON.' into markdown-based lesson prompts caused
-      // model confusion (mixed markdown + JSON output).
-    });
-    return alibaba.chat(resolvedModelName);
-  }
-  if (provider === "google") {
-    const apiKey = options.apiKey || process.env.GOOGLE_GENERATIVE_AI_API_KEY || process.env.GEMINI_API_KEY || "";
-    const google$1 = google.createGoogleGenerativeAI({ apiKey });
-    return google$1(resolvedModelName);
-  }
-  if (provider === "deepseek") {
-    const apiKey = options.apiKey || process.env.DEEPSEEK_API_KEY || process.env.SAAS_DEEPSEEK_API_KEY || "";
-    const deepseek$1 = deepseek.createDeepSeek({ apiKey });
-    return deepseek$1(resolvedModelName);
-  }
-  if (provider === "openai") {
-    const apiKey = options.apiKey || process.env.OPENAI_API_KEY || "";
-    const openai$1 = openai.createOpenAI({
-      apiKey,
-      baseURL: options.baseURL || process.env.OPENAI_BASE_URL
-    });
-    return openai$1.chat(resolvedModelName);
-  }
-  if (provider === "ollama") {
-    const apiKey = options.apiKey || process.env.OLLAMA_API_KEY || "ollama";
-    const baseURL = options.baseURL || process.env.OLLAMA_BASE_URL || process.env.OPENAI_BASE_URL || "http://127.0.0.1:11434/v1";
-    const ollama = openai.createOpenAI({
-      apiKey,
-      baseURL
-    });
-    return ollama.chat(resolvedModelName || "qwen2.5:latest");
-  }
-  const fallback = openai.createOpenAI({
-    apiKey: options.apiKey || process.env.OPENAI_API_KEY || "",
-    baseURL: options.baseURL || process.env.OPENAI_BASE_URL
-  });
-  return fallback.chat(resolvedModelName);
-}
-function detectDefaultProvider() {
-  if (process.env.NVIDIA_API_KEY && isProviderEnabled("nvidia")) {
-    return "nvidia";
-  }
-  if (process.env.OPENROUTER_API_KEY && isProviderEnabled("openrouter")) {
-    return "openrouter";
-  }
-  if ((process.env.ALIBABA_API_KEY || process.env.DASHSCOPE_API_KEY || process.env.SAAS_ALIBABA_API_KEY) && isProviderEnabled("alibaba")) {
-    return "alibaba";
-  }
-  if ((process.env.GOOGLE_GENERATIVE_AI_API_KEY || process.env.GEMINI_API_KEY) && (isProviderEnabled("gemini") || isProviderEnabled("google"))) {
-    return "google";
-  }
-  if ((process.env.DEEPSEEK_API_KEY || process.env.SAAS_DEEPSEEK_API_KEY) && isProviderEnabled("deepseek")) {
-    return "deepseek";
-  }
-  if (process.env.OPENAI_API_KEY && process.env.OPENAI_API_KEY !== "ollama" && isProviderEnabled("openai")) {
-    return "openai";
-  }
-  return getDesignatedFallbackConfig().provider;
-}
+// src/ai/index.ts
+init_provider_factory();
 
 // src/templates/lessonTemplate.ts
 var LESSON_PLAN_TEMPLATE = `
@@ -6433,6 +6513,9 @@ Return a single valid JSON object matching DiagnosticQuizSchema with these exact
   }
 `.trim();
 }
+
+// src/ai/flows/generateLessonMasterFlow.ts
+init_provider_factory();
 async function generateLessonMasterFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildLessonMasterPrompt({
@@ -6452,6 +6535,9 @@ Respond with a valid JSON object matching the schema.`
   });
   return object;
 }
+
+// src/ai/flows/generateActivityFlow.ts
+init_provider_factory();
 async function generateActivityFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildActivityPrompt({
@@ -6469,6 +6555,9 @@ Respond with a valid JSON object matching the schema.`
   });
   return object;
 }
+
+// src/ai/flows/generateCodeLabFlow.ts
+init_provider_factory();
 async function generateCodeLabFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildCodeLabPrompt({
@@ -6486,6 +6575,9 @@ Respond with a valid JSON object matching the schema.`
   });
   return object;
 }
+
+// src/ai/flows/generateWorksheetFlow.ts
+init_provider_factory();
 async function generateWorksheetFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildWorksheetPrompt({
@@ -6499,6 +6591,9 @@ async function generateWorksheetFlow(input) {
   });
   return object;
 }
+
+// src/ai/flows/generateHandoutFlow.ts
+init_provider_factory();
 async function generateHandoutFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildHandoutPrompt({
@@ -6514,6 +6609,9 @@ Respond with a valid JSON object matching the schema.`
   });
   return object;
 }
+
+// src/ai/flows/generateSlidesFlow.ts
+init_provider_factory();
 async function generateSlidesFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildSlidesPrompt({
@@ -6528,6 +6626,9 @@ async function generateSlidesFlow(input) {
   });
   return object;
 }
+
+// src/ai/flows/generateTeacherGuideFlow.ts
+init_provider_factory();
 async function generateTeacherGuideFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildTeacherGuidePrompt({
@@ -6542,6 +6643,9 @@ async function generateTeacherGuideFlow(input) {
   });
   return object;
 }
+
+// src/ai/flows/generateExtensionFlow.ts
+init_provider_factory();
 async function generateExtensionFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildExtensionPrompt({
@@ -6556,6 +6660,9 @@ async function generateExtensionFlow(input) {
   });
   return object;
 }
+
+// src/ai/flows/auditCurriculumQualityFlow.ts
+init_provider_factory();
 async function auditCurriculumQualityFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildJudgePrompt({
@@ -6575,6 +6682,9 @@ Respond with a valid JSON object matching the schema.`
   });
   return object;
 }
+
+// src/ai/flows/generateProjectInstructionFlow.ts
+init_provider_factory();
 async function generateProjectInstructionFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildProjectInstructionPrompt({
@@ -6595,6 +6705,9 @@ Respond with a valid JSON object matching the schema.`
   });
   return object;
 }
+
+// src/ai/flows/generateSelfLabFlow.ts
+init_provider_factory();
 async function generateSelfLabFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildSelfLabPrompt({
@@ -6613,6 +6726,9 @@ Respond with a valid JSON object matching the schema.`
   });
   return object;
 }
+
+// src/ai/flows/generateDiagnosticQuizFlow.ts
+init_provider_factory();
 async function generateDiagnosticQuizFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildDiagnosticQuizPrompt({
@@ -6630,6 +6746,9 @@ Respond with a valid JSON object matching the schema.`
   });
   return object;
 }
+
+// src/ai/flows/streamLessonMasterFlow.ts
+init_provider_factory();
 async function streamLessonMasterFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildLessonMasterPrompt({
@@ -6647,6 +6766,9 @@ async function streamLessonMasterFlow(input) {
 Respond with a valid JSON object matching the schema.`
   });
 }
+
+// src/ai/flows/streamSelfLabFlow.ts
+init_provider_factory();
 async function streamSelfLabFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildSelfLabPrompt({
@@ -6663,6 +6785,9 @@ async function streamSelfLabFlow(input) {
 Respond with a valid JSON object matching the schema.`
   });
 }
+
+// src/ai/flows/streamDiagnosticQuizFlow.ts
+init_provider_factory();
 async function streamDiagnosticQuizFlow(input) {
   const model = getAIModel(input.modelOptions);
   const prompt = buildDiagnosticQuizPrompt({
@@ -11344,6 +11469,17 @@ function packUnitSessions(group, nodeById, spec, warnings) {
     const node = nodeById.get(id);
     const isKnowledge = node.kind === "concept";
     if (node.estimated_minutes > spec.contentBudget) {
+      if (node.estimated_minutes <= spec.sessionDurationMinutes || node.estimated_minutes <= spec.contentBudget * 1.25) {
+        if (current.entries.length > 0) flush();
+        const entry = { id, minutes: spec.contentBudget, part: 1, totalParts: 1 };
+        if (isKnowledge) current.knowledgeMinutes += entry.minutes;
+        else current.practiceMinutes += entry.minutes;
+        current.entries.push(entry);
+        current.nodeIds.push(id);
+        current.oversized = false;
+        flush();
+        continue;
+      }
       const parts = [];
       let remaining = node.estimated_minutes;
       while (remaining > 0) {
@@ -11512,6 +11648,35 @@ async function buildCurriculumPlan(rawGraph, options) {
   const unitIndexByGroup = new Map(groups.map((g, i) => [g.key, i]));
   const packed = [];
   for (const g of groups) packed.push(...packUnitSessions(g, nodeById, spec, warnings));
+  if (constraints.total_sessions && packed.length > constraints.total_sessions) {
+    warnings.push(`Initial packing produced ${packed.length} sessions, coalescing to satisfy total_sessions constraint (${constraints.total_sessions})`);
+    for (let i = 0; i < packed.length - 1 && packed.length > constraints.total_sessions; i++) {
+      const curr = packed[i];
+      const next = packed[i + 1];
+      if (curr.groupId === next.groupId) {
+        const currMins = curr.knowledgeMinutes + curr.practiceMinutes;
+        const nextMins = next.knowledgeMinutes + next.practiceMinutes;
+        const totalContent = currMins + nextMins;
+        if (currMins <= 45 || nextMins <= 45 || totalContent <= spec.contentBudget * 1.5) {
+          const scale = totalContent > spec.contentBudget ? spec.contentBudget / totalContent : 1;
+          curr.nodeIds.push(...next.nodeIds);
+          for (const e of next.entries) {
+            e.minutes = Math.max(5, Math.round(e.minutes * scale));
+            curr.entries.push(e);
+          }
+          for (const e of curr.entries) {
+            e.minutes = Math.max(5, Math.round(e.minutes * scale));
+          }
+          const scaledKnowledge = Math.round((curr.knowledgeMinutes + next.knowledgeMinutes) * scale);
+          curr.knowledgeMinutes = scaledKnowledge;
+          curr.practiceMinutes = Math.max(0, spec.contentBudget - scaledKnowledge);
+          curr.oversized = false;
+          packed.splice(i + 1, 1);
+          i--;
+        }
+      }
+    }
+  }
   packed.map(
     (_, i) => "U" + pad2(Math.min(units.length, 99)).replace("U", "U")
     /* placeholder replaced below */
@@ -27732,6 +27897,7 @@ var DeterministicPipelineRunner = class {
 
 // src/services/prefillService.ts
 init_streamRunner();
+init_provider_factory();
 var DEFAULT_STREAM_IDLE_MS = 18e4;
 var DEFAULT_STREAM_TOTAL_MS = 48e4;
 var LAYER_IDLE_BUDGET_MS = {
@@ -30951,7 +31117,6 @@ exports.MilestoneInputSchema = MilestoneInputSchema;
 exports.MisconceptionEvaluator = MisconceptionEvaluator;
 exports.MisconceptionSchema = MisconceptionSchema;
 exports.ModelPolicyResolver = ModelPolicyResolver;
-exports.NVIDIA_MODELS = NVIDIA_MODELS;
 exports.NodeKindSchema = NodeKindSchema;
 exports.OrganizerTypeEnum = OrganizerTypeEnum;
 exports.PROJECT_INSTRUCTION_TEMPLATE = PROJECT_INSTRUCTION_TEMPLATE;