@thanh01.pmt/curriculum-kit 1.4.9 → 1.4.11

package/dist/index.d.cts

@@ -365,6 +365,8 @@ interface LayerPrefillOptions {
     timeoutMs?: number;
     /** Idle (no-data) budget override for this prefill run (ms). */
     idleTimeoutMs?: number;
+    /** Optional parent abort signal (e.g. from HTTP request) to stop immediately on client disconnect. */
+    signal?: AbortSignal;
 }
 interface PreliminaryResearchResult {
     groundTruthSummary: string;
@@ -388,7 +390,7 @@ interface StreamBudget {
     /** Abort when the whole stream exceeds this total wall time (ms). 0 disables. */
     totalMs?: number;
 }
-declare const DEFAULT_STREAM_IDLE_MS = 90000;
+declare const DEFAULT_STREAM_IDLE_MS = 180000;
 declare const DEFAULT_STREAM_TOTAL_MS = 480000;
 declare const LAYER_IDLE_BUDGET_MS: Record<number, number>;
 /**
@@ -455,7 +457,7 @@ declare function createStreamChunkExtractor(): StreamChunkExtractor;
  * createStreamChunkExtractor, whose latch is the authoritative dedupe.
  */
 declare function extractStreamChunk(part: any): ExtractedStreamChunk;
-declare function createStreamAbortSignal(budget: Required<StreamBudget>): StreamAbortHandle;
+declare function createStreamAbortSignal(budget: Required<StreamBudget>, parentSignal?: AbortSignal): StreamAbortHandle;
 /**
  * Close an unterminated JSON object/array: append the delimiters that are
  * still open, closing any open string first. Handles streams aborted
@@ -485,7 +487,7 @@ declare function safeParseJson<T = any>(rawText: string | null): T | null;
 /**
  * Multi-tiered resilient streaming inference helper using 100% Vercel AI SDK.
  */
-declare function streamLLMWithFallback(systemPrompt: string, userPrompt: string, apiKeys?: Record<string, string>, onChunk?: LayerChunkCallback, preferredModel?: string, preferredProvider?: AIProviderName, budget?: StreamBudget): Promise<string | null>;
+declare function streamLLMWithFallback(systemPrompt: string, userPrompt: string, apiKeys?: Record<string, string>, onChunk?: LayerChunkCallback, preferredModel?: string, preferredProvider?: AIProviderName, budget?: StreamBudget, signal?: AbortSignal): Promise<string | null>;
 /**
  * Conducts preliminary ecosystem research for a course project.
  */

package/dist/index.d.ts

@@ -365,6 +365,8 @@ interface LayerPrefillOptions {
     timeoutMs?: number;
     /** Idle (no-data) budget override for this prefill run (ms). */
     idleTimeoutMs?: number;
+    /** Optional parent abort signal (e.g. from HTTP request) to stop immediately on client disconnect. */
+    signal?: AbortSignal;
 }
 interface PreliminaryResearchResult {
     groundTruthSummary: string;
@@ -388,7 +390,7 @@ interface StreamBudget {
     /** Abort when the whole stream exceeds this total wall time (ms). 0 disables. */
     totalMs?: number;
 }
-declare const DEFAULT_STREAM_IDLE_MS = 90000;
+declare const DEFAULT_STREAM_IDLE_MS = 180000;
 declare const DEFAULT_STREAM_TOTAL_MS = 480000;
 declare const LAYER_IDLE_BUDGET_MS: Record<number, number>;
 /**
@@ -455,7 +457,7 @@ declare function createStreamChunkExtractor(): StreamChunkExtractor;
  * createStreamChunkExtractor, whose latch is the authoritative dedupe.
  */
 declare function extractStreamChunk(part: any): ExtractedStreamChunk;
-declare function createStreamAbortSignal(budget: Required<StreamBudget>): StreamAbortHandle;
+declare function createStreamAbortSignal(budget: Required<StreamBudget>, parentSignal?: AbortSignal): StreamAbortHandle;
 /**
  * Close an unterminated JSON object/array: append the delimiters that are
  * still open, closing any open string first. Handles streams aborted
@@ -485,7 +487,7 @@ declare function safeParseJson<T = any>(rawText: string | null): T | null;
 /**
  * Multi-tiered resilient streaming inference helper using 100% Vercel AI SDK.
  */
-declare function streamLLMWithFallback(systemPrompt: string, userPrompt: string, apiKeys?: Record<string, string>, onChunk?: LayerChunkCallback, preferredModel?: string, preferredProvider?: AIProviderName, budget?: StreamBudget): Promise<string | null>;
+declare function streamLLMWithFallback(systemPrompt: string, userPrompt: string, apiKeys?: Record<string, string>, onChunk?: LayerChunkCallback, preferredModel?: string, preferredProvider?: AIProviderName, budget?: StreamBudget, signal?: AbortSignal): Promise<string | null>;
 /**
  * Conducts preliminary ecosystem research for a course project.
  */

package/dist/index.mjs

@@ -5448,6 +5448,11 @@ Every slide MUST include notes with:
 - Cold-Call: 1 check question
 - Scaffolding Tip: 1 analogy or hint
 
+### \u26A0\uFE0F STRICT SLIDE FORMATTING INVARIANTS:
+1. Every slide MUST store its content fields inside "slots": { ... }. NEVER put "title", "content", or points at the top level of a slide!
+2. All code slots MUST contain real, executable, high-fidelity code. Never use placeholders like "<CODE>" or "...".
+3. All point and card slots MUST contain concrete, rich pedagogical explanations. Never use placeholder dots or empty cards.
+
 ### Output JSON Format:
 \`\`\`json
 {
@@ -25315,10 +25320,15 @@ ${buildHeadingDirective("QUIZ", slcMarkdown, targetLang)}`;
     const isHtmlEngine = options.slidesEngine === "html";
     if (isHtmlEngine) {
       let presentationKitAi = null;
+      let presentationKitCore = null;
       try {
         presentationKitAi = await import('@thanh01.pmt/presentation-kit/ai');
       } catch {
       }
+      try {
+        presentationKitCore = await import('@thanh01.pmt/presentation-kit');
+      } catch {
+      }
       const slidePrompt = buildHtmlDeckSlidePrompt({
         lessonCode,
         lessonTitle,
@@ -25353,12 +25363,21 @@ ${glossaryContext}` : void 0,
         const candidate = fenceMatch ? fenceMatch[1] : str;
         return candidate.trim();
       };
+      const normalizeDeckSlides = (deck) => {
+        const normalizer = presentationKitCore?.normalizeSlideSlots || presentationKitAi?.normalizeSlideSlots;
+        if (deck && Array.isArray(deck.slides) && normalizer) {
+          deck.slides = deck.slides.map((s) => normalizer(s));
+        }
+        return deck;
+      };
       try {
         deckJson = JSON.parse(extractCleanJson(rawSlide));
+        deckJson = normalizeDeckSlides(deckJson);
       } catch {
         try {
           const { jsonrepair: jsonrepair2 } = await import('jsonrepair');
           deckJson = JSON.parse(jsonrepair2(extractCleanJson(rawSlide)));
+          deckJson = normalizeDeckSlides(deckJson);
         } catch {
         }
       }
@@ -25380,11 +25399,13 @@ Fix ALL issues and output the complete corrected JSON object strictly matching t
         );
         try {
           deckJson = JSON.parse(extractCleanJson(repairedRaw));
+          deckJson = normalizeDeckSlides(deckJson);
           validation = presentationKitAi.validateHtmlSlideDeck(deckJson, true);
         } catch {
           try {
             const { jsonrepair: jsonrepair2 } = await import('jsonrepair');
             deckJson = JSON.parse(jsonrepair2(extractCleanJson(repairedRaw)));
+            deckJson = normalizeDeckSlides(deckJson);
             validation = presentationKitAi.validateHtmlSlideDeck(deckJson, true);
           } catch {
           }
@@ -25412,9 +25433,10 @@ ${JSON.stringify(deckJson || {}, null, 2)}
         const deckJsonStr = JSON.stringify(deckJson, null, 2);
         await storage.saveArtifact(projectId, `_content/${unitCode}/SLIDE_${lessonCode}.deck.json`, deckJsonStr);
         producedArtifacts.push(`SLIDE_${lessonCode}.deck.json`);
-        if (presentationKitAi?.compileHtmlDeck) {
+        const compiler = presentationKitCore?.compileHtmlDeck || presentationKitAi?.compileHtmlDeck;
+        if (compiler) {
           try {
-            const compiled = presentationKitAi.compileHtmlDeck(deckJson);
+            const compiled = compiler(deckJson);
             if (compiled?.html) {
               await storage.saveArtifact(projectId, `_content/${unitCode}/SLIDE_${lessonCode}.html`, compiled.html);
               producedArtifacts.push(`SLIDE_${lessonCode}.html`);
@@ -27291,13 +27313,13 @@ var DeterministicPipelineRunner = class {
 
 // src/services/prefillService.ts
 init_streamRunner();
-var DEFAULT_STREAM_IDLE_MS = 9e4;
+var DEFAULT_STREAM_IDLE_MS = 18e4;
 var DEFAULT_STREAM_TOTAL_MS = 48e4;
 var LAYER_IDLE_BUDGET_MS = {
-  1: 9e4,
-  2: 9e4,
+  1: 18e4,
+  2: 18e4,
   3: 18e4
-  // Layer 3 synthesizes all accumulated context + pathways (3 minutes idle protection)
+  // 3 minutes idle protection across all layers for free-tier reasoning models
 };
 var LAYER_TOTAL_BUDGET_MS = {
   1: 48e4,
@@ -27358,10 +27380,20 @@ function extractStreamChunk(part) {
   }
   return {};
 }
-function createStreamAbortSignal(budget) {
+function createStreamAbortSignal(budget, parentSignal) {
   const controller = new AbortController();
   let idleTimer = null;
   let totalTimer = null;
+  const onParentAbort = () => {
+    controller.abort(parentSignal?.reason || new Error("Aborted by parent signal"));
+  };
+  if (parentSignal) {
+    if (parentSignal.aborted) {
+      controller.abort(parentSignal.reason || new Error("Parent signal already aborted"));
+    } else {
+      parentSignal.addEventListener("abort", onParentAbort, { once: true });
+    }
+  }
   const armIdle = () => {
     if (idleTimer) clearTimeout(idleTimer);
     if (budget.idleMs > 0) {
@@ -27388,6 +27420,9 @@ function createStreamAbortSignal(budget) {
     dispose: () => {
       if (idleTimer) clearTimeout(idleTimer);
       if (totalTimer) clearTimeout(totalTimer);
+      if (parentSignal) {
+        parentSignal.removeEventListener("abort", onParentAbort);
+      }
       idleTimer = null;
       totalTimer = null;
     }
@@ -27499,7 +27534,7 @@ function safeParseJson(rawText) {
   }
   return null;
 }
-async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onChunk, preferredModel, preferredProvider, budget) {
+async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onChunk, preferredModel, preferredProvider, budget, signal) {
   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;
@@ -27531,7 +27566,6 @@ async function streamLLMWithFallback(systemPrompt, userPrompt, apiKeys = {}, onC
     const nemotronModels = [
       "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) {
@@ -27582,8 +27616,12 @@ THINKING DIRECTIVE: Do ALL your reasoning internally BEFORE emitting output. Do
     totalMs: budget?.totalMs ?? DEFAULT_STREAM_TOTAL_MS
   };
   for (const candidate of candidates) {
+    if (signal?.aborted) {
+      console.log(`[curriculum-kit:VercelAI] AbortSignal already aborted, cancelling candidate loop.`);
+      break;
+    }
     const t0 = Date.now();
-    const abort = createStreamAbortSignal(resolvedBudget);
+    const abort = createStreamAbortSignal(resolvedBudget, signal);
     try {
       const modelInstance = getAIModel({
         provider: candidate.provider,
@@ -27615,6 +27653,13 @@ THINKING DIRECTIVE: Do ALL your reasoning internally BEFORE emitting output. Do
       }
     } catch (e) {
       console.warn(`[curriculum-kit:VercelAI] Candidate ${candidate.provider} (${candidate.model}) failed in ${Date.now() - t0}ms:`, e?.message || e);
+      const isClientAborted = Boolean(
+        signal?.aborted || e?.name === "AbortError" && signal?.aborted || e?.message && (e.message.includes("Controller is already closed") || e.message.includes("The operation was aborted") || e.message.includes("Aborted by parent signal"))
+      );
+      if (isClientAborted) {
+        console.log(`[curriculum-kit:VercelAI] Client aborted or stream closed, halting candidate fallback loop.`);
+        break;
+      }
     } finally {
       abort.dispose();
     }
@@ -27666,7 +27711,8 @@ Return concise JSON matching:
       totalMs: options.timeoutMs,
       model: options.model,
       provider: options.provider
-    })
+    }),
+    options.signal
   );
   let parsedResearch = {
     groundTruthSummary: `Verified ecosystem standards for ${projectName}`,
@@ -27876,7 +27922,8 @@ REQUIREMENT: Synthesize ALL parameters above \u2014 every single line in FULL AC
       totalMs: options.timeoutMs,
       model: options.model,
       provider: options.provider
-    })
+    }),
+    options.signal
   );
   const parsed = safeParseJson(rawContent);
   return {