@thanh01.pmt/curriculum-kit 1.4.18 → 1.4.21

package/dist/index.d.cts

@@ -9,11 +9,11 @@ export { ArtifactLintReport, ConvertedSotBundle, GenerateProjectInstructionOptio
 export { A as AutoRepairOptions, a as AutoRepairResult, B as BundleTier, G as GenerateMilestoneBundleOptions, M as MilestoneCurriculumBundle, g as generateMilestoneCurriculumBundle, w as withAutoRepair } from './milestoneBundleGenerator-CzSOeAzU.cjs';
 import { I as ICurriculumStorage, P as ProjectStatusReport, S as SmartResumeContext, Q as QualityAuditReport } from './types-BUJGYiep.cjs';
 export { b as ArtifactLifecycleInfo, A as ArtifactLifecycleState, L as LessonArtifactSummary, c as PipelineState, R as ReviewRecord, a as SotDocument, T as TaskLifecycleState } from './types-BUJGYiep.cjs';
-export { FileSystemCurriculumAdapter, FileSystemStorageOptions, STANDARD_SOT_FILES, StorageFactoryOptions, SupabaseCurriculumAdapter, SupabaseStorageConfig, computeContentHash, createCurriculumStorage } from './storage/index.cjs';
+export { FileSystemCurriculumAdapter, FileSystemStorageOptions, STANDARD_SOT_FILES, StorageFactoryOptions, SupabaseCurriculumAdapter, SupabaseStorageConfig, atomicWriteFileSync, computeContentHash, createCurriculumStorage } from './storage/index.cjs';
 import { F as FrameworkPack, C as CoverageGateReport } from './standardsCoverageGate-DR5YTtlt.cjs';
 export { B as BloomHintSchema, a as ClassificationSchema, m as CoverageGateInput, h as FrameworkMapping, d as FrameworkMappingSchema, f as FrameworkPackManifest, b as FrameworkPackManifestSchema, e as FrameworkPackSchema, g as FrameworkStatement, c as FrameworkStatementSchema, G as GradeBandSchema, i as MappingKind, M as MappingKindSchema, P as PackLintIssue, k as PackValidationResult, j as RecordProvenance, R as RecordProvenanceSchema, S as StatementCoverageRow, n as evaluateStandardsCoverage, l as lintFrameworkPack, v as validateFrameworkPack } from './standardsCoverageGate-DR5YTtlt.cjs';
-import { R as ResolvedGateSettings } from './gateSettings-L3FR2-MO.cjs';
-export { A as ArtifactType, b as CurriculumArtifactType, C as CurriculumGateMode, D as DEFAULT_GATE_SETTINGS, G as GateSettings, c as ScaffoldingLevel, S as SingleArtifactRequest, a as SingleArtifactResult, g as gateModeFor, e as generateSingleArtifact, d as getArtifactMetadata, p as parseGateSettings, r as resolveGateSettings } from './gateSettings-L3FR2-MO.cjs';
+import { R as ResolvedGateSettings } from './gateSettings-DabOqP6_.cjs';
+export { A as ArtifactType, B as BoundaryPeek, b as CurriculumArtifactType, C as CurriculumGateMode, h as CurriculumHorizon, D as DEFAULT_GATE_SETTINGS, f as DetailedLessonBridge, E as ExtractCurriculumHorizonOptions, G as GateSettings, H as HorizonSessionSnapshot, i as HorizonValidationResult, c as ScaffoldingLevel, S as SingleArtifactRequest, a as SingleArtifactResult, k as extractCurriculumHorizon, g as gateModeFor, e as generateSingleArtifact, d as getArtifactMetadata, j as parseAllSessions, p as parseGateSettings, l as renderHorizonPromptBlock, r as resolveGateSettings, v as validateHorizonCompliance } from './gateSettings-DabOqP6_.cjs';
 import { z } from 'zod';
 export { DeliveryPackResult, JobManifest, LocalWorkspaceManager, ParsedQuizQuestion, buildDeliveryPackages, exportAllProjectQuizzes, formatQuizzesToCsv, parseQuizMarkdown } from './publishers/index.cjs';
 export { G as GitPublishOptions, a as GitPublishResult, S as SupabasePublishOptions, b as SupabasePublishResult, p as publishToGitHub, c as publishToSupabase, u as uploadAssetToBucket } from './supabasePublisher-C627qXFT.cjs';
@@ -227,6 +227,73 @@ declare function produceBatchLessons(storage: ICurriculumStorage, projectId: str
     report: ProjectStatusReport;
 }>;
 
+interface ExcerptOptions {
+    /**
+     * Canonical (English) section keys to prioritize, in order.
+     * Each key's body is included before moving to the next priority.
+     */
+    priorities?: string[];
+    /** Character budget for the excerpt (default 12_000, ~3k tokens). */
+    budget?: number;
+    /**
+     * Section Language Contract mapping (Record or raw contract markdown).
+     * Used to resolve localized headings (e.g. Vietnamese) to canonical keys.
+     */
+    sectionLanguageContract?: Record<string, Record<string, string>> | string;
+    /** File name or artifact type hint (e.g. 'LESSON', 'KNOWLEDGE_EXPOSITION'). */
+    artifactType?: string;
+    /**
+     * Source file name (e.g. `LESSON_U03_M01_L06.md`) — artifact type derived
+     * from it when `artifactType` is not given. Matches the web app's builder
+     * option so both call-sites share one contract.
+     */
+    fileName?: string;
+    /** Min chars below which the excerpt is flagged as insufficient (default 400). */
+    minContentChars?: number;
+}
+interface ExcerptResult {
+    /** Excerpt markdown safe to inject into prompt context blocks. */
+    excerpt: string;
+    /** True when the source parsed cleanly, passed sufficiency checks, and resolved priorities. */
+    verified: boolean;
+    /** True when canonical section resolution matched at least one priority section. */
+    sectionAware: boolean;
+    /** Canonical section keys included in the excerpt, in order. */
+    includedSections: string[];
+    /** Warning or error flags explaining why verified === false. */
+    issues: string[];
+    /** Approximate token count (chars / 4). */
+    tokenEstimate: number;
+}
+declare const DEFAULT_LESSON_PRIORITIES: string[];
+/**
+ * Priorities for the canonical-lesson excerpt injected into SATELLITE artifact
+ * contexts (ACT, QUIZ, SLIDE, ...). Excludes 'Symbol & Identifier Ledger' —
+ * the symbol registry is injected as its own dedicated block
+ * ([MANDATORY CODE SYMBOL REGISTRY]) to avoid duplicated ground truth.
+ */
+declare const SATELLITE_LESSON_PRIORITIES: string[];
+declare const DEFAULT_KX_PRIORITIES: string[];
+declare function buildSectionAwareExcerpt(markdown: string, opts?: ExcerptOptions): ExcerptResult;
+declare function buildExpositionExcerpt(markdown: string, opts?: Omit<ExcerptOptions, 'priorities'>): ExcerptResult;
+declare function buildLessonExcerpt(markdown: string, opts?: Omit<ExcerptOptions, 'priorities'>): ExcerptResult;
+/**
+ * Normalizes SLC input into a two-level map: Record<ArtifactType, Record<CanonicalKey, LocalizedLabel>>
+ */
+declare function normalizeSlcContract(slc: Record<string, Record<string, string>> | string | undefined): Record<string, Record<string, string>> | undefined;
+/**
+ * Extracts code symbol & identifier contracts from LESSON markdown.
+ * Provides deterministic symbol names (Primary Struct/Class, Entry File, Key Functions)
+ * so all satellite agents (@activity, @illustrator, @assessor) inherit them verbatim.
+ */
+interface SymbolLedgerResult {
+    primarySymbol?: string;
+    entryFileName?: string;
+    keySymbols: string[];
+    rawBlock: string;
+}
+declare function extractSymbolLedger(lessonMarkdown: string): SymbolLedgerResult;
+
 interface ProjectCreationPayload {
     projectName: string;
     projectCode: string;
@@ -669,66 +736,6 @@ declare function extractSectionHeadingsFromSLC(slcInput: Record<string, Record<s
  */
 declare function buildHeadingDirective(artifactType: string, slcMarkdown?: Record<string, Record<string, string>> | string | null, targetLanguage?: string): string;
 
-interface ExcerptOptions {
-    /**
-     * Canonical (English) section keys to prioritize, in order.
-     * Each key's body is included before moving to the next priority.
-     */
-    priorities?: string[];
-    /** Character budget for the excerpt (default 12_000, ~3k tokens). */
-    budget?: number;
-    /**
-     * Section Language Contract mapping (Record or raw contract markdown).
-     * Used to resolve localized headings (e.g. Vietnamese) to canonical keys.
-     */
-    sectionLanguageContract?: Record<string, Record<string, string>> | string;
-    /** File name or artifact type hint (e.g. 'LESSON', 'KNOWLEDGE_EXPOSITION'). */
-    artifactType?: string;
-    /**
-     * Source file name (e.g. `LESSON_U03_M01_L06.md`) — artifact type derived
-     * from it when `artifactType` is not given. Matches the web app's builder
-     * option so both call-sites share one contract.
-     */
-    fileName?: string;
-    /** Min chars below which the excerpt is flagged as insufficient (default 400). */
-    minContentChars?: number;
-}
-interface ExcerptResult {
-    /** Excerpt markdown safe to inject into prompt context blocks. */
-    excerpt: string;
-    /** True when the source parsed cleanly, passed sufficiency checks, and resolved priorities. */
-    verified: boolean;
-    /** True when canonical section resolution matched at least one priority section. */
-    sectionAware: boolean;
-    /** Canonical section keys included in the excerpt, in order. */
-    includedSections: string[];
-    /** Warning or error flags explaining why verified === false. */
-    issues: string[];
-    /** Approximate token count (chars / 4). */
-    tokenEstimate: number;
-}
-declare const DEFAULT_LESSON_PRIORITIES: string[];
-declare const DEFAULT_KX_PRIORITIES: string[];
-declare function buildSectionAwareExcerpt(markdown: string, opts?: ExcerptOptions): ExcerptResult;
-declare function buildExpositionExcerpt(markdown: string, opts?: Omit<ExcerptOptions, 'priorities'>): ExcerptResult;
-declare function buildLessonExcerpt(markdown: string, opts?: Omit<ExcerptOptions, 'priorities'>): ExcerptResult;
-/**
- * Normalizes SLC input into a two-level map: Record<ArtifactType, Record<CanonicalKey, LocalizedLabel>>
- */
-declare function normalizeSlcContract(slc: Record<string, Record<string, string>> | string | undefined): Record<string, Record<string, string>> | undefined;
-/**
- * Extracts code symbol & identifier contracts from LESSON markdown.
- * Provides deterministic symbol names (Primary Struct/Class, Entry File, Key Functions)
- * so all satellite agents (@activity, @illustrator, @assessor) inherit them verbatim.
- */
-interface SymbolLedgerResult {
-    primarySymbol?: string;
-    entryFileName?: string;
-    keySymbols: string[];
-    rawBlock: string;
-}
-declare function extractSymbolLedger(lessonMarkdown: string): SymbolLedgerResult;
-
 /**
  * Curriculum OS - Standardized Error Taxonomy & Traceability System
  *
@@ -817,110 +824,217 @@ interface SlideBlueprintItem {
 
 declare const SlideBlueprintItemSchema: z.ZodObject<{
     slideIndex: z.ZodNumber;
-    clusterId: z.ZodDefault<z.ZodNumber>;
-    clusterTitle: z.ZodDefault<z.ZodString>;
-    lessonPhase: z.ZodDefault<z.ZodString>;
+    clusterId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    clusterTitle: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    lessonPhase: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     layoutId: z.ZodEnum<["hero-cover", "split-concept-code", "two-columns-compare", "three-cards-grid", "timeline-steps", "metric-callout", "checkpoint-quiz", "tiered-practice-3cards", "summary-takeaways"]>;
     title: z.ZodString;
-    pedagogicalGoal: z.ZodDefault<z.ZodString>;
-    contentFocus: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    codeSnippetIntent: z.ZodOptional<z.ZodString>;
-    visualIntent: z.ZodOptional<z.ZodString>;
+    pedagogicalGoal: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    contentFocus: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>>;
+    codeSnippetIntent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visualIntent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     title: string;
-    clusterId: number;
-    clusterTitle: string;
+    clusterId: number | null;
+    clusterTitle: string | null;
     slideIndex: number;
-    lessonPhase: string;
+    lessonPhase: string | null;
     layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
-    pedagogicalGoal: string;
-    contentFocus: string[];
-    codeSnippetIntent?: string | undefined;
-    visualIntent?: string | undefined;
+    pedagogicalGoal: string | null;
+    contentFocus: string[] | null;
+    codeSnippetIntent?: string | null | undefined;
+    visualIntent?: string | null | undefined;
 }, {
     title: string;
     slideIndex: number;
     layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
-    clusterId?: number | undefined;
-    clusterTitle?: string | undefined;
-    lessonPhase?: string | undefined;
-    pedagogicalGoal?: string | undefined;
-    contentFocus?: string[] | undefined;
-    codeSnippetIntent?: string | undefined;
-    visualIntent?: string | undefined;
+    clusterId?: number | null | undefined;
+    clusterTitle?: string | null | undefined;
+    lessonPhase?: string | null | undefined;
+    pedagogicalGoal?: string | null | undefined;
+    contentFocus?: string[] | null | undefined;
+    codeSnippetIntent?: string | null | undefined;
+    visualIntent?: string | null | undefined;
 }>;
 declare const SlideBlueprintArraySchema: z.ZodArray<z.ZodObject<{
     slideIndex: z.ZodNumber;
-    clusterId: z.ZodDefault<z.ZodNumber>;
-    clusterTitle: z.ZodDefault<z.ZodString>;
-    lessonPhase: z.ZodDefault<z.ZodString>;
+    clusterId: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+    clusterTitle: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    lessonPhase: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
     layoutId: z.ZodEnum<["hero-cover", "split-concept-code", "two-columns-compare", "three-cards-grid", "timeline-steps", "metric-callout", "checkpoint-quiz", "tiered-practice-3cards", "summary-takeaways"]>;
     title: z.ZodString;
-    pedagogicalGoal: z.ZodDefault<z.ZodString>;
-    contentFocus: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
-    codeSnippetIntent: z.ZodOptional<z.ZodString>;
-    visualIntent: z.ZodOptional<z.ZodString>;
+    pedagogicalGoal: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    contentFocus: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>>;
+    codeSnippetIntent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visualIntent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
     title: string;
-    clusterId: number;
-    clusterTitle: string;
+    clusterId: number | null;
+    clusterTitle: string | null;
     slideIndex: number;
-    lessonPhase: string;
+    lessonPhase: string | null;
     layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
-    pedagogicalGoal: string;
-    contentFocus: string[];
-    codeSnippetIntent?: string | undefined;
-    visualIntent?: string | undefined;
+    pedagogicalGoal: string | null;
+    contentFocus: string[] | null;
+    codeSnippetIntent?: string | null | undefined;
+    visualIntent?: string | null | undefined;
 }, {
     title: string;
     slideIndex: number;
     layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
-    clusterId?: number | undefined;
-    clusterTitle?: string | undefined;
-    lessonPhase?: string | undefined;
-    pedagogicalGoal?: string | undefined;
-    contentFocus?: string[] | undefined;
-    codeSnippetIntent?: string | undefined;
-    visualIntent?: string | undefined;
+    clusterId?: number | null | undefined;
+    clusterTitle?: string | null | undefined;
+    lessonPhase?: string | null | undefined;
+    pedagogicalGoal?: string | null | undefined;
+    contentFocus?: string[] | null | undefined;
+    codeSnippetIntent?: string | null | undefined;
+    visualIntent?: string | null | undefined;
 }>, "many">;
 declare const GeneratedSlideSchema: z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     layoutId: z.ZodString;
     title: z.ZodString;
-    slots: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    notes: z.ZodDefault<z.ZodString>;
+    slots: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>>;
+    notes: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
 }, "strip", z.ZodTypeAny, {
     title: string;
     layoutId: string;
-    slots: Record<string, any>;
-    notes: string;
-    id?: string | undefined;
+    slots: Record<string, any> | null;
+    notes: string | null;
+    id?: string | null | undefined;
 }, {
     title: string;
     layoutId: string;
-    id?: string | undefined;
-    slots?: Record<string, any> | undefined;
-    notes?: string | undefined;
+    id?: string | null | undefined;
+    slots?: Record<string, any> | null | undefined;
+    notes?: string | null | undefined;
 }>;
 declare const GeneratedSlideArraySchema: z.ZodArray<z.ZodObject<{
-    id: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    layoutId: z.ZodString;
+    title: z.ZodString;
+    slots: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>>;
+    notes: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    layoutId: string;
+    slots: Record<string, any> | null;
+    notes: string | null;
+    id?: string | null | undefined;
+}, {
+    title: string;
+    layoutId: string;
+    id?: string | null | undefined;
+    slots?: Record<string, any> | null | undefined;
+    notes?: string | null | undefined;
+}>, "many">;
+declare const HybridBlueprintItemSchema: z.ZodObject<{
+    slideIndex: z.ZodNumber;
+    clusterId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    clusterTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lessonPhase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    layoutId: z.ZodEnum<["hero-cover", "split-concept-code", "two-columns-compare", "three-cards-grid", "timeline-steps", "metric-callout", "checkpoint-quiz", "tiered-practice-3cards", "summary-takeaways"]>;
+    title: z.ZodString;
+    pedagogicalGoal: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    contentFocus: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>>;
+    codeSnippetIntent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visualIntent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    slideIndex: number;
+    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    pedagogicalGoal: string | null;
+    contentFocus: string[] | null;
+    clusterId?: number | null | undefined;
+    clusterTitle?: string | null | undefined;
+    lessonPhase?: string | null | undefined;
+    codeSnippetIntent?: string | null | undefined;
+    visualIntent?: string | null | undefined;
+}, {
+    title: string;
+    slideIndex: number;
+    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    clusterId?: number | null | undefined;
+    clusterTitle?: string | null | undefined;
+    lessonPhase?: string | null | undefined;
+    pedagogicalGoal?: string | null | undefined;
+    contentFocus?: string[] | null | undefined;
+    codeSnippetIntent?: string | null | undefined;
+    visualIntent?: string | null | undefined;
+}>;
+declare const HybridBlueprintArraySchema: z.ZodArray<z.ZodObject<{
+    slideIndex: z.ZodNumber;
+    clusterId: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    clusterTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    lessonPhase: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    layoutId: z.ZodEnum<["hero-cover", "split-concept-code", "two-columns-compare", "three-cards-grid", "timeline-steps", "metric-callout", "checkpoint-quiz", "tiered-practice-3cards", "summary-takeaways"]>;
+    title: z.ZodString;
+    pedagogicalGoal: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    contentFocus: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>>;
+    codeSnippetIntent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    visualIntent: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    slideIndex: number;
+    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    pedagogicalGoal: string | null;
+    contentFocus: string[] | null;
+    clusterId?: number | null | undefined;
+    clusterTitle?: string | null | undefined;
+    lessonPhase?: string | null | undefined;
+    codeSnippetIntent?: string | null | undefined;
+    visualIntent?: string | null | undefined;
+}, {
+    title: string;
+    slideIndex: number;
+    layoutId: "tiered-practice-3cards" | "split-concept-code" | "hero-cover" | "two-columns-compare" | "three-cards-grid" | "timeline-steps" | "metric-callout" | "checkpoint-quiz" | "summary-takeaways";
+    clusterId?: number | null | undefined;
+    clusterTitle?: string | null | undefined;
+    lessonPhase?: string | null | undefined;
+    pedagogicalGoal?: string | null | undefined;
+    contentFocus?: string[] | null | undefined;
+    codeSnippetIntent?: string | null | undefined;
+    visualIntent?: string | null | undefined;
+}>, "many">;
+declare const HybridDeckSlideSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    layoutId: z.ZodString;
+    title: z.ZodString;
+    slots: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>>;
+    notes: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+}, "strip", z.ZodTypeAny, {
+    title: string;
+    layoutId: string;
+    slots: Record<string, any> | null;
+    notes: string | null;
+    id?: string | null | undefined;
+}, {
+    title: string;
+    layoutId: string;
+    id?: string | null | undefined;
+    slots?: Record<string, any> | null | undefined;
+    notes?: string | null | undefined;
+}>;
+declare const HybridDeckSlideArraySchema: z.ZodArray<z.ZodObject<{
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     layoutId: z.ZodString;
     title: z.ZodString;
-    slots: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
-    notes: z.ZodDefault<z.ZodString>;
+    slots: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>>;
+    notes: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
 }, "strip", z.ZodTypeAny, {
     title: string;
     layoutId: string;
-    slots: Record<string, any>;
-    notes: string;
-    id?: string | undefined;
+    slots: Record<string, any> | null;
+    notes: string | null;
+    id?: string | null | undefined;
 }, {
     title: string;
     layoutId: string;
-    id?: string | undefined;
-    slots?: Record<string, any> | undefined;
-    notes?: string | undefined;
+    id?: string | null | undefined;
+    slots?: Record<string, any> | null | undefined;
+    notes?: string | null | undefined;
 }>, "many">;
+type SlideEngine = 'hybrid' | 'chunked';
 interface SlideProductionWorkflowOptions {
     lessonMarkdown: string;
     lessonCode: string;
@@ -930,11 +1044,24 @@ interface SlideProductionWorkflowOptions {
     language?: string;
     languageDirective?: string;
     headingDirective?: string;
+    /**
+     * Ground-truth context (framework, style guide, glossary, GROUND TRUTH KX+RefPack,
+     * session slice, horizon, symbol registry) injected into the PRIMARY system prompt
+     * of every authoring call — hybrid full-deck and chunked batches alike.
+     * Without it, only the legacy raw-fetch fallback sees this context.
+     * Deliberately EXCLUDES the canonical lesson excerpt: lesson phase content is
+     * already injected into user prompts via parseLessonFlow (no duplication).
+     */
+    groundContext?: string;
     satelliteContext?: any;
     /** Vercel AI SDK model resolution options (provider/model/apiKey). */
     modelOptions?: ModelResolutionOptions;
-    /** Max attempts per inference unit (blueprint / each cluster). Default 3. */
+    /** Which engine to run. Default 'hybrid'; 'hybrid' auto-falls back to 'chunked'. */
+    engine?: SlideEngine;
+    /** Max attempts per inference unit (blueprint / each cluster / full deck). Default 3. */
     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. */
     allowLegacyFallback?: boolean;
     runnerOptions?: any;
@@ -946,7 +1073,38 @@ interface SlideProductionWorkflowResult {
     markdownWrapper: string;
     blueprint: SlideBlueprintItem[];
     slideCount: number;
+    /** Which engine actually produced the deck (hybrid may fall back to chunked). */
+    engine: SlideEngine;
 }
+/** Thrown when the hybrid engine exhausts its attempts; triggers chunked fallback. */
+declare class HybridPipelineError extends Error {
+}
+interface ExtractedJson {
+    value?: unknown;
+    error?: string;
+    head?: string;
+    tail?: string;
+}
+declare function extractJsonArray(raw: string | undefined | null): ExtractedJson;
+declare function validateHybridDeckSlides(slides: any[], blueprint: SlideBlueprintItem[]): string[];
+/**
+ * Normalize the AI SDK's usage shape and forward it through onProgress in the
+ * kit's canonical usage contract (`JSON.stringify({ promptTokens,
+ * completionTokens, totalTokens, reasoningTokens })` + `meta.type = 'usage'`).
+ *
+ * 5-Whys RC-telemetry (2026-09-13): the slide workflow never emitted usage, so
+ * the app-side queue recorded inputTokens=0/outputTokens=0 for every SLIDE
+ * execution. AI SDK v5+ renames the fields (inputTokens/outputTokens) — read
+ * both shapes defensively.
+ */
+declare function emitUsage(usage: {
+    promptTokens?: number;
+    completionTokens?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    reasoningTokens?: number;
+} | undefined, onProgress?: (agent: string, message: string, meta?: any) => void): void;
 declare function executeSlideProductionWorkflow(options: SlideProductionWorkflowOptions): Promise<SlideProductionWorkflowResult>;
 
 /**
@@ -1247,4 +1405,4 @@ declare function getSlideLayoutPresetById(id: string): SlideLayoutPreset | undef
  */
 declare function getSlideLayoutPresetsByCategory(category: SlideLayoutCategory): SlideLayoutPreset[];
 
-export { ACT_TEMPLATE, AIProviderName, ARTIFACT_DEPENDENCY_ROUTING, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, type ArtifactDependencyRule, type ArtifactProductionSpec, type AuditBundleInput, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BloomTaxonomyEvaluator, type BuildContextOptions, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, type ContextInjectionMeta, type ContextSourceKey, CoverageGateReport, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_KX_PRIORITIES, DEFAULT_LESSON_PRIORITIES, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DEFAULT_VIETNAMESE_SECTION_HEADINGS, DependencyEdge, type DependencyValidationResult, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExcerptOptions, type ExcerptResult, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type ExtractedStreamChunk, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, type GenerateExpositionOptions, GeneratedSlideArraySchema, GeneratedSlideSchema, HANDOUT_TEMPLATE, ICurriculumStorage, LAYER_IDLE_BUDGET_MS, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, type LayoutBoxConfig, LessonPlan, MisconceptionEvaluator, ModelResolutionOptions, PROJECT_INSTRUCTION_TEMPLATE, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PreliminaryResearchResult, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QUIZ_TEMPLATE, QualityAuditReport, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, ResolvedGateSettings, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STATION_ROTATION_TEMPLATE, type SlashCommandDefinition, SlideBlueprintArraySchema, SlideBlueprintItemSchema, SlideDeck, type SlideLayoutCategory, type SlideLayoutData, type SlideLayoutPreset, type SlideProductionWorkflowOptions, type SlideProductionWorkflowResult, SmartResumeContext, type StreamAbortHandle, type StreamBudget, type StreamChunkExtractor, StreamRunnerOptions, type SymbolLedgerResult, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TranslationPolicy, type TranslationTarget, type TranslationTrigger, type ValidationOptions, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildDomainLexiconGuardrail, buildExpositionContext, buildExpositionExcerpt, buildHeadingDirective, buildLanguageDirective, buildLessonExcerpt, buildSectionAwareExcerpt, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createContextMissingError, createStreamAbortSignal, createStreamChunkExtractor, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, executeSlideProductionWorkflow, expositionCacheKey, extractScopeSequenceRows, extractSectionHeadingsFromSLC, extractSessionSlice, extractStreamChunk, extractSymbolLedger, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, normalizeSlcContract, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, targetLanguageDisplayName, topoSort, validateArtifactDependencies };
+export { ACT_TEMPLATE, AIProviderName, ARTIFACT_DEPENDENCY_ROUTING, ARTIFACT_EXECUTION_ORDER, type AcademicAuditFinding, AcademicAuditor, type AcademicDimension, ActivityLab, type ArtifactDependencyRule, type ArtifactProductionSpec, type AuditBundleInput, BELL_RINGER_TEMPLATE, BLOOM_ACTION_VERBS, BOM_TEMPLATE, BloomTaxonomyEvaluator, type BuildContextOptions, CHOICE_BOARD_TEMPLATE, CODE_LAB_TEMPLATE, CURRICULUM_SLASH_COMMANDS, CodeHardwareFeasibilityEvaluator, CodeLab, type ComprehensiveAcademicReport, ConstructiveAlignmentEvaluator, type ContextInjectionMeta, type ContextSourceKey, CoverageGateReport, CrossArtifactDriftEvaluator, CurriculumError, type CurriculumErrorCode, type CurriculumErrorDetail, CurriculumPlan, DEFAULT_KX_PRIORITIES, DEFAULT_LESSON_PRIORITIES, DEFAULT_STREAM_IDLE_MS, DEFAULT_STREAM_TOTAL_MS, DEFAULT_VIETNAMESE_SECTION_HEADINGS, DependencyEdge, type DependencyValidationResult, DeterministicPipelineRunner, DeterministicStructuralLinter, DiagnosticQuiz, DiagnosticQuizInput, type DimensionScore, EXIT_TICKET_TEMPLATE, EXPOSITION_REL, EXT_TEMPLATE, type ExcerptOptions, type ExcerptResult, type ExecuteCommandResult, ExpositionApprovalError, type ExpositionLlmFn, type ExpositionResult, type ExpositionStorage, type ExtractedJson, type ExtractedStreamChunk, type FindingSeverity, FiveEInstructionalEvaluator, type FrameworkLintFinding, type FrameworkLintReport, FrameworkPack, GLOSSARY_TEMPLATE, GRAPHIC_ORGANIZER_TEMPLATE, type GenerateExpositionOptions, GeneratedSlideArraySchema, GeneratedSlideSchema, HANDOUT_TEMPLATE, HybridBlueprintArraySchema, HybridBlueprintItemSchema, HybridDeckSlideArraySchema, HybridDeckSlideSchema, HybridPipelineError, ICurriculumStorage, LAYER_IDLE_BUDGET_MS, LAYER_TOTAL_BUDGET_MS, LESSON_PLAN_TEMPLATE, type LayerChunkCallback, type LayerPrefillOptions, type LayerPrefillResult, type LayoutBoxConfig, LessonPlan, MisconceptionEvaluator, ModelResolutionOptions, PROJECT_INSTRUCTION_TEMPLATE, type PackingSpec, type PedagogicalModel, type PipelineExecutionProgress, PlanConstraints, type PlanOptions, type PlanResult, type PlannerLlmFn, PlanningGraph, PlanningNode, type PreliminaryResearchResult, type ProduceLessonOptions, type ProduceLessonResult, type ProjectBriefingData, type ProjectClarification, type ProjectCreationPayload, type ProjectIntentAnalysisResult, ProjectStatusReport, type ProjectionMeta, QUIZ_TEMPLATE, QualityAuditReport, REVIEW_GAME_TEMPLATE, RUBRIC_TEMPLATE, ResolvedGateSettings, SATELLITE_LESSON_PRIORITIES, SCIENCE_LAB_TEMPLATE, SELF_LAB_TEMPLATE, SLIDE_LAYOUT_PRESETS, SLIDE_TEMPLATE, STATION_ROTATION_TEMPLATE, type SlashCommandDefinition, SlideBlueprintArraySchema, SlideBlueprintItemSchema, SlideDeck, type SlideEngine, type SlideLayoutCategory, type SlideLayoutData, type SlideLayoutPreset, type SlideProductionWorkflowOptions, type SlideProductionWorkflowResult, SmartResumeContext, type StreamAbortHandle, type StreamBudget, type StreamChunkExtractor, StreamRunnerOptions, type SymbolLedgerResult, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TranslationPolicy, type TranslationTarget, type TranslationTrigger, type ValidationOptions, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildDomainLexiconGuardrail, buildExpositionContext, buildExpositionExcerpt, buildHeadingDirective, buildLanguageDirective, buildLessonExcerpt, buildSectionAwareExcerpt, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createContextMissingError, createStreamAbortSignal, createStreamChunkExtractor, detectProjectPedagogy, emitUsage, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, executeSlideProductionWorkflow, expositionCacheKey, extractJsonArray, extractScopeSequenceRows, extractSectionHeadingsFromSLC, extractSessionSlice, extractStreamChunk, extractSymbolLedger, generatePhase1SotArtifacts, generatePhase2SotArtifacts, getLessonMetadata, getProjectArtifactScope, getProjectStatusReport, getSlideLayoutPresetById, getSlideLayoutPresetsByCategory, getSmartResumeContext, glossaryTermsForSession, ingestProjectGraphIntoProject, initializeProjectInStorage, isExpositionFresh, isTranslationDue, lintCurriculumFramework, loadCurriculumTemplate, loadSotTemplate, normalizePlanningGraph, normalizeSlcContract, parseRoadmapJsonToProjectPayload, produceBatchLessons, produceSingleLesson, renderFrameworkFromPlan, resolveStreamBudget, resolveTargetLanguageCode, resolveTranslationTargets, safeParseJson, slugifyProjectName, streamLLMWithFallback, streamLayerPrefillWithFallback, stripLlmJsonWrappers, targetLanguageDisplayName, topoSort, validateArtifactDependencies, validateHybridDeckSlides };