learngraph 0.7.0 → 0.9.0

package/dist/types/llm/graphrag-orchestrator.d.ts

@@ -0,0 +1,280 @@
+/**
+ * GraphRAG-enhanced LLM orchestrator
+ *
+ * Extends the base orchestrator with semantic search capabilities
+ * to provide better context for skill extraction and prerequisite inference.
+ *
+ * @packageDocumentation
+ */
+import type { LLMAdapter, SkillExtractionRequest, SkillExtractionResponse, PrerequisiteInferenceRequest, PrerequisiteInferenceResponse, DecompositionRequest, DecompositionResponse, ExtractedSkillLLM } from '../types/llm.js';
+import type { BloomLevel } from '../types/bloom.js';
+import type { GraphRAGStorage, VectorSearchResult } from '../types/graphrag.js';
+import { LLMOrchestrator } from './orchestrator.js';
+/**
+ * Options for GraphRAG-enhanced operations
+ */
+export interface GraphRAGOrchestratorOptions {
+    /** Maximum similar skills to include in context (default: 5) */
+    maxContextSkills?: number;
+    /** Minimum similarity score for context skills (default: 0.6) */
+    minContextScore?: number;
+    /** Include prerequisite chains in context (default: true) */
+    includePrerequisites?: boolean;
+    /** Weight for similar skill context in prompt (default: 0.3) */
+    contextWeight?: number;
+}
+/**
+ * Extended extraction request with RAG context
+ */
+export interface RAGSkillExtractionRequest extends SkillExtractionRequest {
+    /** Enable RAG-enhanced extraction */
+    useRAG?: boolean;
+    /** RAG options */
+    ragOptions?: GraphRAGOrchestratorOptions;
+}
+/**
+ * Extended extraction response with RAG metadata
+ */
+export interface RAGSkillExtractionResponse extends SkillExtractionResponse {
+    /** Similar skills used for context */
+    contextSkills?: VectorSearchResult[];
+    /** RAG context that was provided */
+    ragContext?: string;
+}
+/**
+ * Extended decomposition request with RAG
+ */
+export interface RAGDecompositionRequest extends DecompositionRequest {
+    /** Enable RAG-enhanced decomposition */
+    useRAG?: boolean;
+    /** RAG options */
+    ragOptions?: GraphRAGOrchestratorOptions;
+}
+/**
+ * Extended decomposition response with RAG metadata
+ */
+export interface RAGDecompositionResponse extends DecompositionResponse {
+    /** Similar skills used for context */
+    contextSkills?: VectorSearchResult[];
+    /** RAG context that was provided */
+    ragContext?: string;
+    /** Skills that were matched to existing graph skills */
+    matchedSkills?: Array<{
+        extractedId: string;
+        matchedSkillId: string;
+        similarity: number;
+    }>;
+}
+/**
+ * GraphRAG-enhanced LLM orchestrator
+ *
+ * Provides semantic search-enhanced skill extraction and prerequisite inference.
+ */
+export declare class GraphRAGOrchestrator extends LLMOrchestrator {
+    private storage;
+    private defaultOptions;
+    constructor(adapter: LLMAdapter, storage?: GraphRAGStorage, options?: GraphRAGOrchestratorOptions);
+    /**
+     * Set the GraphRAG storage
+     */
+    setStorage(storage: GraphRAGStorage): void;
+    /**
+     * Get the current storage
+     */
+    getStorage(): GraphRAGStorage | null;
+    /**
+     * Check if GraphRAG is available
+     */
+    isRAGEnabled(): boolean;
+    /**
+     * Build context string from similar skills
+     */
+    private formatSkillContext;
+    /**
+     * Build context from full GraphRAG context
+     */
+    private formatGraphRAGContext;
+    /**
+     * Extract skills with RAG enhancement
+     */
+    extractSkillsWithRAG(request: RAGSkillExtractionRequest): Promise<RAGSkillExtractionResponse>;
+    /**
+     * Infer prerequisites with RAG enhancement
+     */
+    inferPrerequisitesWithRAG(request: PrerequisiteInferenceRequest & {
+        useRAG?: boolean;
+        ragOptions?: GraphRAGOrchestratorOptions;
+    }): Promise<PrerequisiteInferenceResponse & {
+        ragContext?: string;
+    }>;
+    /**
+     * Full curriculum decomposition with RAG enhancement
+     */
+    decomposeWithRAG(request: RAGDecompositionRequest): Promise<RAGDecompositionResponse>;
+    /**
+     * Find existing skills that match extracted skills
+     *
+     * Use this after extraction to identify duplicates
+     */
+    matchExtractedSkills(extractedSkills: ExtractedSkillLLM[], options?: {
+        minSimilarity?: number;
+    }): Promise<Array<{
+        extracted: ExtractedSkillLLM;
+        matches: VectorSearchResult[];
+        bestMatch?: {
+            skillId: string;
+            similarity: number;
+        };
+    }>>;
+    /**
+     * Suggest prerequisite links between extracted and existing skills
+     */
+    suggestPrerequisiteLinks(extractedSkills: Array<{
+        id: string;
+        name: string;
+        description: string;
+        bloomLevel: BloomLevel;
+    }>, options?: {
+        maxSuggestionsPerSkill?: number;
+    }): Promise<Array<{
+        extractedSkillId: string;
+        suggestedPrerequisites: Array<{
+            skillId: string;
+            skillName: string;
+            confidence: number;
+        }>;
+        suggestedDependents: Array<{
+            skillId: string;
+            skillName: string;
+            confidence: number;
+        }>;
+    }>>;
+    /**
+     * Generate a personalized learning path with LLM-enhanced reasoning
+     *
+     * This combines GraphRAG path generation with LLM analysis
+     * to provide better explanations and alternative paths.
+     */
+    generateLearningPath(request: LearningPathRequest): Promise<LearningPathWithReasoning>;
+    /**
+     * Format a learning path for LLM context
+     */
+    private formatPathForLLM;
+    /**
+     * Analyze a learner's progress and recommend next steps
+     */
+    analyzeProgressAndRecommend(request: ProgressAnalysisRequest): Promise<ProgressAnalysisResult>;
+}
+/**
+ * Request for learning path generation
+ */
+export interface LearningPathRequest {
+    /** Natural language goal description */
+    goal: string;
+    /** Current skill mastery states (skillId -> mastery 0-1) */
+    currentMastery?: Map<string, number>;
+    /** Maximum path length */
+    maxSteps?: number;
+    /** Learning preferences */
+    preferences?: {
+        style?: 'practical' | 'theoretical' | 'balanced';
+        difficulty?: 'gradual' | 'challenging';
+    };
+    /** Enhance path with LLM reasoning */
+    enhanceWithLLM?: boolean;
+}
+/**
+ * Enhanced learning path result with LLM reasoning
+ */
+export interface LearningPathWithReasoning {
+    /** Ordered list of skills with optional learning guidance */
+    path: Array<import('../types/skill.js').SkillNode & {
+        learningGuidance?: {
+            whyImportant: string;
+            howToApproach: string;
+            estimatedEffort: string;
+        };
+    }>;
+    /** Edges connecting path skills */
+    edges: import('../types/edge.js').PrerequisiteEdge[];
+    /** Estimated total time (minutes) */
+    estimatedMinutes: number;
+    /** Detailed reasoning for the path */
+    reasoning: string;
+    /** Alternative paths */
+    alternatives?: Array<{
+        path: import('../types/skill.js').SkillNode[];
+        reasoning: string;
+    }>;
+    /** LLM-generated enhancements */
+    llmEnhancements?: {
+        tips: string[];
+        potentialChallenges: string[];
+        alternativeApproaches?: Array<{
+            name: string;
+            description: string;
+            tradeoffs: string;
+        }>;
+    };
+    /** API usage */
+    usage?: import('../types/llm.js').CompletionResponse['usage'];
+    /** Processing time in milliseconds */
+    durationMs: number;
+}
+/**
+ * Progress analysis request
+ */
+export interface ProgressAnalysisRequest {
+    /** Map of skill IDs to mastery levels (0-1) */
+    masteredSkills: Map<string, number>;
+    /** The learner's goal (optional) */
+    goal?: string;
+    /** Generate LLM insights */
+    generateInsights?: boolean;
+    /** Max recommendations to return */
+    maxRecommendations?: number;
+}
+/**
+ * Skill recommendation
+ */
+export interface SkillRecommendation {
+    /** The recommended skill */
+    skill: import('../types/skill.js').SkillNode;
+    /** How ready the learner is (0-1) */
+    readiness: number;
+    /** Why this skill is recommended */
+    reason: string;
+    /** Priority score */
+    priority: number;
+}
+/**
+ * LLM-generated progress insights
+ */
+export interface ProgressInsights {
+    /** Summary of current progress */
+    progressSummary: string;
+    /** Strengths identified */
+    strengths: string[];
+    /** Areas for improvement */
+    areasToImprove: string[];
+    /** Motivational message */
+    encouragement: string;
+    /** Suggested focus areas */
+    focusAreas: string[];
+}
+/**
+ * Progress analysis result
+ */
+export interface ProgressAnalysisResult {
+    /** Recommended skills */
+    recommendations: SkillRecommendation[];
+    /** LLM insights (if requested) */
+    insights?: ProgressInsights;
+    /** Processing time */
+    durationMs: number;
+}
+/**
+ * Create a GraphRAG-enhanced orchestrator
+ */
+export declare function createGraphRAGOrchestrator(adapter: LLMAdapter, storage?: GraphRAGStorage, options?: GraphRAGOrchestratorOptions): GraphRAGOrchestrator;
+//# sourceMappingURL=graphrag-orchestrator.d.ts.map

package/dist/types/llm/graphrag-orchestrator.d.ts.map

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

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

@@ -7,5 +7,7 @@ export type { LLMProvider, LLMConfig, OpenAIConfig, AnthropicConfig, OllamaConfi
 export { BaseLLMAdapter, LLMError, DEFAULT_CONFIG, OpenAIAdapter, createOpenAIAdapter, AnthropicAdapter, createAnthropicAdapter, OllamaAdapter, createOllamaAdapter, GeminiAdapter, createGeminiAdapter, OpenRouterAdapter, createOpenRouterAdapter, OPENROUTER_MODELS, MediaPipeAdapter, createMediaPipeAdapter, MEDIAPIPE_MODELS, } from './adapters/index.js';
 export type { LLMErrorCode } from './adapters/index.js';
 export { LLMOrchestrator, createOrchestrator } from './orchestrator.js';
-export { SYSTEM_PROMPTS, EXTRACTION_SCHEMA, PREREQUISITE_SCHEMA, BLOOM_ANALYSIS_SCHEMA, DECOMPOSITION_SCHEMA, buildExtractionPrompt, buildPrerequisitePrompt, buildBloomPrompt, buildDecompositionPrompt, } from './prompts.js';
+export { GraphRAGOrchestrator, createGraphRAGOrchestrator, } from './graphrag-orchestrator.js';
+export type { GraphRAGOrchestratorOptions, RAGSkillExtractionRequest, RAGSkillExtractionResponse, RAGDecompositionRequest, RAGDecompositionResponse, LearningPathRequest, LearningPathWithReasoning, ProgressAnalysisRequest, ProgressAnalysisResult, SkillRecommendation, ProgressInsights, } from './graphrag-orchestrator.js';
+export { SYSTEM_PROMPTS, EXTRACTION_SCHEMA, PREREQUISITE_SCHEMA, BLOOM_ANALYSIS_SCHEMA, DECOMPOSITION_SCHEMA, RESOURCE_REFERENCE_SCHEMA, DEEP_ANALYSIS_SCHEMA, buildExtractionPrompt, buildPrerequisitePrompt, buildBloomPrompt, buildDecompositionPrompt, buildResourceReferencePrompt, buildDeepAnalysisPrompt, } from './prompts.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,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,IAAI,gBAAgB,GACpC,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EACL,cAAc,EACd,QAAQ,EACR,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAKxE,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/llm/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,YAAY,EACV,WAAW,EACX,SAAS,EACT,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,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,IAAI,gBAAgB,GACpC,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EACL,cAAc,EACd,QAAQ,EACR,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKxD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAKxE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EACV,2BAA2B,EAC3B,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,cAAc,CAAC"}

package/dist/types/llm/prompts.d.ts

@@ -8,6 +8,8 @@ export declare const SYSTEM_PROMPTS: {
     skillExtraction: string;
     prerequisiteInference: string;
     bloomAnalysis: string;
+    resourceReferenceExtraction: string;
+    deepResourceAnalysis: string;
     curriculumDecomposition: string;
 };
 export declare const EXTRACTION_SCHEMA: {
@@ -231,6 +233,117 @@ export declare const DECOMPOSITION_SCHEMA: {
     };
     required: string[];
 };
+export declare const RESOURCE_REFERENCE_SCHEMA: {
+    type: string;
+    properties: {
+        resources: {
+            type: string;
+            items: {
+                type: string;
+                properties: {
+                    name: {
+                        type: string;
+                        description: string;
+                    };
+                    type: {
+                        type: string;
+                        enum: string[];
+                        description: string;
+                    };
+                    reference: {
+                        type: string;
+                        description: string;
+                    };
+                    originalMention: {
+                        type: string;
+                        description: string;
+                    };
+                    relatedSkillIds: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                        description: string;
+                    };
+                    estimatedMinutes: {
+                        type: string;
+                        description: string;
+                    };
+                };
+                required: string[];
+            };
+        };
+    };
+    required: string[];
+};
+export declare const DEEP_ANALYSIS_SCHEMA: {
+    type: string;
+    properties: {
+        identifiedSkills: {
+            type: string;
+            items: {
+                type: string;
+                properties: {
+                    skillId: {
+                        type: string;
+                        description: string;
+                    };
+                    isExisting: {
+                        type: string;
+                        description: string;
+                    };
+                    confidence: {
+                        type: string;
+                        minimum: number;
+                        maximum: number;
+                    };
+                    coverageDetails: {
+                        type: string;
+                        description: string;
+                    };
+                };
+                required: string[];
+            };
+        };
+        keyTopics: {
+            type: string;
+            items: {
+                type: string;
+            };
+            description: string;
+        };
+        assumedPrerequisites: {
+            type: string;
+            items: {
+                type: string;
+            };
+            description: string;
+        };
+        learningObjectives: {
+            type: string;
+            items: {
+                type: string;
+            };
+            description: string;
+        };
+        difficultyLevel: {
+            type: string;
+            enum: string[];
+        };
+        qualityScore: {
+            type: string;
+            minimum: number;
+            maximum: number;
+        };
+        warnings: {
+            type: string;
+            items: {
+                type: string;
+            };
+        };
+    };
+    required: string[];
+};
 /**
  * Build a skill extraction prompt
  */
@@ -266,4 +379,25 @@ export declare function buildDecompositionPrompt(content: string, options?: {
     context?: string;
     maxDepth?: number;
 }): string;
+/**
+ * Build a resource reference extraction prompt (Option 2)
+ */
+export declare function buildResourceReferencePrompt(content: string, skills: Array<{
+    id: string;
+    name: string;
+}>, options?: {
+    domain?: string;
+    context?: string;
+}): string;
+/**
+ * Build a deep resource analysis prompt (Option 3)
+ */
+export declare function buildDeepAnalysisPrompt(resourceContent: string, resourceName: string, existingSkills: Array<{
+    id: string;
+    name: string;
+    description: string;
+}>, options?: {
+    resourceType?: string;
+    context?: string;
+}): string;
 //# sourceMappingURL=prompts.d.ts.map

package/dist/types/llm/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/llm/prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMpD,eAAO,MAAM,cAAc;;;;;CAkG1B,CAAC;AAMF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuD7B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC/B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBjC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ChC,CAAC;AAMF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,EACF,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GACA,MAAM,CA2BR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAWvE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,MAAM,CA2BR"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/llm/prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMpD,eAAO,MAAM,cAAc;;;;;;;CA6I1B,CAAC;AAMF,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuD7B,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqC/B,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyBjC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ChC,CAAC;AAEF,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BrC,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuChC,CAAC;AAMF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,MAAM,CAiBR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,EACF,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GACA,MAAM,CA2BR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAWvE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,MAAM,CA2BR;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC3C,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,MAAM,CA8BR;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,EACxE,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,MAAM,CA6BR"}

package/dist/types/mcp/tools.d.ts

@@ -15,15 +15,15 @@ export declare const ListSkillsSchema: z.ZodObject<{
     bloomLevel: z.ZodOptional<z.ZodEnum<["remember", "understand", "apply", "analyze", "evaluate", "create"]>>;
     tag: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    limit: number;
     offset: number;
+    limit: number;
     bloomLevel?: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create" | undefined;
     tag?: string | undefined;
 }, {
     bloomLevel?: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create" | undefined;
+    offset?: number | undefined;
     limit?: number | undefined;
     tag?: string | undefined;
-    offset?: number | undefined;
 }>;
 export declare const GetSkillSchema: z.ZodObject<{
     skillId: z.ZodString;
@@ -55,8 +55,8 @@ export declare const SearchSkillsSchema: z.ZodObject<{
     query: z.ZodString;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
-    query: string;
     limit: number;
+    query: string;
 }, {
     query: string;
     limit?: number | undefined;
@@ -184,15 +184,15 @@ export declare const TOOL_DEFINITIONS: {
             bloomLevel: z.ZodOptional<z.ZodEnum<["remember", "understand", "apply", "analyze", "evaluate", "create"]>>;
             tag: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
-            limit: number;
             offset: number;
+            limit: number;
             bloomLevel?: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create" | undefined;
             tag?: string | undefined;
         }, {
             bloomLevel?: "remember" | "understand" | "apply" | "analyze" | "evaluate" | "create" | undefined;
+            offset?: number | undefined;
             limit?: number | undefined;
             tag?: string | undefined;
-            offset?: number | undefined;
         }>;
         readonly handler: typeof listSkills;
     };
@@ -236,8 +236,8 @@ export declare const TOOL_DEFINITIONS: {
             query: z.ZodString;
             limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         }, "strip", z.ZodTypeAny, {
-            query: string;
             limit: number;
+            query: string;
         }, {
             query: string;
             limit?: number | undefined;

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

@@ -41,6 +41,8 @@ export { generateId, nowISO, inputToSkillNode, inputToEdge, validateSkillInput,
 export { MemoryStorage } from './memory.js';
 export { LevelGraphStorage } from './levelgraph.js';
 export { Neo4jStorage } from './neo4j.js';
+export { Neo4jGraphRAGStorage, createNeo4jGraphRAGStorage, GRAPHRAG_DEFAULTS, } from './neo4j-graphrag.js';
+export { FRACTIONS_CURRICULUM, PROGRAMMING_CURRICULUM, seedStorage, } from './seeds.js';
 import type { StorageConfig, GraphStorage } from '../types/storage.js';
 /**
  * Create a storage adapter based on configuration.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAKH,YAAY,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,WAAW,CAAC;AAKnB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK1C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKvE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAWjE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAKH,YAAY,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAKrB,OAAO,EACL,UAAU,EACV,MAAM,EACN,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,GACf,MAAM,WAAW,CAAC;AAKnB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK1C,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,GACZ,MAAM,YAAY,CAAC;AAKpB,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAKvE;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAWjE"}

package/dist/types/storage/levelgraph.d.ts.map

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

package/dist/types/storage/neo4j-graphrag.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Neo4j GraphRAG Storage
+ *
+ * Extends Neo4jStorage with vector embedding and semantic search capabilities
+ * using Neo4j 5.x's native vector index support.
+ *
+ * @packageDocumentation
+ */
+import type { SkillId, GraphRAGStorage, EmbeddingAdapter, SkillWithEmbedding, VectorSearchResult, VectorSearchOptions, GraphRAGSearchResult, GraphRAGSearchOptions, GraphRAGContext, LearningPathRAGRequest, LearningPathRAGResult, SimilarityMetric } from '../types/index.js';
+import { Neo4jStorage } from './neo4j.js';
+/**
+ * Default GraphRAG configuration
+ */
+export declare const GRAPHRAG_DEFAULTS: {
+    /** Default limit for vector search results */
+    searchLimit: number;
+    /** Default minimum similarity score */
+    minScore: number;
+    /** Default graph traversal depth */
+    graphDepth: number;
+    /** Default weight for vector similarity in combined score */
+    vectorWeight: number;
+    /** Default similarity metric */
+    metric: SimilarityMetric;
+    /** Batch size for embedding operations */
+    embeddingBatchSize: number;
+};
+/**
+ * Neo4j GraphRAG Storage
+ *
+ * Provides vector embedding storage and semantic search using Neo4j 5.x
+ * native vector indexes combined with graph traversal for enhanced context.
+ *
+ * @example
+ * ```typescript
+ * import { Neo4jGraphRAGStorage, createOpenAIEmbeddingAdapter } from 'learngraph';
+ *
+ * const storage = new Neo4jGraphRAGStorage();
+ * await storage.connect({
+ *   backend: 'neo4j',
+ *   uri: 'bolt://localhost:7687',
+ *   username: 'neo4j',
+ *   password: 'password',
+ * });
+ *
+ * // Set embedding adapter
+ * const embedding = createOpenAIEmbeddingAdapter();
+ * storage.setEmbeddingAdapter(embedding);
+ *
+ * // Create vector index
+ * await storage.createVectorIndex({ dimensions: 1536 });
+ *
+ * // Embed all skills
+ * await storage.embedAllSkills();
+ *
+ * // Semantic search with graph context
+ * const results = await storage.searchWithGraphContext('learn JavaScript functions');
+ * ```
+ */
+export declare class Neo4jGraphRAGStorage extends Neo4jStorage implements GraphRAGStorage {
+    private embeddingAdapter;
+    private vectorIndexName;
+    private vectorIndexDimensions;
+    setEmbeddingAdapter(adapter: EmbeddingAdapter): void;
+    getEmbeddingAdapter(): EmbeddingAdapter | null;
+    private requireEmbeddingAdapter;
+    /**
+     * Generate text representation for embedding
+     */
+    private getEmbeddingText;
+    embedSkill(skillId: SkillId): Promise<void>;
+    embedAllSkills(options?: {
+        batchSize?: number;
+        onProgress?: (completed: number, total: number) => void;
+    }): Promise<{
+        embedded: number;
+        failed: number;
+    }>;
+    hasEmbedding(skillId: SkillId): Promise<boolean>;
+    getSkillWithEmbedding(skillId: SkillId): Promise<SkillWithEmbedding | null>;
+    searchByVector(query: string, options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    searchByEmbedding(embedding: number[], options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    findSimilarSkills(skillId: SkillId, options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
+    searchWithGraphContext(query: string, options?: GraphRAGSearchOptions): Promise<GraphRAGSearchResult[]>;
+    buildRAGContext(query: string, options?: GraphRAGSearchOptions): Promise<GraphRAGContext>;
+    private formatContextForLLM;
+    generateLearningPathRAG(request: LearningPathRAGRequest): Promise<LearningPathRAGResult>;
+    createVectorIndex(options?: {
+        dimensions?: number;
+        metric?: SimilarityMetric;
+    }): Promise<void>;
+    dropVectorIndex(): Promise<void>;
+    hasVectorIndex(): Promise<boolean>;
+    getVectorIndexStats(): Promise<{
+        exists: boolean;
+        dimensions?: number;
+        metric?: SimilarityMetric;
+        indexedCount: number;
+        totalSkills: number;
+    }>;
+}
+/**
+ * Create a Neo4j GraphRAG storage instance
+ */
+export declare function createNeo4jGraphRAGStorage(): Neo4jGraphRAGStorage;
+//# sourceMappingURL=neo4j-graphrag.d.ts.map

package/dist/types/storage/neo4j-graphrag.d.ts.map

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