learngraph 0.5.0 → 0.7.0

package/dist/types/types/assessment.d.ts

@@ -0,0 +1,512 @@
+/**
+ * Assessment Types
+ *
+ * Comprehensive type definitions for the assessment framework including:
+ * - Question types (multiple choice, free response, etc.)
+ * - Assessment structures
+ * - Item Response Theory (IRT) parameters
+ * - Bayesian Knowledge Tracing (BKT) parameters
+ * - Evidence of learning
+ *
+ * @packageDocumentation
+ */
+import type { SkillId } from './skill.js';
+import type { BloomLevel } from './bloom.js';
+/**
+ * Unique identifier for a question/item
+ */
+export type QuestionId = string & {
+    readonly __brand: 'QuestionId';
+};
+/**
+ * Create a typed QuestionId from a string
+ */
+export declare function createQuestionId(id: string): QuestionId;
+/**
+ * Supported question formats
+ */
+export type QuestionType = 'multiple-choice' | 'multiple-select' | 'true-false' | 'free-response' | 'numeric' | 'ordering' | 'matching' | 'fill-blank' | 'code' | 'diagram';
+/**
+ * Answer option for choice-based questions
+ */
+export interface AnswerOption {
+    /** Unique identifier for this option */
+    id: string;
+    /** Display text for the option */
+    text: string;
+    /** Whether this is a correct answer */
+    isCorrect: boolean;
+    /** Explanation for why this option is correct/incorrect (shown after response) */
+    explanation?: string;
+    /** Partial credit weight (0-1) for partially correct answers */
+    partialCredit?: number;
+}
+/**
+ * Matching pair for matching questions
+ */
+export interface MatchingPair {
+    /** Left side item */
+    prompt: string;
+    /** Right side item (correct match) */
+    response: string;
+    /** Optional ID for the pair */
+    id?: string;
+}
+/**
+ * Question/Item definition
+ */
+export interface Question {
+    /** Unique identifier */
+    id: QuestionId;
+    /** Question type */
+    type: QuestionType;
+    /** Question prompt/stem */
+    prompt: string;
+    /** Skill(s) this question assesses */
+    skillIds: SkillId[];
+    /** Bloom's taxonomy level */
+    bloomLevel: BloomLevel;
+    /** Answer options (for choice-based questions) */
+    options?: AnswerOption[];
+    /** Correct answer for non-choice questions */
+    correctAnswer?: string | number | string[];
+    /** Matching pairs (for matching questions) */
+    matchingPairs?: MatchingPair[];
+    /** Tolerance for numeric answers (e.g., 0.01 for 1% tolerance) */
+    numericTolerance?: number;
+    /** Hint text (optional scaffolding) */
+    hint?: string;
+    /** Detailed explanation shown after response */
+    explanation?: string;
+    /** Tags for categorization */
+    tags: string[];
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** IRT parameters (if calibrated) */
+    irtParams?: IRTParameters;
+    /** Estimated time to answer (minutes) */
+    estimatedMinutes?: number;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+/**
+ * Input for creating a new question
+ */
+export type QuestionInput = Omit<Question, 'id' | 'createdAt' | 'updatedAt'>;
+/**
+ * Unique identifier for an assessment
+ */
+export type AssessmentId = string & {
+    readonly __brand: 'AssessmentId';
+};
+/**
+ * Create a typed AssessmentId from a string
+ */
+export declare function createAssessmentId(id: string): AssessmentId;
+/**
+ * Assessment type/purpose
+ */
+export type AssessmentType = 'diagnostic' | 'formative' | 'summative' | 'practice' | 'placement' | 'review';
+/**
+ * Question selection strategy for adaptive assessments
+ */
+export type SelectionStrategy = 'sequential' | 'random' | 'adaptive-irt' | 'adaptive-mastery' | 'zpd-focused';
+/**
+ * Termination criterion for adaptive assessments
+ */
+export interface TerminationCriteria {
+    /** Maximum number of questions */
+    maxQuestions?: number;
+    /** Minimum number of questions before early termination */
+    minQuestions?: number;
+    /** Target precision (standard error) for ability estimate */
+    targetPrecision?: number;
+    /** Maximum time in minutes */
+    maxTimeMinutes?: number;
+    /** Mastery threshold to achieve */
+    masteryThreshold?: number;
+}
+/**
+ * Assessment configuration
+ */
+export interface Assessment {
+    /** Unique identifier */
+    id: AssessmentId;
+    /** Assessment name */
+    name: string;
+    /** Assessment description */
+    description?: string;
+    /** Assessment type/purpose */
+    type: AssessmentType;
+    /** Skills being assessed */
+    skillIds: SkillId[];
+    /** Question pool */
+    questions: QuestionId[];
+    /** Question selection strategy */
+    selectionStrategy: SelectionStrategy;
+    /** Termination criteria */
+    terminationCriteria: TerminationCriteria;
+    /** Whether to show feedback after each question */
+    immediateFeedback: boolean;
+    /** Whether to allow review/changing answers */
+    allowReview: boolean;
+    /** Time limit in minutes (null for untimed) */
+    timeLimitMinutes: number | null;
+    /** Shuffle question order */
+    shuffleQuestions: boolean;
+    /** Shuffle answer options */
+    shuffleOptions: boolean;
+    /** Passing score (0-1) */
+    passingScore?: number;
+    /** Tags for categorization */
+    tags: string[];
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+}
+/**
+ * Input for creating a new assessment
+ */
+export type AssessmentInput = Omit<Assessment, 'id' | 'createdAt' | 'updatedAt'>;
+/**
+ * Unique identifier for a response
+ */
+export type ResponseId = string & {
+    readonly __brand: 'ResponseId';
+};
+/**
+ * Create a typed ResponseId from a string
+ */
+export declare function createResponseId(id: string): ResponseId;
+/**
+ * Learner's response to a question
+ */
+export interface LearnerResponse {
+    /** Unique identifier */
+    id: ResponseId;
+    /** Question being answered */
+    questionId: QuestionId;
+    /** Assessment context (if part of an assessment) */
+    assessmentId?: AssessmentId;
+    /** Learner's answer */
+    answer: string | number | string[] | null;
+    /** Whether the response was correct */
+    isCorrect: boolean;
+    /** Partial credit score (0-1) */
+    score: number;
+    /** Response time in milliseconds */
+    responseTimeMs: number;
+    /** Number of attempts on this question in this session */
+    attemptNumber: number;
+    /** Whether a hint was used */
+    usedHint: boolean;
+    /** Confidence rating if provided by learner (1-5) */
+    confidence?: number;
+    /** Timestamp of response */
+    timestamp: string;
+    /** Session identifier */
+    sessionId?: string;
+}
+/**
+ * Assessment session (learner taking an assessment)
+ */
+export interface AssessmentSession {
+    /** Session identifier */
+    id: string;
+    /** Assessment being taken */
+    assessmentId: AssessmentId;
+    /** Learner identifier */
+    learnerId: string;
+    /** Session status */
+    status: 'in-progress' | 'completed' | 'abandoned' | 'timed-out';
+    /** Questions presented in order */
+    questionsPresented: QuestionId[];
+    /** All responses in order */
+    responses: LearnerResponse[];
+    /** Current ability estimate (IRT theta) */
+    abilityEstimate?: number;
+    /** Standard error of ability estimate */
+    abilityStandardError?: number;
+    /** Mastery estimates per skill */
+    masteryEstimates: Map<SkillId, number>;
+    /** Start timestamp */
+    startedAt: string;
+    /** Completion timestamp */
+    completedAt?: string;
+    /** Total time spent (milliseconds) */
+    totalTimeMs: number;
+    /** Final score (0-1) */
+    finalScore?: number;
+    /** Whether passed */
+    passed?: boolean;
+}
+/**
+ * IRT model type
+ */
+export type IRTModel = '1PL' | '2PL' | '3PL';
+/**
+ * IRT item parameters
+ */
+export interface IRTParameters {
+    /** Item difficulty (b parameter, typically -3 to +3) */
+    difficulty: number;
+    /** Item discrimination (a parameter, typically 0.5 to 2.5) */
+    discrimination?: number;
+    /** Pseudo-guessing parameter (c parameter, 0 to 0.5) */
+    guessing?: number;
+    /** Model used for calibration */
+    model: IRTModel;
+    /** Standard error of parameter estimates */
+    standardErrors?: {
+        difficulty?: number;
+        discrimination?: number;
+        guessing?: number;
+    };
+}
+/**
+ * IRT ability estimate for a learner
+ */
+export interface IRTAbilityEstimate {
+    /** Ability estimate (theta, typically -3 to +3) */
+    theta: number;
+    /** Standard error of estimate */
+    standardError: number;
+    /** Number of items used in estimation */
+    itemCount: number;
+    /** Estimation method used */
+    method: 'MLE' | 'EAP' | 'MAP';
+    /** Confidence interval (95%) */
+    confidenceInterval: {
+        lower: number;
+        upper: number;
+    };
+}
+/**
+ * IRT configuration options
+ */
+export interface IRTConfig {
+    /** IRT model to use */
+    model?: IRTModel;
+    /** Prior distribution for ability (for Bayesian methods) */
+    abilityPrior?: {
+        mean: number;
+        sd: number;
+    };
+    /** Maximum iterations for estimation */
+    maxIterations?: number;
+    /** Convergence threshold */
+    convergenceThreshold?: number;
+}
+/**
+ * BKT parameters for a skill
+ */
+export interface BKTParameters {
+    /** Prior probability of mastery (P(L₀)) */
+    pInit: number;
+    /** Probability of learning per opportunity (P(T)) */
+    pLearn: number;
+    /** Probability of slip (wrong despite mastery) (P(S)) */
+    pSlip: number;
+    /** Probability of guess (correct despite no mastery) (P(G)) */
+    pGuess: number;
+}
+/**
+ * Default BKT parameters (empirically derived)
+ */
+export declare const BKT_DEFAULTS: BKTParameters;
+/**
+ * BKT state for a skill
+ */
+export interface BKTState {
+    /** Skill being tracked */
+    skillId: SkillId;
+    /** Current mastery probability P(Lₙ) */
+    pMastery: number;
+    /** Number of observations */
+    observations: number;
+    /** History of responses (for debugging/analysis) */
+    history?: boolean[];
+}
+/**
+ * BKT configuration options
+ */
+export interface BKTConfig {
+    /** Mastery threshold for declaring skill "learned" */
+    masteryThreshold?: number;
+    /** Whether to use individualized parameters */
+    individualizedParams?: boolean;
+    /** Whether to track response history */
+    trackHistory?: boolean;
+}
+/**
+ * Evidence source type
+ */
+export type EvidenceSource = 'assessment' | 'practice' | 'observation' | 'self-report' | 'project' | 'portfolio' | 'peer-review' | 'automated';
+/**
+ * Evidence of learning
+ */
+export interface LearningEvidence {
+    /** Evidence identifier */
+    id: string;
+    /** Skill demonstrated */
+    skillId: SkillId;
+    /** Evidence source */
+    source: EvidenceSource;
+    /** Demonstrated mastery level (0-1) */
+    masteryLevel: number;
+    /** Bloom's level demonstrated */
+    bloomLevel: BloomLevel;
+    /** Confidence in this evidence (0-1) */
+    confidence: number;
+    /** Timestamp of evidence */
+    timestamp: string;
+    /** Description of evidence */
+    description?: string;
+    /** Link to artifact (if applicable) */
+    artifactUrl?: string;
+    /** Related responses (if from assessment) */
+    responseIds?: ResponseId[];
+    /** Evaluator (for observation/peer evidence) */
+    evaluator?: string;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Aggregated evidence summary for a skill
+ */
+export interface EvidenceSummary {
+    /** Skill being summarized */
+    skillId: SkillId;
+    /** Number of evidence items */
+    evidenceCount: number;
+    /** Weighted average mastery */
+    averageMastery: number;
+    /** Most recent evidence */
+    latestEvidence: LearningEvidence;
+    /** Evidence by source type */
+    bySource: Partial<Record<EvidenceSource, number>>;
+    /** Trend direction */
+    trend: 'improving' | 'stable' | 'declining';
+    /** Confidence in the summary */
+    confidence: number;
+}
+/**
+ * Item selection result from adaptive algorithm
+ */
+export interface ItemSelection {
+    /** Selected question ID */
+    questionId: QuestionId;
+    /** Information value of the selected item */
+    information: number;
+    /** Reason for selection */
+    reason: string;
+    /** Alternative candidates considered */
+    alternatives?: QuestionId[];
+}
+/**
+ * Adaptive assessment state
+ */
+export interface AdaptiveState {
+    /** Current ability estimate */
+    abilityEstimate: number;
+    /** Standard error */
+    standardError: number;
+    /** Items already administered */
+    administeredItems: QuestionId[];
+    /** Current content coverage */
+    contentCoverage: Map<SkillId, number>;
+    /** Termination status */
+    shouldTerminate: boolean;
+    /** Reason for termination (if applicable) */
+    terminationReason?: string;
+}
+/**
+ * Adaptive algorithm configuration
+ */
+export interface AdaptiveConfig {
+    /** Item selection method */
+    selectionMethod: 'MFI' | 'KL' | 'EBI' | 'MEPV';
+    /** Content balancing constraints */
+    contentBalancing?: {
+        skillId: SkillId;
+        minItems?: number;
+        maxItems?: number;
+    }[];
+    /** Exposure control (0-1) */
+    maxExposureRate?: number;
+    /** Item overlap control for retests */
+    preventOverlap?: boolean;
+}
+/**
+ * Detailed assessment results
+ */
+export interface AssessmentResult {
+    /** Session that produced this result */
+    sessionId: string;
+    /** Assessment taken */
+    assessmentId: AssessmentId;
+    /** Final score (0-1) */
+    score: number;
+    /** Whether passed */
+    passed: boolean;
+    /** Ability estimate (IRT) */
+    abilityEstimate?: IRTAbilityEstimate;
+    /** Mastery per skill */
+    masteryBySkill: Map<SkillId, number>;
+    /** Performance by Bloom's level */
+    performanceByBloom: Record<BloomLevel, {
+        correct: number;
+        total: number;
+        percentage: number;
+    }>;
+    /** Strengths identified */
+    strengths: SkillId[];
+    /** Areas for improvement */
+    areasForImprovement: SkillId[];
+    /** Recommended next skills */
+    recommendedSkills: SkillId[];
+    /** Summary statistics */
+    stats: {
+        totalQuestions: number;
+        correctAnswers: number;
+        averageResponseTime: number;
+        totalTimeMinutes: number;
+        hintsUsed: number;
+    };
+}
+/**
+ * Difficulty adjustment based on response
+ */
+export interface DifficultyAdjustment {
+    /** Current difficulty level (0-1) */
+    currentDifficulty: number;
+    /** Recommended adjustment (-1 to +1) */
+    adjustment: number;
+    /** New recommended difficulty */
+    newDifficulty: number;
+    /** Reason for adjustment */
+    reason: string;
+}
+/**
+ * Validation result for assessment
+ */
+export interface AssessmentValidation {
+    /** Whether the assessment is valid */
+    isValid: boolean;
+    /** Validation errors */
+    errors: string[];
+    /** Validation warnings */
+    warnings: string[];
+    /** Coverage analysis */
+    coverage: {
+        skillsCovered: number;
+        skillsMissing: SkillId[];
+        bloomLevelsCovered: BloomLevel[];
+    };
+}
+//# sourceMappingURL=assessment.d.ts.map

package/dist/types/types/assessment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assessment.d.ts","sourceRoot":"","sources":["../../../src/types/assessment.ts"],"names":[],"mappings":"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"}

package/dist/types/types/bloom.d.ts

@@ -7,6 +7,10 @@
  * @see https://cft.vanderbilt.edu/guides-sub-pages/blooms-taxonomy/
  */
 export type BloomLevel = 'remember' | 'understand' | 'apply' | 'analyze' | 'evaluate' | 'create';
+/**
+ * All Bloom's levels as an ordered array
+ */
+export declare const BLOOM_LEVELS: readonly BloomLevel[];
 /**
  * Numeric mapping for Bloom's levels (1-6 scale)
  */

package/dist/types/types/bloom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bloom.d.ts","sourceRoot":"","sources":["../../../src/types/bloom.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,YAAY,GACZ,OAAO,GACP,SAAS,GACT,UAAU,GACV,QAAQ,CAAC;AAEb;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAO/C,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CA8GpD,CAAC;AAEX;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA4BhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAEnF"}
+{"version":3,"file":"bloom.d.ts","sourceRoot":"","sources":["../../../src/types/bloom.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAClB,UAAU,GACV,YAAY,GACZ,OAAO,GACP,SAAS,GACT,UAAU,GACV,QAAQ,CAAC;AAEb;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAOpC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAO/C,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CA8GpD,CAAC;AAEX;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA4BhE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,MAAM,CAEvE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAEnF"}

package/dist/types/types/index.d.ts

@@ -4,7 +4,7 @@
  * @packageDocumentation
  */
 export type { BloomLevel } from './bloom.js';
-export { BLOOM_LEVEL_ORDER, BLOOM_VERBS, detectBloomLevel, compareBloomLevels, meetsBloomThreshold, } from './bloom.js';
+export { BLOOM_LEVELS, BLOOM_LEVEL_ORDER, BLOOM_VERBS, detectBloomLevel, compareBloomLevels, meetsBloomThreshold, } from './bloom.js';
 export type { SkillId, SkillNode, SkillNodeInput, SkillNodeUpdate } from './skill.js';
 export { createSkillId, SKILL_DEFAULTS, THRESHOLD_CONCEPT_MASTERY, isValidDifficulty, isValidMasteryThreshold, } from './skill.js';
 export type { EdgeId, EdgeType, PrerequisiteEdge, PrerequisiteEdgeInput } from './edge.js';
@@ -17,4 +17,6 @@ export type { QueryOperator, QueryFilter, QuerySort, QueryPagination, SkillQuery
 export type { StorageBackend, StorageConfigBase, Neo4jConfig, LevelGraphConfig, MemoryConfig, StorageConfig, ConnectionStatus, ImportResult, GraphStorage, StorageFactory, } from './storage.js';
 export type { ParseFormat, DocumentMetadata, LearningObjective, Topic, Module, ParseResult, ParseWarning, ParseStats, ExtractedSkill, SkillExtractionResult, ParseOptions, ExtractionOptions, Parser, SkillExtractor, } from './parser.js';
 export type { LLMProvider, LLMConfig, OpenAIConfig, AnthropicConfig, OllamaConfig, MessageRole, ChatMessage, CompletionRequest, CompletionResponse, SkillExtractionRequest, ExtractedSkillLLM, SkillExtractionResponse, PrerequisiteInferenceRequest, InferredPrerequisite, PrerequisiteInferenceResponse, BloomAnalysisRequest, BloomAnalysisResponse, DecompositionRequest, DecompositionResponse, LLMAdapter, LLMOrchestrator, } from './llm.js';
+export type { QuestionId, QuestionType, AnswerOption, MatchingPair, Question, QuestionInput, AssessmentId, AssessmentType, SelectionStrategy, TerminationCriteria, Assessment, AssessmentInput, ResponseId, LearnerResponse, AssessmentSession, IRTModel, IRTParameters, IRTAbilityEstimate, IRTConfig, BKTParameters, BKTState, BKTConfig, EvidenceSource, LearningEvidence, EvidenceSummary, ItemSelection, AdaptiveState, AdaptiveConfig, AssessmentResult, DifficultyAdjustment, AssessmentValidation, } from './assessment.js';
+export { createQuestionId, createAssessmentId, createResponseId, BKT_DEFAULTS, } from './assessment.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAKpB,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAKpB,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,WAAW,CAAC;AAKnB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1E,YAAY,EACV,QAAQ,EACR,WAAW,EACX,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3C,YAAY,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,UAAU,EACV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAKpB,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AAKtB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,EACL,MAAM,EACN,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,MAAM,EACN,cAAc,GACf,MAAM,aAAa,CAAC;AAKrB,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,eAAe,GAChB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAKpB,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,aAAa,EACb,cAAc,EACd,yBAAyB,EACzB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAKpB,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC3F,OAAO,EACL,YAAY,EACZ,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,WAAW,CAAC;AAKnB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1E,YAAY,EACV,QAAQ,EACR,WAAW,EACX,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAK3C,YAAY,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,eAAe,EACf,UAAU,EACV,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EACV,UAAU,EACV,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC;AAKpB,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AAKtB,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,EACL,MAAM,EACN,WAAW,EACX,YAAY,EACZ,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,MAAM,EACN,cAAc,GACf,MAAM,aAAa,CAAC;AAKrB,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,uBAAuB,EACvB,4BAA4B,EAC5B,oBAAoB,EACpB,6BAA6B,EAC7B,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,eAAe,GAChB,MAAM,UAAU,CAAC;AAKlB,YAAY,EAEV,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,aAAa,EAEb,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,eAAe,EAEf,UAAU,EACV,eAAe,EACf,iBAAiB,EAEjB,QAAQ,EACR,aAAa,EACb,kBAAkB,EAClB,SAAS,EAET,aAAa,EACb,QAAQ,EACR,SAAS,EAET,cAAc,EACd,gBAAgB,EAChB,eAAe,EAEf,aAAa,EACb,aAAa,EACb,cAAc,EAEd,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,GACb,MAAM,iBAAiB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "learngraph",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "The world's first AI-powered learning path generator. Transform syllabi into personalized mastery paths with Zone of Proximal Development (ZPD), Bloom's Taxonomy, spaced repetition, and Bayesian Knowledge Tracing built in. Every student's path to mastery.",
   "author": "Dr. Ernesto Lee <dr.ernesto.lee@gmail.com>",
   "license": "Apache-2.0",
@@ -123,6 +123,26 @@
         "types": "./dist/types/education/index.d.ts",
         "default": "./dist/cjs/education/index.js"
       }
+    },
+    "./mcp": {
+      "import": {
+        "types": "./dist/types/mcp/index.d.ts",
+        "default": "./dist/esm/mcp/index.js"
+      },
+      "require": {
+        "types": "./dist/types/mcp/index.d.ts",
+        "default": "./dist/cjs/mcp/index.js"
+      }
+    },
+    "./components": {
+      "import": {
+        "types": "./dist/types/components/index.d.ts",
+        "default": "./dist/esm/components/index.js"
+      },
+      "require": {
+        "types": "./dist/types/components/index.d.ts",
+        "default": "./dist/cjs/components/index.js"
+      }
     }
   },
   "files": [
@@ -146,22 +166,32 @@
     "clean": "rm -rf dist coverage"
   },
   "dependencies": {
+    "hono": "^4.11.1",
     "zod": "^3.23.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
+    "@types/react": "^18.3.27",
+    "@types/react-dom": "^18.3.7",
     "@typescript-eslint/eslint-plugin": "^7.0.0",
     "@typescript-eslint/parser": "^7.0.0",
     "@vitest/coverage-v8": "^1.6.0",
     "eslint": "^8.57.0",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "reactflow": "^11.11.4",
     "typescript": "^5.4.0",
     "vitest": "^1.6.0"
   },
   "peerDependencies": {
-    "neo4j-driver": "^5.0.0",
+    "@mediapipe/tasks-genai": "^0.10.0",
+    "@modelcontextprotocol/sdk": "^1.25.1",
     "level": "^8.0.0",
     "levelgraph": "^3.0.0",
-    "@mediapipe/tasks-genai": "^0.10.0"
+    "neo4j-driver": "^5.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "reactflow": "^11.0.0"
   },
   "peerDependenciesMeta": {
     "neo4j-driver": {
@@ -175,6 +205,21 @@
     },
     "@mediapipe/tasks-genai": {
       "optional": true
+    },
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "reactflow": {
+      "optional": true
     }
+  },
+  "bin": {
+    "learngraph-mcp": "./dist/esm/mcp/cli.js"
   }
 }