ruvector 0.1.35 → 0.1.37

package/dist/core/sona-wrapper.js

@@ -1,258 +0,0 @@
-"use strict";
-/**
- * SONA Wrapper - Self-Optimizing Neural Architecture
- *
- * Provides a safe, flexible interface to @ruvector/sona with:
- * - Automatic array type conversion (Array <-> Float64Array)
- * - Graceful handling when sona is not installed
- * - TypeScript types for all APIs
- *
- * SONA Features:
- * - Micro-LoRA: Ultra-fast rank-1/2 adaptations (~0.1ms)
- * - Base-LoRA: Deeper adaptations for complex patterns
- * - EWC++: Elastic Weight Consolidation to prevent catastrophic forgetting
- * - ReasoningBank: Pattern storage and retrieval
- * - Trajectory tracking: Record and learn from execution paths
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Sona = exports.SonaEngine = void 0;
-exports.isSonaAvailable = isSonaAvailable;
-// ============================================================================
-// Helper Functions
-// ============================================================================
-/** Convert any array-like to regular Array (SONA expects number[]) */
-function toArray(input) {
-    if (Array.isArray(input))
-        return input;
-    return Array.from(input);
-}
-// ============================================================================
-// Lazy Loading
-// ============================================================================
-let sonaModule = null;
-let sonaLoadError = null;
-function getSonaModule() {
-    if (sonaModule)
-        return sonaModule;
-    if (sonaLoadError)
-        throw sonaLoadError;
-    try {
-        sonaModule = require('@ruvector/sona');
-        return sonaModule;
-    }
-    catch (e) {
-        sonaLoadError = new Error(`@ruvector/sona is not installed. Install it with:\n` +
-            `  npm install @ruvector/sona\n\n` +
-            `Original error: ${e.message}`);
-        throw sonaLoadError;
-    }
-}
-/** Check if sona is available */
-function isSonaAvailable() {
-    try {
-        getSonaModule();
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-// ============================================================================
-// SONA Engine Wrapper
-// ============================================================================
-/**
- * SONA Engine - Self-Optimizing Neural Architecture
- *
- * Provides runtime-adaptive learning with:
- * - Micro-LoRA for instant adaptations
- * - Base-LoRA for deeper learning
- * - EWC++ for preventing forgetting
- * - ReasoningBank for pattern storage
- *
- * @example
- * ```typescript
- * import { Sona } from 'ruvector';
- *
- * // Create engine with hidden dimension
- * const engine = new Sona.Engine(256);
- *
- * // Or with custom config
- * const engine = Sona.Engine.withConfig({
- *   hiddenDim: 256,
- *   microLoraRank: 2,
- *   patternClusters: 100
- * });
- *
- * // Record a trajectory
- * const trajId = engine.beginTrajectory([0.1, 0.2, ...]);
- * engine.addStep(trajId, activations, attentionWeights, 0.8);
- * engine.endTrajectory(trajId, 0.9);
- *
- * // Apply learned adaptations
- * const adapted = engine.applyMicroLora(input);
- * ```
- */
-class SonaEngine {
-    /**
-     * Create a new SONA engine
-     * @param hiddenDim Hidden dimension size (e.g., 256, 512, 768)
-     */
-    constructor(hiddenDim) {
-        const mod = getSonaModule();
-        this._native = new mod.SonaEngine(hiddenDim);
-    }
-    /**
-     * Create engine with custom configuration
-     * @param config SONA configuration options
-     */
-    static withConfig(config) {
-        const mod = getSonaModule();
-        const engine = new SonaEngine(config.hiddenDim);
-        // Replace native with configured version
-        engine._native = mod.SonaEngine.withConfig(config);
-        return engine;
-    }
-    // -------------------------------------------------------------------------
-    // Trajectory Recording
-    // -------------------------------------------------------------------------
-    /**
-     * Begin recording a new trajectory
-     * @param queryEmbedding Initial query embedding
-     * @returns Trajectory ID for subsequent operations
-     */
-    beginTrajectory(queryEmbedding) {
-        return this._native.beginTrajectory(toArray(queryEmbedding));
-    }
-    /**
-     * Add a step to an active trajectory
-     * @param trajectoryId Trajectory ID from beginTrajectory
-     * @param activations Layer activations
-     * @param attentionWeights Attention weights
-     * @param reward Reward signal for this step (0.0 - 1.0)
-     */
-    addStep(trajectoryId, activations, attentionWeights, reward) {
-        this._native.addTrajectoryStep(trajectoryId, toArray(activations), toArray(attentionWeights), reward);
-    }
-    /**
-     * Alias for addStep for API compatibility
-     */
-    addTrajectoryStep(trajectoryId, activations, attentionWeights, reward) {
-        this.addStep(trajectoryId, activations, attentionWeights, reward);
-    }
-    /**
-     * Set the model route for a trajectory
-     * @param trajectoryId Trajectory ID
-     * @param route Model route identifier (e.g., "gpt-4", "claude-3")
-     */
-    setRoute(trajectoryId, route) {
-        this._native.setTrajectoryRoute(trajectoryId, route);
-    }
-    /**
-     * Add context to a trajectory
-     * @param trajectoryId Trajectory ID
-     * @param contextId Context identifier
-     */
-    addContext(trajectoryId, contextId) {
-        this._native.addTrajectoryContext(trajectoryId, contextId);
-    }
-    /**
-     * Complete a trajectory and submit for learning
-     * @param trajectoryId Trajectory ID
-     * @param quality Final quality score (0.0 - 1.0)
-     */
-    endTrajectory(trajectoryId, quality) {
-        this._native.endTrajectory(trajectoryId, quality);
-    }
-    // -------------------------------------------------------------------------
-    // LoRA Transformations
-    // -------------------------------------------------------------------------
-    /**
-     * Apply micro-LoRA transformation (ultra-fast, ~0.1ms)
-     * @param input Input vector
-     * @returns Transformed output vector
-     */
-    applyMicroLora(input) {
-        return this._native.applyMicroLora(toArray(input));
-    }
-    /**
-     * Apply base-LoRA transformation to a specific layer
-     * @param layerIdx Layer index
-     * @param input Input vector
-     * @returns Transformed output vector
-     */
-    applyBaseLora(layerIdx, input) {
-        return this._native.applyBaseLora(layerIdx, toArray(input));
-    }
-    // -------------------------------------------------------------------------
-    // Learning Control
-    // -------------------------------------------------------------------------
-    /**
-     * Run background learning cycle if due
-     * Call this periodically (e.g., every few seconds)
-     * @returns Status message if learning occurred, null otherwise
-     */
-    tick() {
-        return this._native.tick();
-    }
-    /**
-     * Force immediate background learning cycle
-     * @returns Status message with learning results
-     */
-    forceLearn() {
-        return this._native.forceLearn();
-    }
-    /**
-     * Flush pending instant loop updates
-     */
-    flush() {
-        this._native.flush();
-    }
-    // -------------------------------------------------------------------------
-    // Pattern Retrieval
-    // -------------------------------------------------------------------------
-    /**
-     * Find similar learned patterns to a query
-     * @param queryEmbedding Query embedding
-     * @param k Number of patterns to return
-     * @returns Array of similar patterns
-     */
-    findPatterns(queryEmbedding, k) {
-        return this._native.findPatterns(toArray(queryEmbedding), k);
-    }
-    // -------------------------------------------------------------------------
-    // Engine Control
-    // -------------------------------------------------------------------------
-    /**
-     * Get engine statistics
-     * @returns Statistics object
-     */
-    getStats() {
-        const statsJson = this._native.getStats();
-        return JSON.parse(statsJson);
-    }
-    /**
-     * Enable or disable the engine
-     * @param enabled Whether to enable
-     */
-    setEnabled(enabled) {
-        this._native.setEnabled(enabled);
-    }
-    /**
-     * Check if engine is enabled
-     */
-    isEnabled() {
-        return this._native.isEnabled();
-    }
-}
-exports.SonaEngine = SonaEngine;
-// ============================================================================
-// Convenience Exports
-// ============================================================================
-/**
- * SONA namespace with all exports
- */
-exports.Sona = {
-    Engine: SonaEngine,
-    isAvailable: isSonaAvailable,
-};
-exports.default = exports.Sona;

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,SAAS,CAAC;AAGxB,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAE3B,QAAA,IAAI,cAAc,EAAE,GAAG,CAAC;AA0BxB;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,QAAQ,GAAG,MAAM,CAEzD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAMxE;AAED;;GAEG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,EAAE,CAAM;gBAEJ,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,GAAG,CAAA;KAAE;IAI5G;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IActH;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAUtI;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,CAAC;IAuB1N;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAW5G;;OAEG;IACG,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAI5B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAGlC;AAGD,eAAO,MAAM,QAAQ,wBAAkB,CAAC;AACxC,eAAO,MAAM,QAAQ,wBAAkB,CAAC;AAGxC,eAAO,MAAM,cAAc,KAA0B,CAAC;AAGtD,eAAe,cAAc,CAAC"}

package/dist/services/embedding-service.d.ts

@@ -1,136 +0,0 @@
-/**
- * Embedding Service - Unified embedding generation and management
- *
- * This service provides a unified interface for generating, caching, and
- * managing embeddings from various sources (local models, APIs, etc.)
- */
-/**
- * Embedding provider interface
- */
-export interface EmbeddingProvider {
-    /** Provider name */
-    name: string;
-    /** Generate embeddings for texts */
-    embed(texts: string[]): Promise<number[][]>;
-    /** Get embedding dimensions */
-    getDimensions(): number;
-}
-/**
- * Embedding service configuration
- */
-export interface EmbeddingServiceConfig {
-    /** Default provider to use */
-    defaultProvider?: string;
-    /** Maximum cache size */
-    maxCacheSize?: number;
-    /** Cache TTL in milliseconds */
-    cacheTtl?: number;
-    /** Batch size for embedding generation */
-    batchSize?: number;
-}
-/**
- * Mock embedding provider for testing
- */
-export declare class MockEmbeddingProvider implements EmbeddingProvider {
-    name: string;
-    private dimensions;
-    constructor(dimensions?: number);
-    embed(texts: string[]): Promise<number[][]>;
-    getDimensions(): number;
-}
-/**
- * Simple local embedding using character n-grams
- * This is a fallback when no external provider is available
- */
-export declare class LocalNGramProvider implements EmbeddingProvider {
-    name: string;
-    private dimensions;
-    private ngramSize;
-    constructor(dimensions?: number, ngramSize?: number);
-    embed(texts: string[]): Promise<number[][]>;
-    private embedSingle;
-    private hashNgram;
-    getDimensions(): number;
-}
-/**
- * Embedding service with caching and batching
- */
-export declare class EmbeddingService {
-    private providers;
-    private cache;
-    private config;
-    constructor(config?: EmbeddingServiceConfig);
-    /**
-     * Register an embedding provider
-     */
-    registerProvider(provider: EmbeddingProvider): void;
-    /**
-     * Get a registered provider
-     */
-    getProvider(name?: string): EmbeddingProvider;
-    /**
-     * Generate embeddings for texts with caching
-     *
-     * @param texts - Texts to embed
-     * @param provider - Provider name (uses default if not specified)
-     * @returns Array of embeddings
-     */
-    embed(texts: string[], provider?: string): Promise<number[][]>;
-    /**
-     * Generate a single embedding
-     */
-    embedOne(text: string, provider?: string): Promise<number[]>;
-    /**
-     * Add entry to cache with LRU eviction
-     */
-    private addToCache;
-    /**
-     * Compute cosine similarity between two embeddings
-     */
-    cosineSimilarity(a: number[], b: number[]): number;
-    /**
-     * Find most similar texts from a corpus
-     */
-    findSimilar(query: string, corpus: string[], k?: number, provider?: string): Promise<{
-        text: string;
-        similarity: number;
-        index: number;
-    }[]>;
-    /**
-     * Get cache statistics
-     */
-    getCacheStats(): {
-        size: number;
-        maxSize: number;
-        hitRate: number;
-    };
-    /**
-     * Clear the cache
-     */
-    clearCache(): void;
-    /**
-     * Get embedding dimensions for a provider
-     */
-    getDimensions(provider?: string): number;
-    /**
-     * List available providers
-     */
-    listProviders(): string[];
-}
-/**
- * Create an embedding service instance
- */
-export declare function createEmbeddingService(config?: EmbeddingServiceConfig): EmbeddingService;
-/**
- * Get the default embedding service instance
- */
-export declare function getDefaultEmbeddingService(): EmbeddingService;
-declare const _default: {
-    EmbeddingService: typeof EmbeddingService;
-    LocalNGramProvider: typeof LocalNGramProvider;
-    MockEmbeddingProvider: typeof MockEmbeddingProvider;
-    createEmbeddingService: typeof createEmbeddingService;
-    getDefaultEmbeddingService: typeof getDefaultEmbeddingService;
-};
-export default _default;
-//# sourceMappingURL=embedding-service.d.ts.map

package/dist/services/embedding-service.d.ts.map

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

package/dist/services/embedding-service.js

@@ -1,294 +0,0 @@
-"use strict";
-/**
- * Embedding Service - Unified embedding generation and management
- *
- * This service provides a unified interface for generating, caching, and
- * managing embeddings from various sources (local models, APIs, etc.)
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmbeddingService = exports.LocalNGramProvider = exports.MockEmbeddingProvider = void 0;
-exports.createEmbeddingService = createEmbeddingService;
-exports.getDefaultEmbeddingService = getDefaultEmbeddingService;
-/**
- * Simple hash function for cache keys
- */
-function hashText(text) {
-    let hash = 0;
-    for (let i = 0; i < text.length; i++) {
-        const char = text.charCodeAt(i);
-        hash = ((hash << 5) - hash) + char;
-        hash = hash & hash;
-    }
-    return `h${hash.toString(36)}`;
-}
-/**
- * Mock embedding provider for testing
- */
-class MockEmbeddingProvider {
-    constructor(dimensions = 384) {
-        this.name = 'mock';
-        this.dimensions = dimensions;
-    }
-    async embed(texts) {
-        return texts.map(text => {
-            // Generate deterministic pseudo-random embeddings based on text
-            const embedding = [];
-            let seed = 0;
-            for (let i = 0; i < text.length; i++) {
-                seed = ((seed << 5) - seed + text.charCodeAt(i)) | 0;
-            }
-            for (let i = 0; i < this.dimensions; i++) {
-                seed = (seed * 1103515245 + 12345) | 0;
-                embedding.push((seed % 1000) / 1000 - 0.5);
-            }
-            // Normalize
-            const norm = Math.sqrt(embedding.reduce((s, v) => s + v * v, 0));
-            return embedding.map(v => v / (norm || 1));
-        });
-    }
-    getDimensions() {
-        return this.dimensions;
-    }
-}
-exports.MockEmbeddingProvider = MockEmbeddingProvider;
-/**
- * Simple local embedding using character n-grams
- * This is a fallback when no external provider is available
- */
-class LocalNGramProvider {
-    constructor(dimensions = 256, ngramSize = 3) {
-        this.name = 'local-ngram';
-        this.dimensions = dimensions;
-        this.ngramSize = ngramSize;
-    }
-    async embed(texts) {
-        return texts.map(text => this.embedSingle(text));
-    }
-    embedSingle(text) {
-        const embedding = new Array(this.dimensions).fill(0);
-        const normalized = text.toLowerCase().replace(/[^a-z0-9]/g, ' ');
-        // Generate n-grams and hash them into embedding dimensions
-        for (let i = 0; i <= normalized.length - this.ngramSize; i++) {
-            const ngram = normalized.slice(i, i + this.ngramSize);
-            const hash = this.hashNgram(ngram);
-            const idx = Math.abs(hash) % this.dimensions;
-            embedding[idx] += hash > 0 ? 1 : -1;
-        }
-        // Normalize
-        const norm = Math.sqrt(embedding.reduce((s, v) => s + v * v, 0));
-        return embedding.map(v => v / (norm || 1));
-    }
-    hashNgram(ngram) {
-        let hash = 0;
-        for (let i = 0; i < ngram.length; i++) {
-            hash = ((hash << 5) - hash + ngram.charCodeAt(i)) | 0;
-        }
-        return hash;
-    }
-    getDimensions() {
-        return this.dimensions;
-    }
-}
-exports.LocalNGramProvider = LocalNGramProvider;
-/**
- * Embedding service with caching and batching
- */
-class EmbeddingService {
-    constructor(config = {}) {
-        this.providers = new Map();
-        this.cache = new Map();
-        this.config = {
-            defaultProvider: config.defaultProvider ?? 'local-ngram',
-            maxCacheSize: config.maxCacheSize ?? 10000,
-            cacheTtl: config.cacheTtl ?? 3600000, // 1 hour
-            batchSize: config.batchSize ?? 32,
-        };
-        // Register default providers
-        this.registerProvider(new LocalNGramProvider());
-        this.registerProvider(new MockEmbeddingProvider());
-    }
-    /**
-     * Register an embedding provider
-     */
-    registerProvider(provider) {
-        this.providers.set(provider.name, provider);
-    }
-    /**
-     * Get a registered provider
-     */
-    getProvider(name) {
-        const providerName = name ?? this.config.defaultProvider;
-        const provider = this.providers.get(providerName);
-        if (!provider) {
-            throw new Error(`Provider not found: ${providerName}`);
-        }
-        return provider;
-    }
-    /**
-     * Generate embeddings for texts with caching
-     *
-     * @param texts - Texts to embed
-     * @param provider - Provider name (uses default if not specified)
-     * @returns Array of embeddings
-     */
-    async embed(texts, provider) {
-        const providerInstance = this.getProvider(provider);
-        const providerName = providerInstance.name;
-        const now = Date.now();
-        // Check cache and collect texts that need embedding
-        const results = new Array(texts.length).fill(null);
-        const uncachedIndices = [];
-        const uncachedTexts = [];
-        for (let i = 0; i < texts.length; i++) {
-            const cacheKey = `${providerName}:${hashText(texts[i])}`;
-            const cached = this.cache.get(cacheKey);
-            if (cached && now - cached.timestamp < this.config.cacheTtl) {
-                results[i] = cached.embedding;
-                cached.hits++;
-            }
-            else {
-                uncachedIndices.push(i);
-                uncachedTexts.push(texts[i]);
-            }
-        }
-        // Generate embeddings for uncached texts in batches
-        if (uncachedTexts.length > 0) {
-            const batches = [];
-            for (let i = 0; i < uncachedTexts.length; i += this.config.batchSize) {
-                batches.push(uncachedTexts.slice(i, i + this.config.batchSize));
-            }
-            let batchOffset = 0;
-            for (const batch of batches) {
-                const embeddings = await providerInstance.embed(batch);
-                for (let j = 0; j < embeddings.length; j++) {
-                    const originalIndex = uncachedIndices[batchOffset + j];
-                    results[originalIndex] = embeddings[j];
-                    // Cache the result
-                    const cacheKey = `${providerName}:${hashText(texts[originalIndex])}`;
-                    this.addToCache(cacheKey, embeddings[j], now);
-                }
-                batchOffset += batch.length;
-            }
-        }
-        return results;
-    }
-    /**
-     * Generate a single embedding
-     */
-    async embedOne(text, provider) {
-        const results = await this.embed([text], provider);
-        return results[0];
-    }
-    /**
-     * Add entry to cache with LRU eviction
-     */
-    addToCache(key, embedding, timestamp) {
-        // Evict old entries if cache is full
-        if (this.cache.size >= this.config.maxCacheSize) {
-            // Find and remove least recently used entry
-            let oldestKey = '';
-            let oldestTime = Infinity;
-            let lowestHits = Infinity;
-            for (const [k, v] of this.cache.entries()) {
-                if (v.hits < lowestHits || (v.hits === lowestHits && v.timestamp < oldestTime)) {
-                    oldestKey = k;
-                    oldestTime = v.timestamp;
-                    lowestHits = v.hits;
-                }
-            }
-            if (oldestKey) {
-                this.cache.delete(oldestKey);
-            }
-        }
-        this.cache.set(key, { embedding, timestamp, hits: 0 });
-    }
-    /**
-     * Compute cosine similarity between two embeddings
-     */
-    cosineSimilarity(a, b) {
-        if (a.length !== b.length) {
-            throw new Error('Embeddings must have same dimensions');
-        }
-        let dotProduct = 0;
-        let normA = 0;
-        let normB = 0;
-        for (let i = 0; i < a.length; i++) {
-            dotProduct += a[i] * b[i];
-            normA += a[i] * a[i];
-            normB += b[i] * b[i];
-        }
-        const denom = Math.sqrt(normA) * Math.sqrt(normB);
-        return denom === 0 ? 0 : dotProduct / denom;
-    }
-    /**
-     * Find most similar texts from a corpus
-     */
-    async findSimilar(query, corpus, k = 5, provider) {
-        const [queryEmbed, ...corpusEmbeds] = await this.embed([query, ...corpus], provider);
-        const results = corpusEmbeds.map((embed, i) => ({
-            text: corpus[i],
-            similarity: this.cosineSimilarity(queryEmbed, embed),
-            index: i,
-        }));
-        return results
-            .sort((a, b) => b.similarity - a.similarity)
-            .slice(0, k);
-    }
-    /**
-     * Get cache statistics
-     */
-    getCacheStats() {
-        let totalHits = 0;
-        for (const entry of this.cache.values()) {
-            totalHits += entry.hits;
-        }
-        return {
-            size: this.cache.size,
-            maxSize: this.config.maxCacheSize,
-            hitRate: this.cache.size > 0 ? totalHits / this.cache.size : 0,
-        };
-    }
-    /**
-     * Clear the cache
-     */
-    clearCache() {
-        this.cache.clear();
-    }
-    /**
-     * Get embedding dimensions for a provider
-     */
-    getDimensions(provider) {
-        return this.getProvider(provider).getDimensions();
-    }
-    /**
-     * List available providers
-     */
-    listProviders() {
-        return Array.from(this.providers.keys());
-    }
-}
-exports.EmbeddingService = EmbeddingService;
-/**
- * Create an embedding service instance
- */
-function createEmbeddingService(config) {
-    return new EmbeddingService(config);
-}
-// Singleton instance
-let defaultService = null;
-/**
- * Get the default embedding service instance
- */
-function getDefaultEmbeddingService() {
-    if (!defaultService) {
-        defaultService = new EmbeddingService();
-    }
-    return defaultService;
-}
-exports.default = {
-    EmbeddingService,
-    LocalNGramProvider,
-    MockEmbeddingProvider,
-    createEmbeddingService,
-    getDefaultEmbeddingService,
-};