@thanh01.pmt/curriculum-kit 1.4.29 → 1.4.31

package/dist/index.d.cts

@@ -765,7 +765,7 @@ declare function buildHeadingDirective(artifactType: string, slcMarkdown?: Recor
  * Provides typed, structured, and traceable error codes for all pipeline failures,
  * API exceptions, safeguard blocks, and contract violations.
  */
-type CurriculumErrorCode = 'ERR_AI_NO_API_KEY' | 'ERR_AI_RATE_LIMIT' | 'ERR_AI_AUTH_FAILED' | 'ERR_AI_NETWORK_TIMEOUT' | 'ERR_AI_RESPONSE_MALFORMED' | 'ERR_AI_ALL_PROVIDERS_FAILED' | 'ERR_SOT_MISSING' | 'ERR_SOT_INVALID_SCHEMA' | 'ERR_TASK_GATE_BLOCKED' | 'ERR_METERED_LIMIT_EXCEEDED' | 'ERR_SCHEMA_CONTRACT_VIOLATION' | 'ERR_STORAGE_IO_FAILED' | 'ERR_LESSON_NOT_IN_SOT' | 'ERR_CONTEXT_MISSING';
+type CurriculumErrorCode = 'ERR_AI_NO_API_KEY' | 'ERR_AI_RATE_LIMIT' | 'ERR_AI_AUTH_FAILED' | 'ERR_AI_NETWORK_TIMEOUT' | 'ERR_AI_RESPONSE_MALFORMED' | 'ERR_AI_ALL_PROVIDERS_FAILED' | 'ERR_CUSTOM_INFERENCE_REQUIRED' | 'ERR_SOT_MISSING' | 'ERR_SOT_INVALID_SCHEMA' | 'ERR_TASK_GATE_BLOCKED' | 'ERR_METERED_LIMIT_EXCEEDED' | 'ERR_SCHEMA_CONTRACT_VIOLATION' | 'ERR_STORAGE_IO_FAILED' | 'ERR_LESSON_NOT_IN_SOT' | 'ERR_CONTEXT_MISSING';
 interface CurriculumErrorDetail {
     errorCode: CurriculumErrorCode;
     agent?: string;
@@ -1089,7 +1089,12 @@ interface SlideProductionWorkflowOptions {
     maxRetries?: number;
     /** Max output tokens for hybrid generateText calls. Default 65536. */
     maxOutputTokens?: number;
-    /** When true (default), falls back to the legacy raw-fetch runner if generateObject fails. */
+    /** When true, ALSO allows the legacy raw-fetch runner as a structured-output
+     *  fallback after generateObject fails. Default FALSE (telemetry mandate,
+     *  2026-09-14): the raw path is invisible to the unified OpenTelemetry →
+     *  Langfuse trace, so it must never run unless explicitly opted in. When
+     *  enabled, pass runnerOptions.customInference so the fallback stays traced
+     *  (and satisfies CURRICULUM_KIT_REQUIRE_CUSTOM_INFERENCE=1). */
     allowLegacyFallback?: boolean;
     runnerOptions?: any;
     onProgress?: (agent: string, message: string, meta?: any) => void;

package/dist/index.d.ts

@@ -765,7 +765,7 @@ declare function buildHeadingDirective(artifactType: string, slcMarkdown?: Recor
  * Provides typed, structured, and traceable error codes for all pipeline failures,
  * API exceptions, safeguard blocks, and contract violations.
  */
-type CurriculumErrorCode = 'ERR_AI_NO_API_KEY' | 'ERR_AI_RATE_LIMIT' | 'ERR_AI_AUTH_FAILED' | 'ERR_AI_NETWORK_TIMEOUT' | 'ERR_AI_RESPONSE_MALFORMED' | 'ERR_AI_ALL_PROVIDERS_FAILED' | 'ERR_SOT_MISSING' | 'ERR_SOT_INVALID_SCHEMA' | 'ERR_TASK_GATE_BLOCKED' | 'ERR_METERED_LIMIT_EXCEEDED' | 'ERR_SCHEMA_CONTRACT_VIOLATION' | 'ERR_STORAGE_IO_FAILED' | 'ERR_LESSON_NOT_IN_SOT' | 'ERR_CONTEXT_MISSING';
+type CurriculumErrorCode = 'ERR_AI_NO_API_KEY' | 'ERR_AI_RATE_LIMIT' | 'ERR_AI_AUTH_FAILED' | 'ERR_AI_NETWORK_TIMEOUT' | 'ERR_AI_RESPONSE_MALFORMED' | 'ERR_AI_ALL_PROVIDERS_FAILED' | 'ERR_CUSTOM_INFERENCE_REQUIRED' | 'ERR_SOT_MISSING' | 'ERR_SOT_INVALID_SCHEMA' | 'ERR_TASK_GATE_BLOCKED' | 'ERR_METERED_LIMIT_EXCEEDED' | 'ERR_SCHEMA_CONTRACT_VIOLATION' | 'ERR_STORAGE_IO_FAILED' | 'ERR_LESSON_NOT_IN_SOT' | 'ERR_CONTEXT_MISSING';
 interface CurriculumErrorDetail {
     errorCode: CurriculumErrorCode;
     agent?: string;
@@ -1089,7 +1089,12 @@ interface SlideProductionWorkflowOptions {
     maxRetries?: number;
     /** Max output tokens for hybrid generateText calls. Default 65536. */
     maxOutputTokens?: number;
-    /** When true (default), falls back to the legacy raw-fetch runner if generateObject fails. */
+    /** When true, ALSO allows the legacy raw-fetch runner as a structured-output
+     *  fallback after generateObject fails. Default FALSE (telemetry mandate,
+     *  2026-09-14): the raw path is invisible to the unified OpenTelemetry →
+     *  Langfuse trace, so it must never run unless explicitly opted in. When
+     *  enabled, pass runnerOptions.customInference so the fallback stays traced
+     *  (and satisfies CURRICULUM_KIT_REQUIRE_CUSTOM_INFERENCE=1). */
     allowLegacyFallback?: boolean;
     runnerOptions?: any;
     onProgress?: (agent: string, message: string, meta?: any) => void;

package/dist/index.mjs

@@ -504,6 +504,13 @@ Guidelines:
       });
     }
   }
+  if (!options.customInference && resolveApiKey("CURRICULUM_KIT_REQUIRE_CUSTOM_INFERENCE") === "1") {
+    throw createAiInferenceError({
+      errorCode: "ERR_CUSTOM_INFERENCE_REQUIRED",
+      message: "customInference is REQUIRED (CURRICULUM_KIT_REQUIRE_CUSTOM_INFERENCE=1): pass buildKitCustomInference(...) so every LLM call flows through the host AI SDK gateway and its unified Langfuse tracing. Raw-fetch provider routes are disabled by mandate.",
+      rawError: { mandate: "CURRICULUM_KIT_REQUIRE_CUSTOM_INFERENCE", hasCustomInference: false }
+    });
+  }
   const formattedMessages = [
     { role: "system", content: systemInstruction },
     ...messages.map((m) => ({
@@ -1820,7 +1827,7 @@ async function inferStructured(schema, systemPrompt, userPrompt, options, label)
   } catch (aiSdkErr) {
     console.warn(`[SlideProductionWorkflow] AI SDK generateObject failed for ${label}:`, aiSdkErr?.message || aiSdkErr);
   }
-  if (options.allowLegacyFallback === false) return null;
+  if (options.allowLegacyFallback !== true) return null;
   try {
     const messages = [
       { role: "user", content: [systemPrompt, userPrompt].filter(Boolean).join("\n\n") }