learngraph 0.7.0 → 0.8.0

package/dist/cjs/embeddings/base.js.map

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

package/dist/cjs/embeddings/index.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * Embedding Adapters
+ *
+ * This module provides embedding generation for GraphRAG functionality.
+ * Embeddings are used to enable semantic search across skills.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLocalEmbeddingAdapter = exports.LocalEmbeddingAdapter = exports.createOpenAIEmbeddingAdapter = exports.OpenAIEmbeddingAdapter = exports.DEFAULT_EMBEDDING_CONFIG = exports.EmbeddingError = exports.BaseEmbeddingAdapter = void 0;
+exports.createEmbeddingAdapter = createEmbeddingAdapter;
+exports.createEmbeddingAdapterFromEnv = createEmbeddingAdapterFromEnv;
+// Base classes and utilities
+var base_js_1 = require("./base.js");
+Object.defineProperty(exports, "BaseEmbeddingAdapter", { enumerable: true, get: function () { return base_js_1.BaseEmbeddingAdapter; } });
+Object.defineProperty(exports, "EmbeddingError", { enumerable: true, get: function () { return base_js_1.EmbeddingError; } });
+var base_js_2 = require("./base.js");
+Object.defineProperty(exports, "DEFAULT_EMBEDDING_CONFIG", { enumerable: true, get: function () { return base_js_2.DEFAULT_EMBEDDING_CONFIG; } });
+// OpenAI embeddings
+var openai_js_1 = require("./openai.js");
+Object.defineProperty(exports, "OpenAIEmbeddingAdapter", { enumerable: true, get: function () { return openai_js_1.OpenAIEmbeddingAdapter; } });
+Object.defineProperty(exports, "createOpenAIEmbeddingAdapter", { enumerable: true, get: function () { return openai_js_1.createOpenAIEmbeddingAdapter; } });
+// Local embeddings (no API required)
+var local_js_1 = require("./local.js");
+Object.defineProperty(exports, "LocalEmbeddingAdapter", { enumerable: true, get: function () { return local_js_1.LocalEmbeddingAdapter; } });
+Object.defineProperty(exports, "createLocalEmbeddingAdapter", { enumerable: true, get: function () { return local_js_1.createLocalEmbeddingAdapter; } });
+const openai_js_2 = require("./openai.js");
+const local_js_2 = require("./local.js");
+const base_js_3 = require("./base.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',
+ * });
+ * ```
+ */
+function createEmbeddingAdapter(config) {
+    switch (config.provider) {
+        case 'openai':
+            return new openai_js_2.OpenAIEmbeddingAdapter(config);
+        case 'local':
+            return new local_js_2.LocalEmbeddingAdapter(config);
+        case 'voyage':
+            throw new base_js_3.EmbeddingError('Voyage AI embeddings not yet implemented. Use OpenAI or local.', 'NOT_CONFIGURED', 'voyage');
+        case 'cohere':
+            throw new base_js_3.EmbeddingError('Cohere embeddings not yet implemented. Use OpenAI or local.', 'NOT_CONFIGURED', 'cohere');
+        default:
+            throw new base_js_3.EmbeddingError(`Unknown embedding provider: ${config.provider}`, 'NOT_CONFIGURED', 'local');
+    }
+}
+/**
+ * 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();
+ * ```
+ */
+function createEmbeddingAdapterFromEnv() {
+    // Check for OpenAI
+    const openaiKey = typeof process !== 'undefined' ? process.env.OPENAI_API_KEY : undefined;
+    if (openaiKey) {
+        return new openai_js_2.OpenAIEmbeddingAdapter({
+            provider: 'openai',
+            apiKey: openaiKey,
+            model: 'text-embedding-3-small',
+        });
+    }
+    // Fall back to local embeddings
+    console.warn('No embedding API keys found. Using local embeddings (lower quality).');
+    return new local_js_2.LocalEmbeddingAdapter({
+        provider: 'local',
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/embeddings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/embeddings/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAmDH,wDA6BC;AAcD,sEAgBC;AA5GD,6BAA6B;AAC7B,qCAAiE;AAAxD,+GAAA,oBAAoB,OAAA;AAAE,yGAAA,cAAc,OAAA;AAE7C,qCAAqD;AAA5C,mHAAA,wBAAwB,OAAA;AAEjC,oBAAoB;AACpB,yCAAmF;AAA1E,mHAAA,sBAAsB,OAAA;AAAE,yHAAA,4BAA4B,OAAA;AAE7D,qCAAqC;AACrC,uCAAgF;AAAvE,iHAAA,qBAAqB,OAAA;AAAE,uHAAA,2BAA2B,OAAA;AAkB3D,2CAAqD;AACrD,yCAAmD;AACnD,uCAA2C;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,sBAAsB,CAAC,MAAuB;IAC5D,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;QACxB,KAAK,QAAQ;YACX,OAAO,IAAI,kCAAsB,CAAC,MAAM,CAAC,CAAC;QAE5C,KAAK,OAAO;YACV,OAAO,IAAI,gCAAqB,CAAC,MAAM,CAAC,CAAC;QAE3C,KAAK,QAAQ;YACX,MAAM,IAAI,wBAAc,CACtB,gEAAgE,EAChE,gBAAgB,EAChB,QAAQ,CACT,CAAC;QAEJ,KAAK,QAAQ;YACX,MAAM,IAAI,wBAAc,CACtB,6DAA6D,EAC7D,gBAAgB,EAChB,QAAQ,CACT,CAAC;QAEJ;YACE,MAAM,IAAI,wBAAc,CACtB,+BAAgC,MAA0B,CAAC,QAAQ,EAAE,EACrE,gBAAgB,EAChB,OAAO,CACR,CAAC;IACN,CAAC;AACH,CAAC;AAED;;;;;;;;;;;GAWG;AACH,SAAgB,6BAA6B;IAC3C,mBAAmB;IACnB,MAAM,SAAS,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,IAAI,kCAAsB,CAAC;YAChC,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,wBAAwB;SAChC,CAAC,CAAC;IACL,CAAC;IAED,gCAAgC;IAChC,OAAO,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;IACrF,OAAO,IAAI,gCAAqB,CAAC;QAC/B,QAAQ,EAAE,OAAO;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/cjs/embeddings/local.js

@@ -0,0 +1,224 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalEmbeddingAdapter = void 0;
+exports.createLocalEmbeddingAdapter = createLocalEmbeddingAdapter;
+const base_js_1 = require("./base.js");
+/**
+ * Default dimensions for local embeddings
+ */
+const DEFAULT_LOCAL_DIMENSIONS = 384;
+/**
+ * Common English stop words to filter out
+ */
+const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'and', 'or', 'but', 'in', 'on', 'at', 'to', 'for',
+    'of', 'with', 'by', 'from', 'as', 'is', 'was', 'are', 'were', 'been',
+    'be', 'have', 'has', 'had', 'do', 'does', 'did', 'will', 'would',
+    'could', 'should', 'may', 'might', 'must', 'shall', 'can', 'need',
+    'dare', 'ought', 'used', 'this', 'that', 'these', 'those', 'i', 'you',
+    'he', 'she', 'it', 'we', 'they', 'what', 'which', 'who', 'whom',
+    'whose', 'where', 'when', 'why', 'how', 'all', 'each', 'every',
+    'both', 'few', 'more', 'most', 'other', 'some', 'such', 'no', 'nor',
+    'not', 'only', 'own', 'same', 'so', 'than', 'too', 'very', 'just',
+]);
+/**
+ * Simple hash function for consistent vector generation
+ */
+function hashCode(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    return hash;
+}
+/**
+ * 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.
+ */
+class LocalEmbeddingAdapter extends base_js_1.BaseEmbeddingAdapter {
+    modelName;
+    dims;
+    vocabulary = new Map();
+    idfScores = new Map();
+    documentCount = 0;
+    constructor(config) {
+        super(config);
+        this.modelName = config.model ?? 'local-tfidf';
+        this.dims = DEFAULT_LOCAL_DIMENSIONS;
+    }
+    get provider() {
+        return 'local';
+    }
+    get model() {
+        return this.modelName;
+    }
+    get dimensions() {
+        return this.dims;
+    }
+    isConfigured() {
+        return true; // Local adapter is always configured
+    }
+    /**
+     * Tokenize text into normalized tokens
+     */
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, ' ')
+            .split(/\s+/)
+            .filter((token) => token.length > 1 && !STOP_WORDS.has(token));
+    }
+    /**
+     * Calculate term frequency for a document
+     */
+    calculateTF(tokens) {
+        const tf = new Map();
+        const maxFreq = Math.max(...Array.from(tokens.reduce((acc, token) => {
+            acc.set(token, (acc.get(token) ?? 0) + 1);
+            return acc;
+        }, new Map()).values()), 1);
+        for (const token of tokens) {
+            const count = tokens.filter((t) => t === token).length;
+            tf.set(token, count / maxFreq);
+        }
+        return tf;
+    }
+    /**
+     * 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
+     */
+    generateEmbedding(text) {
+        const tokens = this.tokenize(text);
+        const vector = new Array(this.dims).fill(0);
+        if (tokens.length === 0) {
+            return this.normalizeVector(vector);
+        }
+        const tf = this.calculateTF(tokens);
+        // Generate embedding from tokens with positional encoding
+        for (let i = 0; i < tokens.length; i++) {
+            const token = tokens[i];
+            const baseHash = hashCode(token);
+            const positionWeight = 1 / (1 + Math.log(i + 1));
+            const tfWeight = tf.get(token) ?? 1;
+            // Distribute token influence across multiple dimensions
+            for (let j = 0; j < 8; j++) {
+                const dimIndex = Math.abs((baseHash + j * 7919) % this.dims);
+                const value = Math.sin(baseHash * (j + 1)) * tfWeight * positionWeight;
+                vector[dimIndex] += value;
+            }
+        }
+        // Add bigram features
+        for (let i = 0; i < tokens.length - 1; i++) {
+            const bigram = tokens[i] + '_' + tokens[i + 1];
+            const bigramHash = hashCode(bigram);
+            const dimIndex = Math.abs(bigramHash % this.dims);
+            vector[dimIndex] += 0.5 * Math.sin(bigramHash);
+        }
+        // Add character-level n-gram features for robustness
+        const charNgrams = this.getCharNgrams(text.toLowerCase(), 3);
+        for (const ngram of charNgrams) {
+            const ngramHash = hashCode(ngram);
+            const dimIndex = Math.abs(ngramHash % this.dims);
+            vector[dimIndex] += 0.1 * Math.sin(ngramHash);
+        }
+        return this.normalizeVector(vector);
+    }
+    /**
+     * Extract character n-grams from text
+     */
+    getCharNgrams(text, n) {
+        const ngrams = [];
+        const cleanText = text.replace(/\s+/g, ' ');
+        for (let i = 0; i <= cleanText.length - n; i++) {
+            ngrams.push(cleanText.substring(i, i + n));
+        }
+        return ngrams;
+    }
+    async embed(text) {
+        const vector = this.generateEmbedding(text);
+        return {
+            vector,
+            dimensions: this.dims,
+            model: this.modelName,
+        };
+    }
+    async embedBatch(texts) {
+        // Update document statistics for better IDF weighting
+        this.documentCount += texts.length;
+        const embeddings = await Promise.all(texts.map((text) => this.embed(text)));
+        return {
+            embeddings,
+        };
+    }
+    /**
+     * 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) {
+        const documentFreq = new Map();
+        this.documentCount = documents.length;
+        for (const doc of documents) {
+            const tokens = new Set(this.tokenize(doc));
+            for (const token of tokens) {
+                documentFreq.set(token, (documentFreq.get(token) ?? 0) + 1);
+            }
+        }
+        // Calculate IDF scores
+        for (const [token, freq] of documentFreq.entries()) {
+            const idf = Math.log(this.documentCount / (1 + freq)) + 1;
+            this.idfScores.set(token, idf);
+            this.vocabulary.set(token, this.vocabulary.size);
+        }
+    }
+    /**
+     * Get vocabulary size
+     */
+    getVocabularySize() {
+        return this.vocabulary.size;
+    }
+}
+exports.LocalEmbeddingAdapter = LocalEmbeddingAdapter;
+/**
+ * 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');
+ * ```
+ */
+function createLocalEmbeddingAdapter(model) {
+    const config = {
+        provider: 'local',
+        model,
+    };
+    return new LocalEmbeddingAdapter(config);
+}
+//# sourceMappingURL=local.js.map

package/dist/cjs/embeddings/local.js.map

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

package/dist/cjs/embeddings/openai.js

@@ -0,0 +1,169 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIEmbeddingAdapter = void 0;
+exports.createOpenAIEmbeddingAdapter = createOpenAIEmbeddingAdapter;
+const base_js_1 = require("./base.js");
+/**
+ * OpenAI embedding model dimensions
+ */
+const MODEL_DIMENSIONS = {
+    'text-embedding-3-small': 1536,
+    'text-embedding-3-large': 3072,
+    'text-embedding-ada-002': 1536,
+};
+/**
+ * OpenAI embedding adapter
+ */
+class OpenAIEmbeddingAdapter extends base_js_1.BaseEmbeddingAdapter {
+    apiKey;
+    baseUrl;
+    modelName;
+    dims;
+    constructor(config) {
+        super(config);
+        this.apiKey = config.apiKey;
+        this.baseUrl = 'https://api.openai.com/v1';
+        this.modelName = config.model ?? 'text-embedding-3-small';
+        // Handle custom dimensions for text-embedding-3-* models
+        if (config.dimensions && this.modelName.startsWith('text-embedding-3')) {
+            this.dims = config.dimensions;
+        }
+        else {
+            this.dims = MODEL_DIMENSIONS[this.modelName] ?? 1536;
+        }
+    }
+    get provider() {
+        return 'openai';
+    }
+    get model() {
+        return this.modelName;
+    }
+    get dimensions() {
+        return this.dims;
+    }
+    isConfigured() {
+        return !!this.apiKey;
+    }
+    async embed(text) {
+        const result = await this.embedBatch([text]);
+        const embedding = result.embeddings[0];
+        if (!embedding) {
+            throw new base_js_1.EmbeddingError('No embedding returned', 'INVALID_RESPONSE', this.provider);
+        }
+        return embedding;
+    }
+    async embedBatch(texts) {
+        if (!this.isConfigured()) {
+            throw new base_js_1.EmbeddingError('OpenAI embedding adapter not configured. Set apiKey in config.', 'NOT_CONFIGURED', this.provider);
+        }
+        if (texts.length === 0) {
+            return { embeddings: [], totalTokens: 0 };
+        }
+        return this.withRetry(async () => {
+            const headers = {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`,
+            };
+            const body = {
+                model: this.modelName,
+                input: texts,
+            };
+            // Add dimensions for text-embedding-3-* models with custom dimensions
+            const config = this.config;
+            if (config.dimensions && this.modelName.startsWith('text-embedding-3')) {
+                body.dimensions = config.dimensions;
+            }
+            const controller = new AbortController();
+            const timeout = setTimeout(() => controller.abort(), base_js_1.DEFAULT_EMBEDDING_CONFIG.timeout);
+            try {
+                const response = await fetch(`${this.baseUrl}/embeddings`, {
+                    method: 'POST',
+                    headers,
+                    body: JSON.stringify(body),
+                    signal: controller.signal,
+                });
+                clearTimeout(timeout);
+                if (!response.ok) {
+                    const errorData = (await response.json().catch(() => ({})));
+                    const errorMessage = errorData.error?.message ?? `HTTP ${response.status}`;
+                    if (response.status === 429) {
+                        throw new base_js_1.EmbeddingError(`Rate limit exceeded: ${errorMessage}`, 'RATE_LIMIT', this.provider);
+                    }
+                    throw new base_js_1.EmbeddingError(`OpenAI API error: ${errorMessage}`, 'API_ERROR', this.provider);
+                }
+                const data = (await response.json());
+                // Sort by index to ensure correct order
+                const sortedData = [...data.data].sort((a, b) => a.index - b.index);
+                const embeddings = sortedData.map((item) => ({
+                    vector: item.embedding,
+                    dimensions: item.embedding.length,
+                    model: data.model,
+                    usage: {
+                        promptTokens: Math.round(data.usage.prompt_tokens / texts.length),
+                        totalTokens: Math.round(data.usage.total_tokens / texts.length),
+                    },
+                }));
+                return {
+                    embeddings,
+                    totalTokens: data.usage.total_tokens,
+                };
+            }
+            catch (error) {
+                clearTimeout(timeout);
+                if (error instanceof base_js_1.EmbeddingError) {
+                    throw error;
+                }
+                if (error instanceof Error) {
+                    if (error.name === 'AbortError') {
+                        throw new base_js_1.EmbeddingError('Request timeout', 'TIMEOUT', this.provider, error);
+                    }
+                    throw new base_js_1.EmbeddingError(`Network error: ${error.message}`, 'NETWORK_ERROR', this.provider, error);
+                }
+                throw new base_js_1.EmbeddingError('Unknown error', 'API_ERROR', this.provider);
+            }
+        });
+    }
+}
+exports.OpenAIEmbeddingAdapter = OpenAIEmbeddingAdapter;
+/**
+ * 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);
+ * ```
+ */
+function createOpenAIEmbeddingAdapter(model = 'text-embedding-3-small', dimensions, apiKey) {
+    const key = apiKey ?? (typeof process !== 'undefined' ? process.env.OPENAI_API_KEY : undefined);
+    if (!key) {
+        throw new base_js_1.EmbeddingError('OpenAI API key not provided. Set OPENAI_API_KEY environment variable or pass apiKey.', 'NOT_CONFIGURED', 'openai');
+    }
+    const config = {
+        provider: 'openai',
+        apiKey: key,
+        model,
+        dimensions,
+    };
+    return new OpenAIEmbeddingAdapter(config);
+}
+//# sourceMappingURL=openai.js.map

package/dist/cjs/embeddings/openai.js.map

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

package/dist/cjs/index.js

@@ -42,7 +42,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PACKAGE_NAME = exports.VERSION = exports.TERMINATION_DEFAULTS = exports.ADAPTIVE_DEFAULTS = exports.createQuestionPool = exports.createAdaptiveEngine = exports.AdaptiveEngine = exports.MASTERY_ENGINE_DEFAULTS = exports.createMasteryEngine = exports.MasteryEngine = exports.IRT_CONFIG_DEFAULTS = exports.estimateAbility = exports.abilityToGradeLevel = exports.abilityToPercentile = exports.selectNextItemMFI = exports.calculateStandardError = exports.calculateTestInformation = exports.calculateInformation = exports.calculateProbabilityDerivative = exports.calculateProbability = exports.createIRTEstimator = exports.IRTEstimator = exports.BKT_CONFIG_DEFAULTS = exports.calculateLogLikelihood = exports.fitBKTParameters = exports.estimateMastery = exports.createBKTEngine = exports.BKTEngine = void 0;
+exports.PACKAGE_NAME = exports.VERSION = exports.GRAPHRAG_DEFAULTS = exports.createNeo4jGraphRAGStorage = exports.Neo4jGraphRAGStorage = exports.createEmbeddingAdapterFromEnv = exports.createEmbeddingAdapter = exports.createLocalEmbeddingAdapter = exports.LocalEmbeddingAdapter = exports.createOpenAIEmbeddingAdapter = exports.OpenAIEmbeddingAdapter = exports.DEFAULT_EMBEDDING_CONFIG = exports.EmbeddingError = exports.BaseEmbeddingAdapter = exports.TERMINATION_DEFAULTS = exports.ADAPTIVE_DEFAULTS = exports.createQuestionPool = exports.createAdaptiveEngine = exports.AdaptiveEngine = exports.MASTERY_ENGINE_DEFAULTS = exports.createMasteryEngine = exports.MasteryEngine = exports.IRT_CONFIG_DEFAULTS = exports.estimateAbility = exports.abilityToGradeLevel = exports.abilityToPercentile = exports.selectNextItemMFI = exports.calculateStandardError = exports.calculateTestInformation = exports.calculateInformation = exports.calculateProbabilityDerivative = exports.calculateProbability = exports.createIRTEstimator = exports.IRTEstimator = exports.BKT_CONFIG_DEFAULTS = exports.calculateLogLikelihood = exports.fitBKTParameters = exports.estimateMastery = exports.createBKTEngine = exports.BKTEngine = void 0;
 // ─────────────────────────────────────────────────────────────────────────────
 // Core Types
 // ─────────────────────────────────────────────────────────────────────────────
@@ -82,6 +82,30 @@ Object.defineProperty(exports, "createQuestionPool", { enumerable: true, get: fu
 Object.defineProperty(exports, "ADAPTIVE_DEFAULTS", { enumerable: true, get: function () { return index_js_1.ADAPTIVE_DEFAULTS; } });
 Object.defineProperty(exports, "TERMINATION_DEFAULTS", { enumerable: true, get: function () { return index_js_1.TERMINATION_DEFAULTS; } });
 // ─────────────────────────────────────────────────────────────────────────────
+// Embedding Adapters (for GraphRAG)
+// ─────────────────────────────────────────────────────────────────────────────
+var index_js_2 = require("./embeddings/index.js");
+// Base
+Object.defineProperty(exports, "BaseEmbeddingAdapter", { enumerable: true, get: function () { return index_js_2.BaseEmbeddingAdapter; } });
+Object.defineProperty(exports, "EmbeddingError", { enumerable: true, get: function () { return index_js_2.EmbeddingError; } });
+Object.defineProperty(exports, "DEFAULT_EMBEDDING_CONFIG", { enumerable: true, get: function () { return index_js_2.DEFAULT_EMBEDDING_CONFIG; } });
+// OpenAI
+Object.defineProperty(exports, "OpenAIEmbeddingAdapter", { enumerable: true, get: function () { return index_js_2.OpenAIEmbeddingAdapter; } });
+Object.defineProperty(exports, "createOpenAIEmbeddingAdapter", { enumerable: true, get: function () { return index_js_2.createOpenAIEmbeddingAdapter; } });
+// Local
+Object.defineProperty(exports, "LocalEmbeddingAdapter", { enumerable: true, get: function () { return index_js_2.LocalEmbeddingAdapter; } });
+Object.defineProperty(exports, "createLocalEmbeddingAdapter", { enumerable: true, get: function () { return index_js_2.createLocalEmbeddingAdapter; } });
+// Factory
+Object.defineProperty(exports, "createEmbeddingAdapter", { enumerable: true, get: function () { return index_js_2.createEmbeddingAdapter; } });
+Object.defineProperty(exports, "createEmbeddingAdapterFromEnv", { enumerable: true, get: function () { return index_js_2.createEmbeddingAdapterFromEnv; } });
+// ─────────────────────────────────────────────────────────────────────────────
+// GraphRAG Storage
+// ─────────────────────────────────────────────────────────────────────────────
+var neo4j_graphrag_js_1 = require("./storage/neo4j-graphrag.js");
+Object.defineProperty(exports, "Neo4jGraphRAGStorage", { enumerable: true, get: function () { return neo4j_graphrag_js_1.Neo4jGraphRAGStorage; } });
+Object.defineProperty(exports, "createNeo4jGraphRAGStorage", { enumerable: true, get: function () { return neo4j_graphrag_js_1.createNeo4jGraphRAGStorage; } });
+Object.defineProperty(exports, "GRAPHRAG_DEFAULTS", { enumerable: true, get: function () { return neo4j_graphrag_js_1.GRAPHRAG_DEFAULTS; } });
+// ─────────────────────────────────────────────────────────────────────────────
 // Package Metadata
 // ─────────────────────────────────────────────────────────────────────────────
 /**

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;;;;;;;;;;;;;;;AAEH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAChF,mDAAiC;AAEjC,gFAAgF;AAChF,6DAA6D;AAC7D,gFAAgF;AAChF,kDA+B+B;AA9B7B,MAAM;AACN,qGAAA,SAAS,OAAA;AACT,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,4GAAA,gBAAgB,OAAA;AAChB,kHAAA,sBAAsB,OAAA;AACtB,+GAAA,mBAAmB,OAAA;AACnB,MAAM;AACN,wGAAA,YAAY,OAAA;AACZ,8GAAA,kBAAkB,OAAA;AAClB,gHAAA,oBAAoB,OAAA;AACpB,0HAAA,8BAA8B,OAAA;AAC9B,gHAAA,oBAAoB,OAAA;AACpB,oHAAA,wBAAwB,OAAA;AACxB,kHAAA,sBAAsB,OAAA;AACtB,6GAAA,iBAAiB,OAAA;AACjB,+GAAA,mBAAmB,OAAA;AACnB,+GAAA,mBAAmB,OAAA;AACnB,2GAAA,eAAe,OAAA;AACf,+GAAA,mBAAmB,OAAA;AACnB,iBAAiB;AACjB,yGAAA,aAAa,OAAA;AACb,+GAAA,mBAAmB,OAAA;AACnB,mHAAA,uBAAuB,OAAA;AACvB,mBAAmB;AACnB,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA;AACpB,8GAAA,kBAAkB,OAAA;AAClB,6GAAA,iBAAiB,OAAA;AACjB,gHAAA,oBAAoB,OAAA;AAGtB,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACU,QAAA,OAAO,GAAG,OAAO,CAAC;AAE/B;;GAEG;AACU,QAAA,YAAY,GAAG,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;;;;;;;;;;;;;;;AAEH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAChF,mDAAiC;AAEjC,gFAAgF;AAChF,6DAA6D;AAC7D,gFAAgF;AAChF,kDA+B+B;AA9B7B,MAAM;AACN,qGAAA,SAAS,OAAA;AACT,2GAAA,eAAe,OAAA;AACf,2GAAA,eAAe,OAAA;AACf,4GAAA,gBAAgB,OAAA;AAChB,kHAAA,sBAAsB,OAAA;AACtB,+GAAA,mBAAmB,OAAA;AACnB,MAAM;AACN,wGAAA,YAAY,OAAA;AACZ,8GAAA,kBAAkB,OAAA;AAClB,gHAAA,oBAAoB,OAAA;AACpB,0HAAA,8BAA8B,OAAA;AAC9B,gHAAA,oBAAoB,OAAA;AACpB,oHAAA,wBAAwB,OAAA;AACxB,kHAAA,sBAAsB,OAAA;AACtB,6GAAA,iBAAiB,OAAA;AACjB,+GAAA,mBAAmB,OAAA;AACnB,+GAAA,mBAAmB,OAAA;AACnB,2GAAA,eAAe,OAAA;AACf,+GAAA,mBAAmB,OAAA;AACnB,iBAAiB;AACjB,yGAAA,aAAa,OAAA;AACb,+GAAA,mBAAmB,OAAA;AACnB,mHAAA,uBAAuB,OAAA;AACvB,mBAAmB;AACnB,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA;AACpB,8GAAA,kBAAkB,OAAA;AAClB,6GAAA,iBAAiB,OAAA;AACjB,gHAAA,oBAAoB,OAAA;AAGtB,gFAAgF;AAChF,oCAAoC;AACpC,gFAAgF;AAChF,kDAc+B;AAb7B,OAAO;AACP,gHAAA,oBAAoB,OAAA;AACpB,0GAAA,cAAc,OAAA;AACd,oHAAA,wBAAwB,OAAA;AACxB,SAAS;AACT,kHAAA,sBAAsB,OAAA;AACtB,wHAAA,4BAA4B,OAAA;AAC5B,QAAQ;AACR,iHAAA,qBAAqB,OAAA;AACrB,uHAAA,2BAA2B,OAAA;AAC3B,UAAU;AACV,kHAAA,sBAAsB,OAAA;AACtB,yHAAA,6BAA6B,OAAA;AAG/B,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAChF,iEAIqC;AAHnC,yHAAA,oBAAoB,OAAA;AACpB,+HAAA,0BAA0B,OAAA;AAC1B,sHAAA,iBAAiB,OAAA;AAGnB,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;GAEG;AACU,QAAA,OAAO,GAAG,OAAO,CAAC;AAE/B;;GAEG;AACU,QAAA,YAAY,GAAG,YAAY,CAAC"}