learngraph 0.7.0 → 0.8.0

package/dist/types/embeddings/base.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Base adapter class for embedding providers
+ *
+ * @packageDocumentation
+ */
+import type { EmbeddingProvider, EmbeddingConfig, EmbeddingAdapter, EmbeddingResult, BatchEmbeddingResult } from '../types/graphrag.js';
+/**
+ * Embedding-related errors
+ */
+export declare class EmbeddingError extends Error {
+    readonly code: EmbeddingErrorCode;
+    readonly provider: EmbeddingProvider;
+    readonly cause?: Error | undefined;
+    constructor(message: string, code: EmbeddingErrorCode, provider: EmbeddingProvider, cause?: Error | undefined);
+}
+export type EmbeddingErrorCode = 'NOT_CONFIGURED' | 'API_ERROR' | 'RATE_LIMIT' | 'INVALID_RESPONSE' | 'TIMEOUT' | 'NETWORK_ERROR' | 'MODEL_NOT_FOUND';
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_EMBEDDING_CONFIG: {
+    timeout: number;
+    retries: number;
+    batchSize: number;
+};
+/**
+ * Abstract base class for embedding adapters
+ */
+export declare abstract class BaseEmbeddingAdapter implements EmbeddingAdapter {
+    protected config: EmbeddingConfig;
+    constructor(config: EmbeddingConfig);
+    abstract get provider(): EmbeddingProvider;
+    abstract get model(): string;
+    abstract get dimensions(): number;
+    abstract embed(text: string): Promise<EmbeddingResult>;
+    abstract embedBatch(texts: string[]): Promise<BatchEmbeddingResult>;
+    abstract isConfigured(): boolean;
+    getConfig(): Omit<EmbeddingConfig, 'apiKey'>;
+    /**
+     * Retry a function with exponential backoff
+     */
+    protected withRetry<T>(fn: () => Promise<T>, maxRetries?: number): Promise<T>;
+    /**
+     * Calculate cosine similarity between two vectors
+     */
+    protected cosineSimilarity(a: number[], b: number[]): number;
+    /**
+     * Normalize a vector to unit length
+     */
+    protected normalizeVector(vector: number[]): number[];
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/types/embeddings/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/embeddings/base.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,IAAI,EAAE,kBAAkB;aACxB,QAAQ,EAAE,iBAAiB;aAC3B,KAAK,CAAC,EAAE,KAAK;gBAH7B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,CAAC,EAAE,KAAK,YAAA;CAKhC;AAED,MAAM,MAAM,kBAAkB,GAC1B,gBAAgB,GAChB,WAAW,GACX,YAAY,GACZ,kBAAkB,GAClB,SAAS,GACT,eAAe,GACf,iBAAiB,CAAC;AAEtB;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;CAIpC,CAAC;AAEF;;GAEG;AACH,8BAAsB,oBAAqB,YAAW,gBAAgB;IACpE,SAAS,CAAC,MAAM,EAAE,eAAe,CAAC;gBAEtB,MAAM,EAAE,eAAe;IAInC,QAAQ,KAAK,QAAQ,IAAI,iBAAiB,CAAC;IAC3C,QAAQ,KAAK,KAAK,IAAI,MAAM,CAAC;IAC7B,QAAQ,KAAK,UAAU,IAAI,MAAM,CAAC;IAElC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IACtD,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAEnE,QAAQ,CAAC,YAAY,IAAI,OAAO;IAEhC,SAAS,IAAI,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC;IAQ5C;;OAEG;cACa,SAAS,CAAC,CAAC,EACzB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,UAAU,SAAmC,GAC5C,OAAO,CAAC,CAAC,CAAC;IA2Bb;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAoB5D;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;CAKtD"}

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

@@ -0,0 +1,48 @@
+/**
+ * Embedding Adapters
+ *
+ * This module provides embedding generation for GraphRAG functionality.
+ * Embeddings are used to enable semantic search across skills.
+ *
+ * @packageDocumentation
+ */
+export { BaseEmbeddingAdapter, EmbeddingError } from './base.js';
+export type { EmbeddingErrorCode } from './base.js';
+export { DEFAULT_EMBEDDING_CONFIG } from './base.js';
+export { OpenAIEmbeddingAdapter, createOpenAIEmbeddingAdapter } from './openai.js';
+export { LocalEmbeddingAdapter, createLocalEmbeddingAdapter } from './local.js';
+export type { EmbeddingProvider, EmbeddingConfig, EmbeddingConfigBase, OpenAIEmbeddingConfig, VoyageEmbeddingConfig, CohereEmbeddingConfig, LocalEmbeddingConfig, EmbeddingResult, BatchEmbeddingResult, EmbeddingAdapter, } from '../types/graphrag.js';
+import type { EmbeddingConfig, EmbeddingAdapter } from '../types/graphrag.js';
+/**
+ * Create an embedding adapter from configuration
+ *
+ * @example
+ * ```typescript
+ * // OpenAI embeddings
+ * const openai = createEmbeddingAdapter({
+ *   provider: 'openai',
+ *   apiKey: 'sk-...',
+ *   model: 'text-embedding-3-small',
+ * });
+ *
+ * // Local embeddings (no API key needed)
+ * const local = createEmbeddingAdapter({
+ *   provider: 'local',
+ * });
+ * ```
+ */
+export declare function createEmbeddingAdapter(config: EmbeddingConfig): EmbeddingAdapter;
+/**
+ * Create an embedding adapter from environment variables
+ *
+ * Automatically detects available API keys and creates the appropriate adapter.
+ * Falls back to local embeddings if no API keys are found.
+ *
+ * @example
+ * ```typescript
+ * // Will use OpenAI if OPENAI_API_KEY is set, otherwise local
+ * const adapter = createEmbeddingAdapterFromEnv();
+ * ```
+ */
+export declare function createEmbeddingAdapterFromEnv(): EmbeddingAdapter;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/embeddings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,EAAE,sBAAsB,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAGnF,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAGhF,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAK9E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CA6BhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,6BAA6B,IAAI,gBAAgB,CAgBhE"}

package/dist/types/embeddings/local.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Local embedding adapter
+ *
+ * Provides embedding generation without external API calls.
+ * Uses a simple but effective TF-IDF based approach for semantic similarity.
+ *
+ * For production use with better quality, consider using transformers.js
+ * with a model like 'Xenova/all-MiniLM-L6-v2'.
+ *
+ * @packageDocumentation
+ */
+import type { EmbeddingProvider, LocalEmbeddingConfig, EmbeddingResult, BatchEmbeddingResult } from '../types/graphrag.js';
+import { BaseEmbeddingAdapter } from './base.js';
+/**
+ * Local embedding adapter using TF-IDF-like approach
+ *
+ * This provides a simple, fast, offline embedding that works well for
+ * finding similar skills based on shared vocabulary and structure.
+ */
+export declare class LocalEmbeddingAdapter extends BaseEmbeddingAdapter {
+    private readonly modelName;
+    private readonly dims;
+    private vocabulary;
+    private idfScores;
+    private documentCount;
+    constructor(config: LocalEmbeddingConfig);
+    get provider(): EmbeddingProvider;
+    get model(): string;
+    get dimensions(): number;
+    isConfigured(): boolean;
+    /**
+     * Tokenize text into normalized tokens
+     */
+    private tokenize;
+    /**
+     * Calculate term frequency for a document
+     */
+    private calculateTF;
+    /**
+     * Generate a deterministic embedding vector from text
+     *
+     * Uses a combination of:
+     * 1. Token-based hashing for semantic representation
+     * 2. N-gram features for capturing word relationships
+     * 3. Positional encoding for word order sensitivity
+     */
+    private generateEmbedding;
+    /**
+     * Extract character n-grams from text
+     */
+    private getCharNgrams;
+    embed(text: string): Promise<EmbeddingResult>;
+    embedBatch(texts: string[]): Promise<BatchEmbeddingResult>;
+    /**
+     * Build vocabulary from a corpus for improved embeddings
+     *
+     * Call this with your skill names/descriptions to improve
+     * the quality of embeddings through proper IDF weighting.
+     */
+    buildVocabulary(documents: string[]): void;
+    /**
+     * Get vocabulary size
+     */
+    getVocabularySize(): number;
+}
+/**
+ * Create a local embedding adapter
+ *
+ * @example
+ * ```typescript
+ * // Create adapter
+ * const adapter = createLocalEmbeddingAdapter();
+ *
+ * // Optionally build vocabulary for better quality
+ * adapter.buildVocabulary(skillDescriptions);
+ *
+ * // Generate embedding
+ * const result = await adapter.embed('Learn to write JavaScript functions');
+ * ```
+ */
+export declare function createLocalEmbeddingAdapter(model?: string): LocalEmbeddingAdapter;
+//# sourceMappingURL=local.d.ts.map

package/dist/types/embeddings/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/embeddings/local.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAmCjD;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,oBAAoB;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,SAAS,CAAkC;IACnD,OAAO,CAAC,aAAa,CAAK;gBAEd,MAAM,EAAE,oBAAoB;IAMxC,IAAI,QAAQ,IAAI,iBAAiB,CAEhC;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAQhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBnB;;;;;;;OAOG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;OAEG;IACH,OAAO,CAAC,aAAa;IASf,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAU7C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAahE;;;;;OAKG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAmB1C;;OAEG;IACH,iBAAiB,IAAI,MAAM;CAG5B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,CAAC,EAAE,MAAM,GACb,qBAAqB,CAOvB"}

package/dist/types/embeddings/openai.d.ts

@@ -0,0 +1,48 @@
+/**
+ * OpenAI embedding adapter
+ *
+ * Supports OpenAI's text-embedding models including:
+ * - text-embedding-3-small (default, 1536 dims, cheapest)
+ * - text-embedding-3-large (3072 dims, highest quality)
+ * - text-embedding-ada-002 (legacy, 1536 dims)
+ *
+ * @packageDocumentation
+ */
+import type { EmbeddingProvider, OpenAIEmbeddingConfig, EmbeddingResult, BatchEmbeddingResult } from '../types/graphrag.js';
+import { BaseEmbeddingAdapter } from './base.js';
+/**
+ * OpenAI embedding adapter
+ */
+export declare class OpenAIEmbeddingAdapter extends BaseEmbeddingAdapter {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly modelName;
+    private readonly dims;
+    constructor(config: OpenAIEmbeddingConfig);
+    get provider(): EmbeddingProvider;
+    get model(): string;
+    get dimensions(): number;
+    isConfigured(): boolean;
+    embed(text: string): Promise<EmbeddingResult>;
+    embedBatch(texts: string[]): Promise<BatchEmbeddingResult>;
+}
+/**
+ * Create an OpenAI embedding adapter from environment variables
+ *
+ * @param model - Model to use (default: 'text-embedding-3-small')
+ * @param dimensions - Custom dimensions for text-embedding-3-* models
+ *
+ * @example
+ * ```typescript
+ * // Using default model (cheapest, good quality)
+ * const adapter = createOpenAIEmbeddingAdapter();
+ *
+ * // Using highest quality model
+ * const adapter = createOpenAIEmbeddingAdapter('text-embedding-3-large');
+ *
+ * // Using smaller dimensions for efficiency
+ * const adapter = createOpenAIEmbeddingAdapter('text-embedding-3-small', 512);
+ * ```
+ */
+export declare function createOpenAIEmbeddingAdapter(model?: 'text-embedding-3-small' | 'text-embedding-3-large' | 'text-embedding-ada-002', dimensions?: number, apiKey?: string): OpenAIEmbeddingAdapter;
+//# sourceMappingURL=openai.d.ts.map

package/dist/types/embeddings/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../../src/embeddings/openai.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,EACf,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,oBAAoB,EAA4C,MAAM,WAAW,CAAC;AAsC3F;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,oBAAoB;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;gBAElB,MAAM,EAAE,qBAAqB;IAczC,IAAI,QAAQ,IAAI,iBAAiB,CAEhC;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,YAAY,IAAI,OAAO;IAIjB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAS7C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA2GjE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,GAAE,wBAAwB,GAAG,wBAAwB,GAAG,wBAAmD,EAChH,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,sBAAsB,CAmBxB"}

package/dist/types/index.d.ts

@@ -28,6 +28,8 @@
  */
 export * from './types/index.js';
 export { BKTEngine, createBKTEngine, estimateMastery, fitBKTParameters, calculateLogLikelihood, BKT_CONFIG_DEFAULTS, IRTEstimator, createIRTEstimator, calculateProbability, calculateProbabilityDerivative, calculateInformation, calculateTestInformation, calculateStandardError, selectNextItemMFI, abilityToPercentile, abilityToGradeLevel, estimateAbility, IRT_CONFIG_DEFAULTS, MasteryEngine, createMasteryEngine, MASTERY_ENGINE_DEFAULTS, AdaptiveEngine, createAdaptiveEngine, createQuestionPool, ADAPTIVE_DEFAULTS, TERMINATION_DEFAULTS, } from './assessment/index.js';
+export { BaseEmbeddingAdapter, EmbeddingError, DEFAULT_EMBEDDING_CONFIG, OpenAIEmbeddingAdapter, createOpenAIEmbeddingAdapter, LocalEmbeddingAdapter, createLocalEmbeddingAdapter, createEmbeddingAdapter, createEmbeddingAdapterFromEnv, } from './embeddings/index.js';
+export { Neo4jGraphRAGStorage, createNeo4jGraphRAGStorage, GRAPHRAG_DEFAULTS, } from './storage/neo4j-graphrag.js';
 /**
  * Package version
  */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,cAAc,kBAAkB,CAAC;AAKjC,OAAO,EAEL,SAAS,EACT,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EAEnB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,8BAA8B,EAC9B,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EAEnB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EAEvB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAM/B;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,YAAY,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,cAAc,kBAAkB,CAAC;AAKjC,OAAO,EAEL,SAAS,EACT,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EAEnB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,8BAA8B,EAC9B,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EAEnB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EAEvB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EAEL,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EAExB,sBAAsB,EACtB,4BAA4B,EAE5B,qBAAqB,EACrB,2BAA2B,EAE3B,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAK/B,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAMrC;;GAEG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B;;GAEG;AACH,eAAO,MAAM,YAAY,eAAe,CAAC"}

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 { 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, buildExtractionPrompt, buildPrerequisitePrompt, buildBloomPrompt, buildDecompositionPrompt, } 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,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,cAAc,CAAC"}

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"}