@thanh01.pmt/curriculum-kit 1.0.0

package/dist/ai/index.d.ts

@@ -0,0 +1,1287 @@
+import { M as ModelResolutionOptions } from '../provider-factory-DH3udYlN.js';
+export { A as AIProviderName, N as NVIDIA_MODELS, g as getAIModel } from '../provider-factory-DH3udYlN.js';
+import { MilestoneInput, LessonPlan, ActivityLab, ProjectGraph, CodeLab, Worksheet, Handout, SlideDeck, TeacherGuide, Extension, CurriculumQualityReport, ProjectInstruction, SelfLab, DiagnosticQuiz } from '../schemas/index.js';
+import * as ai from 'ai';
+import { C as ChatMessage, S as StreamRunnerOptions, c as ChunkType } from '../streamRunner-C7j5LKon.js';
+export { F as FallbackTarget, e as extractThoughtAndContent, g as getDesignatedFallbackChain, b as getDesignatedFallbackConfig, a as isModelAllowed, i as isProviderEnabled, r as runCurriculumAIInference, s as streamCurriculumAIInference } from '../streamRunner-C7j5LKon.js';
+import { z } from 'zod';
+
+interface LessonPromptInput {
+    milestone: MilestoneInput;
+    language: string;
+    topic?: string;
+    targetAudience?: string;
+    contextContinuity?: string;
+    /** Pre-rendered STANDARDS CONTEXT block (from buildStandardsContextBlock) — verbatim standard statements binding this lesson. */
+    standardsContext?: string;
+}
+declare function buildLessonMasterPrompt(input: LessonPromptInput): string;
+
+interface ActivityPromptInput {
+    lesson: LessonPlan;
+    language: string;
+    hardwareBOM?: string[];
+    softwareTools?: string[];
+}
+declare function buildActivityPrompt(input: ActivityPromptInput): string;
+
+interface CodeLabPromptInput {
+    lesson: LessonPlan;
+    activity?: ActivityLab;
+    language: string;
+    targetTechStack?: string[];
+}
+declare function buildCodeLabPrompt(input: CodeLabPromptInput): string;
+
+interface WorksheetPromptInput {
+    lesson: LessonPlan;
+    language: string;
+}
+declare function buildWorksheetPrompt(input: WorksheetPromptInput): string;
+
+interface HandoutPromptInput {
+    lesson: LessonPlan;
+    language: string;
+}
+declare function buildHandoutPrompt(input: HandoutPromptInput): string;
+
+interface SlidesPromptInput {
+    lesson: LessonPlan;
+    language: string;
+    marpTheme?: string;
+}
+declare function buildSlidesPrompt(input: SlidesPromptInput): string;
+
+interface TeacherGuidePromptInput {
+    lesson: LessonPlan;
+    activity?: ActivityLab;
+    language: string;
+}
+declare function buildTeacherGuidePrompt(input: TeacherGuidePromptInput): string;
+
+interface ExtensionPromptInput {
+    lesson: LessonPlan;
+    activity?: ActivityLab;
+    language: string;
+}
+declare function buildExtensionPrompt(input: ExtensionPromptInput): string;
+
+interface JudgePromptInput {
+    targetArtifactType: string;
+    lessonId: string;
+    expectedLanguage: string;
+    targetObjectives: Array<{
+        code: string;
+        description: string;
+        bloomLevel: string;
+    }>;
+    generatedContentJson: string;
+    /**
+     * VERBATIM standard statements relevant to this artifact, keyed by canonical ID
+     * ("packId:statementId" -> verbatim text). Sourced from the Standards Registry.
+     * The judge compares the candidate against the REAL standard text, never memory.
+     * Optional for backward compatibility.
+     */
+    standardStatements?: Record<string, string>;
+}
+declare function buildJudgePrompt(input: JudgePromptInput): string;
+
+interface ProjectInstructionPromptInput {
+    projectGraph?: ProjectGraph;
+    milestone: MilestoneInput;
+    roadmapContext?: {
+        projectTitle?: string;
+        techStack?: string[];
+        phaseTitle?: string;
+    };
+    researchNotes?: string;
+    externalResources?: string[];
+    language: string;
+    difficulty?: 'beginner' | 'intermediate' | 'advanced';
+}
+declare function buildProjectInstructionPrompt(input: ProjectInstructionPromptInput): string;
+
+interface SelfLabPromptInput {
+    milestone: MilestoneInput;
+    projectGraph?: ProjectGraph;
+    language: string;
+    targetTechStack?: string[];
+    contextContinuity?: string;
+}
+declare function buildSelfLabPrompt(input: SelfLabPromptInput): string;
+
+interface DiagnosticQuizPromptInput {
+    milestone: MilestoneInput;
+    language: string;
+    questionCount?: number;
+    passingScorePct?: number;
+}
+declare function buildDiagnosticQuizPrompt(input: DiagnosticQuizPromptInput): string;
+
+interface GenerateLessonMasterInput extends Omit<LessonPromptInput, 'milestone'> {
+    milestone: MilestoneInput;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateLessonMasterFlow(input: GenerateLessonMasterInput): Promise<LessonPlan>;
+
+interface GenerateActivityInput extends Omit<ActivityPromptInput, 'lesson'> {
+    lesson: LessonPlan;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateActivityFlow(input: GenerateActivityInput): Promise<ActivityLab>;
+
+interface GenerateCodeLabInput extends Omit<CodeLabPromptInput, 'lesson'> {
+    lesson: LessonPlan;
+    activity?: ActivityLab;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateCodeLabFlow(input: GenerateCodeLabInput): Promise<CodeLab>;
+
+interface GenerateWorksheetInput extends Omit<WorksheetPromptInput, 'lesson'> {
+    lesson: LessonPlan;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateWorksheetFlow(input: GenerateWorksheetInput): Promise<Worksheet>;
+
+interface GenerateHandoutInput extends Omit<HandoutPromptInput, 'lesson'> {
+    lesson: LessonPlan;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateHandoutFlow(input: GenerateHandoutInput): Promise<Handout>;
+
+interface GenerateSlidesInput extends Omit<SlidesPromptInput, 'lesson'> {
+    lesson: LessonPlan;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateSlidesFlow(input: GenerateSlidesInput): Promise<SlideDeck>;
+
+interface GenerateTeacherGuideInput extends Omit<TeacherGuidePromptInput, 'lesson'> {
+    lesson: LessonPlan;
+    activity?: ActivityLab;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateTeacherGuideFlow(input: GenerateTeacherGuideInput): Promise<TeacherGuide>;
+
+interface GenerateExtensionInput extends Omit<ExtensionPromptInput, 'lesson'> {
+    lesson: LessonPlan;
+    activity?: ActivityLab;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateExtensionFlow(input: GenerateExtensionInput): Promise<Extension>;
+
+interface AuditCurriculumQualityInput extends JudgePromptInput {
+    modelOptions?: ModelResolutionOptions;
+}
+declare function auditCurriculumQualityFlow(input: AuditCurriculumQualityInput): Promise<CurriculumQualityReport>;
+
+interface GenerateProjectInstructionInput extends ProjectInstructionPromptInput {
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateProjectInstructionFlow(input: GenerateProjectInstructionInput): Promise<ProjectInstruction>;
+
+interface GenerateSelfLabInput {
+    milestone: MilestoneInput;
+    projectGraph?: ProjectGraph;
+    language: string;
+    targetTechStack?: string[];
+    contextContinuity?: string;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateSelfLabFlow(input: GenerateSelfLabInput): Promise<SelfLab>;
+
+interface GenerateDiagnosticQuizInput {
+    milestone: MilestoneInput;
+    language: string;
+    questionCount?: number;
+    passingScorePct?: number;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function generateDiagnosticQuizFlow(input: GenerateDiagnosticQuizInput): Promise<DiagnosticQuiz>;
+
+interface StreamLessonMasterInput extends Omit<LessonPromptInput, 'milestone'> {
+    milestone: MilestoneInput;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function streamLessonMasterFlow(input: StreamLessonMasterInput): Promise<ai.StreamObjectResult<{
+    artifactType?: "LESSON" | undefined;
+    lessonId?: string | undefined;
+    title?: string | undefined;
+    language?: string | undefined;
+    learningObjectives?: ({
+        code?: string | undefined;
+        successCriteria?: string | undefined;
+        description?: string | undefined;
+        name?: string | undefined;
+        bloomLevel?: string | undefined;
+    } | undefined)[] | undefined;
+    teacherNotes?: {
+        commonPitfalls?: (string | undefined)[] | undefined;
+        troubleshootingMatrix?: ({
+            issue?: string | undefined;
+            potentialCause?: string | undefined;
+            solution?: string | undefined;
+        } | undefined)[] | undefined;
+        extensionNotes?: string | undefined;
+    } | undefined;
+    hookScenario?: string | undefined;
+    keywords?: (string | undefined)[] | undefined;
+    topic?: string | undefined;
+    targetGradeOrAudience?: string | undefined;
+    overview?: string | undefined;
+    prerequisites?: string | undefined;
+    materialsSummary?: string | undefined;
+    hookTitle?: string | undefined;
+    hookQuestions?: (string | undefined)[] | undefined;
+    coreConcepts?: ({
+        name?: string | undefined;
+        analogy?: string | undefined;
+        technicalDepth?: string | undefined;
+        formulaOrRule?: string | undefined;
+        comparisonTable?: {
+            headers?: (string | undefined)[] | undefined;
+            rows?: ((string | undefined)[] | undefined)[] | undefined;
+        } | undefined;
+    } | undefined)[] | undefined;
+    differentiation?: {
+        bronzeTier?: string | undefined;
+        silverTier?: string | undefined;
+        goldTier?: string | undefined;
+    } | undefined;
+    sections?: ({
+        durationMinutes?: number | undefined;
+        title?: string | undefined;
+        teacherActions?: string | undefined;
+        studentActions?: string | undefined;
+        analogies?: (string | undefined)[] | undefined;
+        formativeCheck?: string | undefined;
+    } | undefined)[] | undefined;
+    exitTicket?: {
+        questionStem?: string | undefined;
+        expectedAnswerOrRubric?: string | undefined;
+        metacognitivePrompt?: string | undefined;
+    } | undefined;
+    guidedPractice?: {
+        title?: string | undefined;
+        explanation?: string | undefined;
+        codeSnippet?: string | undefined;
+        codeLanguage?: string | undefined;
+        mermaidDiagram?: string | undefined;
+    } | undefined;
+    independentPractice?: {
+        description?: string | undefined;
+        title?: string | undefined;
+    } | undefined;
+}, {
+    artifactType: "LESSON";
+    lessonId: string;
+    title: string;
+    language: string;
+    learningObjectives: {
+        code: string;
+        successCriteria: string;
+        description: string;
+        name: string;
+        bloomLevel: string;
+    }[];
+    teacherNotes: {
+        commonPitfalls: string[];
+        troubleshootingMatrix: {
+            issue: string;
+            potentialCause: string;
+            solution: string;
+        }[];
+        extensionNotes: string;
+    };
+    hookScenario: string;
+    keywords: string[];
+    topic: string;
+    targetGradeOrAudience: string;
+    overview: string;
+    prerequisites: string;
+    materialsSummary: string;
+    hookTitle: string;
+    hookQuestions: string[];
+    coreConcepts: {
+        name: string;
+        analogy: string;
+        technicalDepth: string;
+        formulaOrRule: string;
+        comparisonTable?: {
+            headers: string[];
+            rows: string[][];
+        } | undefined;
+    }[];
+    differentiation: {
+        bronzeTier: string;
+        silverTier: string;
+        goldTier: string;
+    };
+    sections: {
+        durationMinutes: number;
+        title: string;
+        teacherActions: string;
+        studentActions: string;
+        analogies: string[];
+        formativeCheck: string;
+    }[];
+    exitTicket: {
+        questionStem: string;
+        expectedAnswerOrRubric: string;
+        metacognitivePrompt: string;
+    };
+    guidedPractice?: {
+        title: string;
+        explanation: string;
+        codeSnippet: string;
+        codeLanguage: string;
+        mermaidDiagram: string;
+    } | undefined;
+    independentPractice?: {
+        description: string;
+        title: string;
+    } | undefined;
+}, never>>;
+
+interface StreamSelfLabInput {
+    milestone: MilestoneInput;
+    language: string;
+    targetTechStack?: string[];
+    contextContinuity?: string;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function streamSelfLabFlow(input: StreamSelfLabInput): Promise<ai.StreamObjectResult<{
+    artifactType?: "SELF_LAB" | undefined;
+    title?: string | undefined;
+    language?: string | undefined;
+    troubleshootingMatrix?: ({
+        symptom?: string | undefined;
+        rootCause?: string | undefined;
+        exactFix?: string | undefined;
+    } | undefined)[] | undefined;
+    techStack?: (string | undefined)[] | undefined;
+    challenges?: {
+        bronze?: {
+            objective?: string | undefined;
+            title?: string | undefined;
+            expectedOutput?: string | undefined;
+            estimatedMinutes?: number | undefined;
+            tier?: "bronze" | "silver" | "gold" | undefined;
+            tasks?: (string | undefined)[] | undefined;
+            verifyCommand?: string | undefined;
+            hints?: {
+                hint1Concept?: string | undefined;
+                hint2Skeleton?: string | undefined;
+                hint3Solution?: {
+                    code?: string | undefined;
+                    explanation?: string | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        silver?: {
+            objective?: string | undefined;
+            title?: string | undefined;
+            expectedOutput?: string | undefined;
+            estimatedMinutes?: number | undefined;
+            tier?: "bronze" | "silver" | "gold" | undefined;
+            tasks?: (string | undefined)[] | undefined;
+            verifyCommand?: string | undefined;
+            hints?: {
+                hint1Concept?: string | undefined;
+                hint2Skeleton?: string | undefined;
+                hint3Solution?: {
+                    code?: string | undefined;
+                    explanation?: string | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+        gold?: {
+            objective?: string | undefined;
+            title?: string | undefined;
+            expectedOutput?: string | undefined;
+            estimatedMinutes?: number | undefined;
+            tier?: "bronze" | "silver" | "gold" | undefined;
+            tasks?: (string | undefined)[] | undefined;
+            verifyCommand?: string | undefined;
+            hints?: {
+                hint1Concept?: string | undefined;
+                hint2Skeleton?: string | undefined;
+                hint3Solution?: {
+                    code?: string | undefined;
+                    explanation?: string | undefined;
+                } | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+    difficulty?: "advanced" | "intermediate" | "beginner" | undefined;
+    estimatedTotalMinutes?: number | undefined;
+    labId?: string | undefined;
+    missionBriefing?: string | undefined;
+    preflightChecklist?: (string | undefined)[] | undefined;
+    finalSubmissionChecklist?: (string | undefined)[] | undefined;
+}, {
+    artifactType: "SELF_LAB";
+    title: string;
+    language: string;
+    troubleshootingMatrix: {
+        symptom: string;
+        rootCause: string;
+        exactFix: string;
+    }[];
+    techStack: string[];
+    challenges: {
+        bronze: {
+            objective: string;
+            title: string;
+            expectedOutput: string;
+            estimatedMinutes: number;
+            tier: "bronze" | "silver" | "gold";
+            tasks: string[];
+            verifyCommand: string;
+            hints: {
+                hint1Concept: string;
+                hint2Skeleton: string;
+                hint3Solution: {
+                    code: string;
+                    explanation: string;
+                };
+            };
+        };
+        silver: {
+            objective: string;
+            title: string;
+            expectedOutput: string;
+            estimatedMinutes: number;
+            tier: "bronze" | "silver" | "gold";
+            tasks: string[];
+            verifyCommand: string;
+            hints: {
+                hint1Concept: string;
+                hint2Skeleton: string;
+                hint3Solution: {
+                    code: string;
+                    explanation: string;
+                };
+            };
+        };
+        gold: {
+            objective: string;
+            title: string;
+            expectedOutput: string;
+            estimatedMinutes: number;
+            tier: "bronze" | "silver" | "gold";
+            tasks: string[];
+            verifyCommand: string;
+            hints: {
+                hint1Concept: string;
+                hint2Skeleton: string;
+                hint3Solution: {
+                    code: string;
+                    explanation: string;
+                };
+            };
+        };
+    };
+    difficulty: "advanced" | "intermediate" | "beginner";
+    estimatedTotalMinutes: number;
+    labId: string;
+    missionBriefing: string;
+    preflightChecklist: string[];
+    finalSubmissionChecklist: string[];
+}, never>>;
+
+interface StreamDiagnosticQuizInput {
+    milestone: MilestoneInput;
+    language: string;
+    questionCount?: number;
+    passingScorePct?: number;
+    modelOptions?: ModelResolutionOptions;
+}
+declare function streamDiagnosticQuizFlow(input: StreamDiagnosticQuizInput): Promise<ai.StreamObjectResult<{
+    artifactType?: "QUIZ" | undefined;
+    title?: string | undefined;
+    language?: string | undefined;
+    quizId?: string | undefined;
+    totalQuestions?: number | undefined;
+    timeAllocationMinutes?: number | undefined;
+    passingScorePct?: number | undefined;
+    assessmentObjectives?: ({
+        objective?: string | undefined;
+        standardRefs?: (string | undefined)[] | undefined;
+        bloomLevel?: "Create" | "Evaluate" | "Remember" | "Understand" | "Apply" | "Analyze" | undefined;
+        aoCode?: string | undefined;
+        alignedLO?: string | undefined;
+    } | undefined)[] | undefined;
+    questions?: ({
+        options?: ({
+            explanation?: string | undefined;
+            id?: string | undefined;
+            text?: string | undefined;
+            isCorrect?: boolean | undefined;
+        } | undefined)[] | undefined;
+        bloomLevel?: "create" | "Create" | "Evaluate" | "understand" | "Remember" | "Understand" | "Apply" | "Analyze" | "remember" | "apply" | "analyze" | "evaluate" | undefined;
+        codeLanguage?: string | undefined;
+        id?: string | undefined;
+        questionType?: "multiple_choice" | "matching" | "code_analysis" | "open_ended" | undefined;
+        codeSnippet?: string | undefined;
+        alignedAO?: string | undefined;
+        scenarioOrStem?: string | undefined;
+        scenario?: string | undefined;
+        stem?: string | undefined;
+        correctAnswer?: string | undefined;
+        teacherNote?: string | undefined;
+        takeawayMessage?: string | undefined;
+    } | undefined)[] | undefined;
+    rubric?: ({
+        proficient?: string | undefined;
+        advanced?: string | undefined;
+        competencyDimension?: string | undefined;
+        developing?: string | undefined;
+        exemplary?: string | undefined;
+    } | undefined)[] | undefined;
+}, {
+    artifactType: "QUIZ";
+    title: string;
+    language: string;
+    quizId: string;
+    totalQuestions: number;
+    timeAllocationMinutes: number;
+    passingScorePct: number;
+    assessmentObjectives: {
+        objective: string;
+        standardRefs: string[];
+        bloomLevel: "Create" | "Evaluate" | "Remember" | "Understand" | "Apply" | "Analyze";
+        aoCode: string;
+        alignedLO: string;
+    }[];
+    questions: {
+        options: {
+            explanation: string;
+            id: string;
+            text: string;
+            isCorrect: boolean;
+        }[];
+        bloomLevel: "create" | "Create" | "Evaluate" | "understand" | "Remember" | "Understand" | "Apply" | "Analyze" | "remember" | "apply" | "analyze" | "evaluate";
+        codeLanguage: string;
+        id: string;
+        questionType: "multiple_choice" | "matching" | "code_analysis" | "open_ended";
+        codeSnippet?: string | undefined;
+        alignedAO?: string | undefined;
+        scenarioOrStem?: string | undefined;
+        scenario?: string | undefined;
+        stem?: string | undefined;
+        correctAnswer?: string | undefined;
+        teacherNote?: string | undefined;
+        takeawayMessage?: string | undefined;
+    }[];
+    rubric: {
+        proficient: string;
+        advanced: string;
+        competencyDimension: string;
+        developing: string;
+        exemplary: string;
+    }[];
+}, never>>;
+
+/**
+ * Specialist Sub-Agent Toolbelts (Parity with LangGraph AGENTS.md & nodes)
+ *
+ * Provides typed Zod tool schemas and execution contracts for 10 specialist personas:
+ * 1. @analyst — Brief analysis, learner profile, age group constraints
+ * 2. @researcher — Ground Truth, reference pack, evidence scoring
+ * 3. @designer — 3-level Curriculum Framework, Bloom matrix, prerequisite graph
+ * 4. @content — 5E Lesson Plan, Lesson contract, Section patching
+ * 5. @activity — STEM Activity Operations, ACT contract validation
+ * 6. @assessor — Diagnostic quizzes, question bank, rubric matrix
+ * 7. @illustrator — Mermaid diagrams, technical illustrations, visual assets
+ * 8. @tech_sme — Code Lab sandbox execution, syntax validation, runtime checking
+ * 9. @reviewer — Alignment matrix audit, reading level check, scope drift detection
+ * 10. @packager — 4 Delivery packs (Teacher, Student, Parent, Client), Handover Doc
+ */
+
+declare const analystTools: {
+    analyzeLearnerProfile: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            targetAge: z.ZodString;
+            priorKnowledge: z.ZodString;
+            cognitiveBarriers: z.ZodArray<z.ZodString, "many">;
+            transitionStrategy: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            targetAge: string;
+            priorKnowledge: string;
+            cognitiveBarriers: string[];
+            transitionStrategy: string;
+        }, {
+            targetAge: string;
+            priorKnowledge: string;
+            cognitiveBarriers: string[];
+            transitionStrategy: string;
+        }>;
+    };
+    validatePrerequisites: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            requiredConcepts: z.ZodArray<z.ZodString, "many">;
+            entryBenchmark: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            requiredConcepts: string[];
+            entryBenchmark: string;
+        }, {
+            requiredConcepts: string[];
+            entryBenchmark: string;
+        }>;
+    };
+    writeLearnerProfile: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            projectSlug: z.ZodString;
+            markdownContent: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            projectSlug: string;
+            markdownContent: string;
+        }, {
+            projectSlug: string;
+            markdownContent: string;
+        }>;
+    };
+};
+declare const researcherTools: {
+    searchAcademicStandards: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            query: z.ZodString;
+            standardCategory: z.ZodDefault<z.ZodEnum<["CSTA", "CS2023", "OFFICIAL_DOCS", "ALL"]>>;
+        }, "strip", z.ZodTypeAny, {
+            query: string;
+            standardCategory: "CSTA" | "CS2023" | "OFFICIAL_DOCS" | "ALL";
+        }, {
+            query: string;
+            standardCategory?: "CSTA" | "CS2023" | "OFFICIAL_DOCS" | "ALL" | undefined;
+        }>;
+    };
+    scoreEvidence: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            sourceUrl: z.ZodString;
+            sourceType: z.ZodEnum<["academic_paper", "official_doc", "curriculum_standard", "community_article"]>;
+            reliabilityScore: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            sourceUrl: string;
+            sourceType: "academic_paper" | "official_doc" | "curriculum_standard" | "community_article";
+            reliabilityScore: number;
+        }, {
+            sourceUrl: string;
+            sourceType: "academic_paper" | "official_doc" | "curriculum_standard" | "community_article";
+            reliabilityScore: number;
+        }>;
+    };
+    writeReferencePack: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            projectSlug: z.ZodString;
+            references: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                sourceUrl: z.ZodString;
+                relevanceScore: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                id: string;
+                sourceUrl: string;
+                relevanceScore: number;
+            }, {
+                title: string;
+                id: string;
+                sourceUrl: string;
+                relevanceScore: number;
+            }>, "many">;
+            cs2023Area: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            references: {
+                title: string;
+                id: string;
+                sourceUrl: string;
+                relevanceScore: number;
+            }[];
+            projectSlug: string;
+            cs2023Area?: string | undefined;
+        }, {
+            references: {
+                title: string;
+                id: string;
+                sourceUrl: string;
+                relevanceScore: number;
+            }[];
+            projectSlug: string;
+            cs2023Area?: string | undefined;
+        }>;
+    };
+};
+declare const designerTools: {
+    buildScopeAndSequence: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            totalWeeks: z.ZodDefault<z.ZodNumber>;
+            totalSessions: z.ZodDefault<z.ZodNumber>;
+            units: z.ZodArray<z.ZodObject<{
+                unitId: z.ZodString;
+                title: z.ZodString;
+                projectDeliverable: z.ZodString;
+                sessionCount: z.ZodNumber;
+                bloomTarget: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                title: string;
+                bloomTarget: string;
+                unitId: string;
+                projectDeliverable: string;
+                sessionCount: number;
+            }, {
+                title: string;
+                bloomTarget: string;
+                unitId: string;
+                projectDeliverable: string;
+                sessionCount: number;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            units: {
+                title: string;
+                bloomTarget: string;
+                unitId: string;
+                projectDeliverable: string;
+                sessionCount: number;
+            }[];
+            totalWeeks: number;
+            totalSessions: number;
+        }, {
+            units: {
+                title: string;
+                bloomTarget: string;
+                unitId: string;
+                projectDeliverable: string;
+                sessionCount: number;
+            }[];
+            totalWeeks?: number | undefined;
+            totalSessions?: number | undefined;
+        }>;
+    };
+    writeCurriculumFramework: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            projectSlug: z.ZodString;
+            frameworkMarkdown: z.ZodString;
+            standardRefs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                unitId: z.ZodString;
+                standardIds: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                unitId: string;
+                standardIds: string[];
+            }, {
+                unitId: string;
+                standardIds: string[];
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            projectSlug: string;
+            frameworkMarkdown: string;
+            standardRefs?: {
+                unitId: string;
+                standardIds: string[];
+            }[] | undefined;
+        }, {
+            projectSlug: string;
+            frameworkMarkdown: string;
+            standardRefs?: {
+                unitId: string;
+                standardIds: string[];
+            }[] | undefined;
+        }>;
+    };
+};
+declare const contentTools: {
+    scaffold5ELesson: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            lessonId: z.ZodString;
+            title: z.ZodString;
+            learningObjectives: z.ZodArray<z.ZodObject<{
+                code: z.ZodString;
+                statement: z.ZodString;
+                standardRefs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                code: string;
+                statement: string;
+                standardRefs?: string[] | undefined;
+            }, {
+                code: string;
+                statement: string;
+                standardRefs?: string[] | undefined;
+            }>, "many">;
+            durationMinutes: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            durationMinutes: number;
+            lessonId: string;
+            title: string;
+            learningObjectives: {
+                code: string;
+                statement: string;
+                standardRefs?: string[] | undefined;
+            }[];
+        }, {
+            lessonId: string;
+            title: string;
+            learningObjectives: {
+                code: string;
+                statement: string;
+                standardRefs?: string[] | undefined;
+            }[];
+            durationMinutes?: number | undefined;
+        }>;
+    };
+    writeLessonBody: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            lessonId: z.ZodString;
+            fullMarkdown: z.ZodString;
+            activitySequence: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            lessonId: string;
+            activitySequence: string[];
+            fullMarkdown: string;
+        }, {
+            lessonId: string;
+            activitySequence: string[];
+            fullMarkdown: string;
+        }>;
+    };
+    patchLessonSection: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            filePath: z.ZodString;
+            targetSectionHeader: z.ZodString;
+            replacementMarkdown: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            filePath: string;
+            targetSectionHeader: string;
+            replacementMarkdown: string;
+        }, {
+            filePath: string;
+            targetSectionHeader: string;
+            replacementMarkdown: string;
+        }>;
+    };
+};
+declare const activityTools: {
+    writeActLabOperations: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            lessonId: z.ZodString;
+            targetPlatform: z.ZodDefault<z.ZodString>;
+            stepByStepSteps: z.ZodArray<z.ZodObject<{
+                stepNumber: z.ZodNumber;
+                instruction: z.ZodString;
+                starterCodeSnippet: z.ZodOptional<z.ZodString>;
+                solutionCodeSnippet: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                stepNumber: number;
+                instruction: string;
+                starterCodeSnippet?: string | undefined;
+                solutionCodeSnippet?: string | undefined;
+            }, {
+                stepNumber: number;
+                instruction: string;
+                starterCodeSnippet?: string | undefined;
+                solutionCodeSnippet?: string | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            lessonId: string;
+            targetPlatform: string;
+            stepByStepSteps: {
+                stepNumber: number;
+                instruction: string;
+                starterCodeSnippet?: string | undefined;
+                solutionCodeSnippet?: string | undefined;
+            }[];
+        }, {
+            lessonId: string;
+            stepByStepSteps: {
+                stepNumber: number;
+                instruction: string;
+                starterCodeSnippet?: string | undefined;
+                solutionCodeSnippet?: string | undefined;
+            }[];
+            targetPlatform?: string | undefined;
+        }>;
+    };
+};
+declare const assessorTools: {
+    writeQuizBank: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            lessonId: z.ZodString;
+            questions: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                prompt: z.ZodString;
+                options: z.ZodArray<z.ZodString, "many">;
+                correctIndex: z.ZodNumber;
+                explanation: z.ZodString;
+                bloomLevel: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                options: string[];
+                bloomLevel: string;
+                explanation: string;
+                prompt: string;
+                id: string;
+                correctIndex: number;
+            }, {
+                options: string[];
+                bloomLevel: string;
+                explanation: string;
+                prompt: string;
+                id: string;
+                correctIndex: number;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            lessonId: string;
+            questions: {
+                options: string[];
+                bloomLevel: string;
+                explanation: string;
+                prompt: string;
+                id: string;
+                correctIndex: number;
+            }[];
+        }, {
+            lessonId: string;
+            questions: {
+                options: string[];
+                bloomLevel: string;
+                explanation: string;
+                prompt: string;
+                id: string;
+                correctIndex: number;
+            }[];
+        }>;
+    };
+    generateRubricMatrix: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            lessonId: z.ZodString;
+            criteria: z.ZodArray<z.ZodObject<{
+                criterionName: z.ZodString;
+                weight: z.ZodNumber;
+                levels: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                criterionName: string;
+                weight: number;
+                levels: Record<string, string>;
+            }, {
+                criterionName: string;
+                weight: number;
+                levels: Record<string, string>;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            criteria: {
+                criterionName: string;
+                weight: number;
+                levels: Record<string, string>;
+            }[];
+            lessonId: string;
+        }, {
+            criteria: {
+                criterionName: string;
+                weight: number;
+                levels: Record<string, string>;
+            }[];
+            lessonId: string;
+        }>;
+    };
+};
+declare const illustratorTools: {
+    generateMermaidDiagram: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            diagramType: z.ZodEnum<["flowchart", "sequenceDiagram", "classDiagram", "stateDiagram"]>;
+            mermaidCode: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            mermaidCode: string;
+            diagramType: "flowchart" | "sequenceDiagram" | "classDiagram" | "stateDiagram";
+        }, {
+            mermaidCode: string;
+            diagramType: "flowchart" | "sequenceDiagram" | "classDiagram" | "stateDiagram";
+        }>;
+    };
+    generateSlideDeck: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            lessonId: z.ZodString;
+            marpMarkdown: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            lessonId: string;
+            marpMarkdown: string;
+        }, {
+            lessonId: string;
+            marpMarkdown: string;
+        }>;
+    };
+};
+declare const techSmeTools: {
+    sandboxExecuteCodeLab: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            language: z.ZodEnum<["swift", "python", "javascript", "html_css"]>;
+            code: z.ZodString;
+            expectedOutput: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            language: "swift" | "python" | "javascript" | "html_css";
+            expectedOutput?: string | undefined;
+        }, {
+            code: string;
+            language: "swift" | "python" | "javascript" | "html_css";
+            expectedOutput?: string | undefined;
+        }>;
+    };
+    lintSyntaxErrors: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            language: z.ZodString;
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+            language: string;
+        }, {
+            code: string;
+            language: string;
+        }>;
+    };
+};
+declare const reviewerTools: {
+    auditAlignmentMatrix: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            lessonId: z.ZodString;
+            loCoverageRate: z.ZodNumber;
+            detectedGaps: z.ZodArray<z.ZodString, "many">;
+            verdict: z.ZodEnum<["PASS", "WARN", "FAIL"]>;
+        }, "strip", z.ZodTypeAny, {
+            lessonId: string;
+            loCoverageRate: number;
+            detectedGaps: string[];
+            verdict: "PASS" | "FAIL" | "WARN";
+        }, {
+            lessonId: string;
+            loCoverageRate: number;
+            detectedGaps: string[];
+            verdict: "PASS" | "FAIL" | "WARN";
+        }>;
+    };
+    verifyReadingLevel: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            targetAgeGroup: z.ZodString;
+            textSnippet: z.ZodString;
+            readingGradeLevel: z.ZodString;
+            isAppropriate: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            targetAgeGroup: string;
+            textSnippet: string;
+            readingGradeLevel: string;
+            isAppropriate: boolean;
+        }, {
+            targetAgeGroup: string;
+            textSnippet: string;
+            readingGradeLevel: string;
+            isAppropriate: boolean;
+        }>;
+    };
+};
+declare const packagerTools: {
+    createDeliveryPackage: {
+        name: string;
+        description: string;
+        schema: z.ZodObject<{
+            projectSlug: z.ZodString;
+            packageType: z.ZodEnum<["TEACHER", "STUDENT", "PARENT", "CLIENT", "ALL"]>;
+            outputDirectory: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            projectSlug: string;
+            packageType: "ALL" | "TEACHER" | "STUDENT" | "PARENT" | "CLIENT";
+            outputDirectory: string;
+        }, {
+            projectSlug: string;
+            packageType: "ALL" | "TEACHER" | "STUDENT" | "PARENT" | "CLIENT";
+            outputDirectory?: string | undefined;
+        }>;
+    };
+};
+
+/**
+ * Model Policy Resolver (Economic & Expert Council Architecture - August 2026)
+ *
+ * Core Routing Strategy:
+ * 1. Expert Council / LLM-as-Judge (Tier 1):
+ *    - OpenRouter / Google: google/gemini-3.7-flash (Opus-grade accuracy, 1M context)
+ *    - DeepSeek: deepseek-v4-pro (Build 0813 - Deep CoT Reasoning)
+ *    - Alibaba: qwen3.8-max (2.4T MoE Flagship)
+ *    - NVIDIA NIM: nvidia/nemotron-3-ultra-550b-a55b (Robust Free Fallback)
+ *
+ * 2. Mid & Mid-High Production / Copilot (Tier 2 - Primary Economic):
+ *    - DeepSeek: deepseek-v4-flash (Build 0731 - $0.22/1M, 1M context, 284B MoE)
+ *    - Alibaba: qwen3.7-flash ($0.03/1M, ultra-fast tool caller)
+ *    - OpenRouter / Google: google/gemini-3.7-flash
+ *
+ * 3. Easy / Structured & Free Tasks (Tier 3):
+ *    - NVIDIA NIM: nvidia/nemotron-3.5-lightning-30b-a3b (Free 1.8s MoE)
+ *    - DeepSeek: deepseek-v4-flash
+ *    - Alibaba: qwen3.7-flash ($0.03/1M, ultra-fast tool caller)
+ *    - Google: gemini-3.5-flash-lite
+ */
+type ModelProviderKey = 'deepseek' | 'openrouter' | 'alibaba' | 'google' | 'nvidia' | 'zhipu' | 'ollama' | 'openai' | 'anthropic';
+interface ModelPolicyResolution {
+    provider: ModelProviderKey;
+    modelName: string;
+    maxTokens: number;
+    temperature: number;
+    reasoningEffort?: 'low' | 'medium' | 'high' | 'max';
+    contextWindow?: number;
+    providerLabel?: string;
+    tierDescription?: string;
+}
+interface MultiProviderPolicyResolution {
+    primary: ModelPolicyResolution;
+    fallbacks: ModelPolicyResolution[];
+    candidateChain: ModelPolicyResolution[];
+    expertCouncil?: ModelPolicyResolution[];
+}
+declare const DEFAULT_ENABLED_PROVIDERS: Record<ModelProviderKey, boolean>;
+declare class ModelPolicyResolver {
+    /**
+     * Returns the High-End Expert Council for LLM-as-Judge & Architecture Evaluation
+     */
+    static getExpertCouncil(): ModelPolicyResolution[];
+    /**
+     * Builds the multi-provider priority candidates list for a given role/artifact
+     */
+    static getCandidatePool(role: string, artifactType?: string): ModelPolicyResolution[];
+    /**
+     * Resolves the primary model and active fallback chain considering enabled providers
+     */
+    static resolve(role: string, artifactType?: string, userPreferredModel?: string, enabledProviders?: Record<string, boolean>): ModelPolicyResolution;
+    /**
+     * Resolves full multi-provider resolution with primary, fallbacks, and council
+     */
+    static resolveMultiProvider(role: string, artifactType?: string, userPreferredModel?: string, enabledProviders?: Record<string, boolean>): MultiProviderPolicyResolution;
+}
+
+interface JudgeEvaluationResult {
+    decision: 'APPROVED' | 'NEEDS_REVISION' | 'REJECTED';
+    score: number;
+    passed: boolean;
+    evaluatedBy: '@agent-as-judge' | '@heuristic-linter';
+    critique: string;
+    strengths: string[];
+    weaknesses: string[];
+    autoRepairInstructions?: string;
+}
+interface AsyncLLMJudgeInput {
+    targetArtifactType: string;
+    lessonId: string;
+    expectedLanguage: string;
+    targetObjectives: Array<{
+        code: string;
+        description: string;
+        bloomLevel: string;
+    }>;
+    generatedContentJson: string;
+    /** Verbatim standard statements (canonical ID -> text) from the Standards Registry. */
+    standardStatements?: Record<string, string>;
+    modelOptions?: ModelResolutionOptions;
+}
+declare class LLMJudgeEngine {
+    /**
+     * Executes genuine LLM-as-Judge evaluation using the audit flow.
+     */
+    static evaluateArtifactWithLLM(input: AsyncLLMJudgeInput): Promise<JudgeEvaluationResult>;
+    /**
+     * Evaluates Gate 1 (SOT Foundation: LEARNER_PROFILE, PROJECT_BRIEF, REFERENCE_PACK)
+     * Calibrated heuristic pre-check.
+     */
+    static evaluateGate1(learnerProfileMarkdown: string, referencePackMarkdown: string): JudgeEvaluationResult;
+    /**
+     * Evaluates Gate 2 (Curriculum Framework: Units, Modules, Lessons, Bloom Progression)
+     */
+    static evaluateGate2(frameworkMarkdown: string, targetUnitCount?: number): JudgeEvaluationResult;
+    /**
+     * Evaluates a produced Lesson Artifact (LESSON, ACT, QUIZ, SLIDE) with heuristic structure checks
+     */
+    static evaluateArtifact(artifactType: string, content: string, lessonTitle: string): JudgeEvaluationResult;
+}
+
+/** Định nghĩa tool (OpenAI-compatible function schema) cho LLM tool-calling */
+interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        /** JSON Schema cho tham số */
+        parameters: Record<string, unknown>;
+    };
+}
+/** Tool call hoàn chỉnh sau khi aggregate các delta */
+interface AggregatedToolCall {
+    id: string;
+    name: string;
+    /** JSON string arguments từ model */
+    arguments: string;
+}
+/** Kết quả thực thi tool do caller cung cấp */
+interface ToolExecutionResult {
+    toolCallId: string;
+    name: string;
+    /** Kết quả serialize thành JSON string khi gửi lại model */
+    result: unknown;
+    isError?: boolean;
+}
+/** Executor: nhận (name, parsedArgs) → kết quả. Throw = lỗi tool (báo lại model) */
+type ToolExecutor = (name: string, args: Record<string, unknown>) => Promise<unknown>;
+/** Cấu hình vòng lặp tool-calling */
+interface ToolLoopConfig {
+    tools: ToolDefinition[];
+    executor: ToolExecutor;
+    /** Số vòng tool-call tối đa (chống vòng lặp vô hạn). Mặc định 4 */
+    maxRounds?: number;
+    /** Báo mỗi lần bắt đầu thực thi tool (để UI hiển thị) */
+    onToolStart?: (name: string, args: Record<string, unknown>) => void;
+    /** Báo kết quả tool */
+    onToolResult?: (result: ToolExecutionResult) => void;
+    /** Báo lỗi tool (không dừng workflow — tool error được đưa lại cho model tự xử lý) */
+    onToolError?: (name: string, error: string) => void;
+}
+
+/**
+ * Stream chat CÓ tool-calling (vòng lặp: model → tool → kết quả → model → …).
+ * Chạy trên OpenRouter (mọi model OpenAI-compatible). Tool error KHÔNG làm chết stream:
+ * lỗi được đóng gói gửi lại model để tự xử lý (và được báo qua onToolError cho observability).
+ */
+declare function streamCurriculumAIInferenceWithTools(messages: ChatMessage[], projectContext: string, options: StreamRunnerOptions, loop: ToolLoopConfig, onChunk?: (token: string, type: ChunkType) => void): Promise<string>;
+
+export { type ActivityPromptInput, type AggregatedToolCall, type AsyncLLMJudgeInput, type AuditCurriculumQualityInput, ChatMessage, ChunkType, type CodeLabPromptInput, DEFAULT_ENABLED_PROVIDERS, type DiagnosticQuizPromptInput, type ExtensionPromptInput, type GenerateActivityInput, type GenerateCodeLabInput, type GenerateDiagnosticQuizInput, type GenerateExtensionInput, type GenerateHandoutInput, type GenerateLessonMasterInput, type GenerateProjectInstructionInput, type GenerateSelfLabInput, type GenerateSlidesInput, type GenerateTeacherGuideInput, type GenerateWorksheetInput, type HandoutPromptInput, type JudgeEvaluationResult, type JudgePromptInput, LLMJudgeEngine, type LessonPromptInput, type ModelPolicyResolution, ModelPolicyResolver, type ModelProviderKey, ModelResolutionOptions, type MultiProviderPolicyResolution, type ProjectInstructionPromptInput, type SelfLabPromptInput, type SlidesPromptInput, type StreamDiagnosticQuizInput, type StreamLessonMasterInput, StreamRunnerOptions, type StreamSelfLabInput, type TeacherGuidePromptInput, type ToolDefinition, type ToolExecutionResult, type ToolExecutor, type ToolLoopConfig, type WorksheetPromptInput, activityTools, analystTools, assessorTools, auditCurriculumQualityFlow, buildActivityPrompt, buildCodeLabPrompt, buildDiagnosticQuizPrompt, buildExtensionPrompt, buildHandoutPrompt, buildJudgePrompt, buildLessonMasterPrompt, buildProjectInstructionPrompt, buildSelfLabPrompt, buildSlidesPrompt, buildTeacherGuidePrompt, buildWorksheetPrompt, contentTools, designerTools, generateActivityFlow, generateCodeLabFlow, generateDiagnosticQuizFlow, generateExtensionFlow, generateHandoutFlow, generateLessonMasterFlow, generateProjectInstructionFlow, generateSelfLabFlow, generateSlidesFlow, generateTeacherGuideFlow, generateWorksheetFlow, illustratorTools, packagerTools, researcherTools, reviewerTools, streamCurriculumAIInferenceWithTools, streamDiagnosticQuizFlow, streamLessonMasterFlow, streamSelfLabFlow, techSmeTools };