@thanh01.pmt/curriculum-kit 1.4.17 → 1.4.20

package/dist/index.d.cts

@@ -12,8 +12,8 @@ export { b as ArtifactLifecycleInfo, A as ArtifactLifecycleState, L as LessonArt
 export { FileSystemCurriculumAdapter, FileSystemStorageOptions, STANDARD_SOT_FILES, StorageFactoryOptions, SupabaseCurriculumAdapter, SupabaseStorageConfig, 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,66 @@ 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[];
+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;
@@ -571,6 +631,7 @@ declare class ExpositionApprovalError extends Error {
 }
 /** Determine whether an existing EXPOSITION can be reused for this lesson. */
 declare function isExpositionFresh(existing: string | null, plan: CurriculumPlan, lessonCode: string): boolean;
+declare function buildDomainLexiconGuardrail(techStack?: string, hardwarePlatform?: string): string;
 interface GenerateExpositionOptions {
     projectId: string;
     lessonCode: string;
@@ -585,6 +646,8 @@ interface GenerateExpositionOptions {
     gates?: ResolvedGateSettings;
     targetLanguage?: string;
     slcMarkdown?: Record<string, Record<string, string>> | string | null;
+    techStack?: string;
+    hardwarePlatform?: string;
 }
 interface ExpositionResult {
     relPath: string;
@@ -615,6 +678,8 @@ declare function ensureExpositionForLesson(storage: ICurriculumStorage, projectI
     targetLanguage?: string;
     slcMarkdown?: Record<string, Record<string, string>> | string | null;
     customInference?: StreamRunnerOptions['customInference'];
+    techStack?: string;
+    hardwarePlatform?: string;
 }): Promise<{
     relPath: string;
     context: string;
@@ -664,54 +729,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;
-
 /**
  * Curriculum OS - Standardized Error Taxonomy & Traceability System
  *
@@ -800,110 +817,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.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">;
+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.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">;
+type SlideEngine = 'hybrid' | 'chunked';
 interface SlideProductionWorkflowOptions {
     lessonMarkdown: string;
     lessonCode: string;
@@ -916,8 +1040,12 @@ interface SlideProductionWorkflowOptions {
     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;
@@ -929,7 +1057,20 @@ 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[];
 declare function executeSlideProductionWorkflow(options: SlideProductionWorkflowOptions): Promise<SlideProductionWorkflowResult>;
 
 /**
@@ -1230,4 +1371,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, TASK_CARDS_TEMPLATE, TEACHER_GUIDE_TEMPLATE, TIERED_PRACTICE_TEMPLATE, TranslationPolicy, type TranslationTarget, type TranslationTrigger, type ValidationOptions, WORKSHEET_TEMPLATE, analyzeProjectCreationIntent, assertAcyclic, auditQualityReport, buildCurriculumContext, buildCurriculumPlan, buildExpositionContext, buildExpositionExcerpt, buildHeadingDirective, buildLanguageDirective, buildLessonExcerpt, buildSectionAwareExcerpt, buildSessionSliceContext, closeTruncatedJson, computePackingSpec, conductPreliminaryResearch, createAiInferenceError, createContextMissingError, createStreamAbortSignal, createStreamChunkExtractor, detectProjectPedagogy, ensureExpositionForLesson, ensureKnowledgeExposition, executeCurriculumCommand, executeSlideProductionWorkflow, expositionCacheKey, extractScopeSequenceRows, extractSectionHeadingsFromSLC, extractSessionSlice, extractStreamChunk, 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, 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, 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 };