@sparkleideas/embeddings 3.0.0-alpha.12-patch.25 → 3.0.0-alpha.12-patch.27

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

@@ -0,0 +1 @@
+{"version":3,"file":"rvf-embedding-service.d.ts","sourceRoot":"","sources":["../src/rvf-embedding-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,iBAAiB,EAEjB,sBAAsB,EAEtB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAsFpB;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,YAAa,YAAW,iBAAiB;IAChF,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAS;IAE7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA0C;IAC7E,OAAO,CAAC,eAAe,CAAkC;gBAE7C,MAAM,EAAE,kBAAkB;IAuBtC;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IA4CnD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAyDhE,UAAU,IAAI,IAAI;IAMlB,aAAa;;;;;IASP,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAY/B,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAIxD,mBAAmB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAI3D,OAAO,CAAC,SAAS;IAejB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,qBAAqB;IAqC7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAM3B"}

package/dist/rvf-embedding-service.js

@@ -0,0 +1,318 @@
+/**
+ * RVF Embedding Service - Lightweight Hash-Based Embeddings
+ *
+ * Provides deterministic, sub-millisecond embedding generation using
+ * FNV-1a hash-based vectors. No neural model or external API required.
+ *
+ * Features:
+ * - Deterministic: same input always produces the same embedding
+ * - FNV-1a hash seeding with multi-round mixing
+ * - L2-normalized output vectors
+ * - Sub-millisecond generation (<0.1ms typical)
+ * - RvfEmbeddingCache for binary file persistence
+ * - Zero external dependencies
+ *
+ * Use cases:
+ * - Fast similarity search where relative distances matter more than semantics
+ * - Development and testing without API keys
+ * - Offline environments without neural model access
+ * - Bootstrapping before heavier providers are available
+ *
+ * @module @sparkleideas/embeddings
+ */
+import { EventEmitter } from 'events';
+import { normalize } from './normalization.js';
+import { RvfEmbeddingCache } from './rvf-embedding-cache.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** FNV-1a offset basis (32-bit) */
+const FNV_OFFSET_BASIS = 0x811c9dc5;
+/** FNV-1a prime (32-bit) */
+const FNV_PRIME = 0x01000193;
+/** Default embedding dimensions */
+const DEFAULT_DIMENSIONS = 384;
+/** Default in-memory LRU cache size */
+const DEFAULT_CACHE_SIZE = 1000;
+// ============================================================================
+// LRU Cache (lightweight in-memory)
+// ============================================================================
+class LRUCache {
+    maxSize;
+    cache = new Map();
+    hits = 0;
+    misses = 0;
+    constructor(maxSize) {
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            // Move to end (most recently used)
+            this.cache.delete(key);
+            this.cache.set(key, value);
+            this.hits++;
+            return value;
+        }
+        this.misses++;
+        return undefined;
+    }
+    set(key, value) {
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.maxSize) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(key, value);
+    }
+    clear() {
+        this.cache.clear();
+        this.hits = 0;
+        this.misses = 0;
+    }
+    get size() {
+        return this.cache.size;
+    }
+    get hitRate() {
+        const total = this.hits + this.misses;
+        return total > 0 ? this.hits / total : 0;
+    }
+    getStats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.maxSize,
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: this.hitRate,
+        };
+    }
+}
+// ============================================================================
+// RVF Embedding Service
+// ============================================================================
+/**
+ * Lightweight hash-based embedding service.
+ *
+ * Generates deterministic embeddings from text using FNV-1a hashing
+ * with multi-round mixing and L2 normalization. The output is a unit
+ * vector in R^n where n = configured dimensions (default 384).
+ *
+ * Extends EventEmitter and implements IEmbeddingService for drop-in
+ * compatibility with other providers.
+ */
+export class RvfEmbeddingService extends EventEmitter {
+    provider = 'rvf';
+    dimensions;
+    cache;
+    normalizationType;
+    embeddingListeners = new Set();
+    persistentCache = null;
+    constructor(config) {
+        super();
+        this.dimensions = config.dimensions ?? DEFAULT_DIMENSIONS;
+        if (this.dimensions <= 0 || !Number.isInteger(this.dimensions)) {
+            throw new Error(`Invalid dimensions: ${this.dimensions}. Must be a positive integer.`);
+        }
+        this.cache = new LRUCache(config.cacheSize ?? DEFAULT_CACHE_SIZE);
+        this.normalizationType = config.normalization ?? 'none';
+        // Initialize persistent RVF cache if a path is provided
+        if (config.cachePath) {
+            this.persistentCache = new RvfEmbeddingCache({
+                cachePath: config.cachePath,
+                maxSize: config.cacheSize ?? 10000,
+                dimensions: this.dimensions,
+            });
+        }
+    }
+    // --------------------------------------------------------------------------
+    // IEmbeddingService Implementation
+    // --------------------------------------------------------------------------
+    /**
+     * Generate an embedding for a single text string.
+     */
+    async embed(text) {
+        if (typeof text !== 'string') {
+            throw new Error('embed() expects a string argument');
+        }
+        // Check in-memory cache
+        const cached = this.cache.get(text);
+        if (cached) {
+            this.emitEvent({ type: 'cache_hit', text });
+            return { embedding: cached, latencyMs: 0, cached: true };
+        }
+        // Check persistent cache
+        if (this.persistentCache) {
+            const persisted = await this.persistentCache.get(text);
+            if (persisted) {
+                this.cache.set(text, persisted);
+                this.emitEvent({ type: 'cache_hit', text });
+                return { embedding: persisted, latencyMs: 0, cached: true, persistentCached: true };
+            }
+        }
+        this.emitEvent({ type: 'embed_start', text });
+        const startTime = performance.now();
+        // Generate deterministic embedding
+        const embedding = this.generateHashEmbedding(text);
+        // Apply optional normalization (hash embeddings are already L2-normalized,
+        // but the user may want a different normalization)
+        const normalized = this.applyNormalization(embedding);
+        // Store in caches
+        this.cache.set(text, normalized);
+        if (this.persistentCache) {
+            await this.persistentCache.set(text, normalized);
+        }
+        const latencyMs = performance.now() - startTime;
+        this.emitEvent({ type: 'embed_complete', text, latencyMs });
+        return { embedding: normalized, latencyMs };
+    }
+    /**
+     * Generate embeddings for multiple text strings.
+     */
+    async embedBatch(texts) {
+        if (!Array.isArray(texts)) {
+            throw new Error('embedBatch() expects an array of strings');
+        }
+        this.emitEvent({ type: 'batch_start', count: texts.length });
+        const startTime = performance.now();
+        const embeddings = [];
+        let cacheHits = 0;
+        for (const text of texts) {
+            const cached = this.cache.get(text);
+            if (cached) {
+                embeddings.push(cached);
+                cacheHits++;
+                this.emitEvent({ type: 'cache_hit', text });
+                continue;
+            }
+            // Check persistent cache
+            if (this.persistentCache) {
+                const persisted = await this.persistentCache.get(text);
+                if (persisted) {
+                    this.cache.set(text, persisted);
+                    embeddings.push(persisted);
+                    cacheHits++;
+                    this.emitEvent({ type: 'cache_hit', text });
+                    continue;
+                }
+            }
+            const embedding = this.generateHashEmbedding(text);
+            const normalized = this.applyNormalization(embedding);
+            this.cache.set(text, normalized);
+            if (this.persistentCache) {
+                await this.persistentCache.set(text, normalized);
+            }
+            embeddings.push(normalized);
+        }
+        const totalLatencyMs = performance.now() - startTime;
+        this.emitEvent({ type: 'batch_complete', count: texts.length, latencyMs: totalLatencyMs });
+        return {
+            embeddings,
+            totalLatencyMs,
+            avgLatencyMs: totalLatencyMs / texts.length,
+            cacheStats: {
+                hits: cacheHits,
+                misses: texts.length - cacheHits,
+            },
+        };
+    }
+    clearCache() {
+        const size = this.cache.size;
+        this.cache.clear();
+        this.emitEvent({ type: 'cache_eviction', size });
+    }
+    getCacheStats() {
+        const stats = this.cache.getStats();
+        return {
+            size: stats.size,
+            maxSize: stats.maxSize,
+            hitRate: stats.hitRate,
+        };
+    }
+    async shutdown() {
+        this.clearCache();
+        this.embeddingListeners.clear();
+        if (this.persistentCache) {
+            await this.persistentCache.close();
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Event System
+    // --------------------------------------------------------------------------
+    addEventListener(listener) {
+        this.embeddingListeners.add(listener);
+    }
+    removeEventListener(listener) {
+        this.embeddingListeners.delete(listener);
+    }
+    emitEvent(event) {
+        for (const listener of this.embeddingListeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error('Error in embedding event listener:', error);
+            }
+        }
+        this.emit(event.type, event);
+    }
+    // --------------------------------------------------------------------------
+    // Hash Embedding Generation
+    // --------------------------------------------------------------------------
+    /**
+     * Generate a deterministic embedding from text using FNV-1a hashing.
+     *
+     * Algorithm:
+     * 1. Compute a base FNV-1a hash of the full text.
+     * 2. For each dimension, derive a unique seed by mixing the base hash
+     *    with the dimension index using the golden ratio constant.
+     * 3. Apply a sine-based pseudo-random transform to spread values.
+     * 4. L2-normalize the result to produce a unit vector.
+     *
+     * This is deterministic: the same text always yields the same vector.
+     */
+    generateHashEmbedding(text) {
+        const embedding = new Float32Array(this.dimensions);
+        // Compute base FNV-1a hash of the full text
+        let baseHash = FNV_OFFSET_BASIS;
+        for (let i = 0; i < text.length; i++) {
+            baseHash ^= text.charCodeAt(i);
+            baseHash = Math.imul(baseHash, FNV_PRIME) >>> 0;
+        }
+        // Generate each dimension from a mixed seed
+        for (let i = 0; i < this.dimensions; i++) {
+            // Mix dimension index with the base hash using golden ratio constant
+            const seed = (baseHash + Math.imul(i, 0x9E3779B9)) >>> 0;
+            // Use sine for pseudo-random distribution in [-1, 1] range
+            const x = Math.sin(seed) * 43758.5453;
+            embedding[i] = x - Math.floor(x); // fractional part in [0, 1)
+            // Shift to [-0.5, 0.5) for zero-centered distribution
+            embedding[i] -= 0.5;
+        }
+        // L2 normalize to unit vector
+        let norm = 0;
+        for (let i = 0; i < this.dimensions; i++) {
+            norm += embedding[i] * embedding[i];
+        }
+        norm = Math.sqrt(norm);
+        if (norm > 0) {
+            for (let i = 0; i < this.dimensions; i++) {
+                embedding[i] /= norm;
+            }
+        }
+        return embedding;
+    }
+    /**
+     * Apply user-configured normalization if set.
+     */
+    applyNormalization(embedding) {
+        if (this.normalizationType === 'none') {
+            return embedding;
+        }
+        return normalize(embedding, { type: this.normalizationType });
+    }
+}
+//# sourceMappingURL=rvf-embedding-service.js.map

package/dist/rvf-embedding-service.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,237 @@
+/**
+ * V3 Embedding Service Types
+ *
+ * Type definitions for embedding service aligned with agentic-flow@alpha:
+ * - OpenAI provider
+ * - Transformers.js provider
+ * - Mock provider
+ *
+ * Performance Targets:
+ * - Single embedding: <100ms (API), <50ms (local)
+ * - Batch embedding: <500ms for 10 items
+ * - Cache hit: <1ms
+ */
+/**
+ * Supported embedding providers
+ */
+export type EmbeddingProvider = 'openai' | 'transformers' | 'mock' | 'agentic-flow' | 'rvf';
+/**
+ * Normalization type for embeddings
+ */
+export type NormalizationType = 'l2' | 'l1' | 'minmax' | 'zscore' | 'none';
+/**
+ * Persistent cache configuration
+ */
+export interface PersistentCacheConfig {
+    /** Enable persistent disk cache (requires better-sqlite3) */
+    enabled: boolean;
+    /** Path to SQLite database file (default: .cache/embeddings.db) */
+    dbPath?: string;
+    /** Maximum entries in persistent cache (default: 10000) */
+    maxSize?: number;
+    /** TTL in milliseconds (default: 7 days) */
+    ttlMs?: number;
+}
+/**
+ * Base configuration for all providers
+ */
+export interface EmbeddingBaseConfig {
+    /** Provider identifier */
+    provider: EmbeddingProvider;
+    /** Embedding dimensions */
+    dimensions?: number;
+    /** Cache size (number of embeddings) */
+    cacheSize?: number;
+    /** Enable caching */
+    enableCache?: boolean;
+    /** Normalization type (default: 'none' - most providers pre-normalize) */
+    normalization?: NormalizationType;
+    /** Persistent disk cache configuration */
+    persistentCache?: PersistentCacheConfig;
+}
+/**
+ * OpenAI provider configuration
+ */
+export interface OpenAIEmbeddingConfig extends EmbeddingBaseConfig {
+    provider: 'openai';
+    /** OpenAI API key */
+    apiKey: string;
+    /** Model to use */
+    model?: 'text-embedding-3-small' | 'text-embedding-3-large' | 'text-embedding-ada-002';
+    /** Target dimensions (for text-embedding-3-* models) */
+    dimensions?: number;
+    /** Base URL override */
+    baseURL?: string;
+    /** Request timeout in ms */
+    timeout?: number;
+    /** Max retries */
+    maxRetries?: number;
+}
+/**
+ * Transformers.js provider configuration
+ */
+export interface TransformersEmbeddingConfig extends EmbeddingBaseConfig {
+    provider: 'transformers';
+    /** Model name from Hugging Face */
+    model?: string;
+    /** Quantization level */
+    quantized?: boolean;
+    /** Use web worker */
+    useWorker?: boolean;
+}
+/**
+ * Mock provider configuration
+ */
+export interface MockEmbeddingConfig extends EmbeddingBaseConfig {
+    provider: 'mock';
+    /** Output dimensions */
+    dimensions?: number;
+    /** Simulated latency in ms */
+    simulatedLatency?: number;
+}
+/**
+ * Agentic-flow provider configuration
+ * Uses optimized ONNX embeddings with:
+ * - Float32Array with flattened matrices
+ * - 256-entry LRU cache with FNV-1a hash
+ * - SIMD-friendly loop unrolling (4x)
+ * - Pre-allocated buffers (no GC pressure)
+ */
+export interface AgenticFlowEmbeddingConfig extends EmbeddingBaseConfig {
+    provider: 'agentic-flow';
+    /** Model ID (default: all-MiniLM-L6-v2) */
+    modelId?: string;
+    /** Embedding dimensions (default: 384) */
+    dimensions?: number;
+    /** Internal cache size for embedder (default: 256) */
+    embedderCacheSize?: number;
+    /** Model directory path */
+    modelDir?: string;
+    /** Auto-download model if not present */
+    autoDownload?: boolean;
+}
+/**
+ * RVF provider configuration
+ * Lightweight hash-based embeddings (no neural model, sub-ms latency)
+ */
+export interface RvfEmbeddingConfig extends EmbeddingBaseConfig {
+    provider: 'rvf';
+    /** Embedding dimensions (default: 384) */
+    dimensions?: number;
+    /** Path to binary cache file for persistent storage */
+    cachePath?: string;
+    /** Similarity metric preference (default: 'cosine') */
+    metric?: 'cosine' | 'l2' | 'dotproduct';
+}
+/**
+ * Union of all provider configs
+ */
+export type EmbeddingConfig = OpenAIEmbeddingConfig | TransformersEmbeddingConfig | MockEmbeddingConfig | AgenticFlowEmbeddingConfig | RvfEmbeddingConfig;
+/**
+ * Single embedding result
+ */
+export interface EmbeddingResult {
+    /** The embedding vector */
+    embedding: Float32Array | number[];
+    /** Latency in milliseconds */
+    latencyMs: number;
+    /** Token usage (for API providers) */
+    usage?: {
+        promptTokens: number;
+        totalTokens: number;
+    };
+    /** Whether result was from cache */
+    cached?: boolean;
+    /** Whether result was from persistent cache */
+    persistentCached?: boolean;
+    /** Whether embedding was normalized */
+    normalized?: boolean;
+}
+/**
+ * Batch embedding result
+ */
+export interface BatchEmbeddingResult {
+    /** Array of embeddings */
+    embeddings: Array<Float32Array | number[]>;
+    /** Total latency in milliseconds */
+    totalLatencyMs: number;
+    /** Average latency per embedding */
+    avgLatencyMs: number;
+    /** Token usage (for API providers) */
+    usage?: {
+        promptTokens: number;
+        totalTokens: number;
+    };
+    /** Cache statistics */
+    cacheStats?: {
+        hits: number;
+        misses: number;
+    };
+}
+/**
+ * Embedding service interface
+ */
+export interface IEmbeddingService {
+    /** Provider identifier */
+    readonly provider: EmbeddingProvider;
+    /** Get embedding for single text */
+    embed(text: string): Promise<EmbeddingResult>;
+    /** Get embeddings for multiple texts */
+    embedBatch(texts: string[]): Promise<BatchEmbeddingResult>;
+    /** Clear cache */
+    clearCache(): void;
+    /** Get cache statistics */
+    getCacheStats(): {
+        size: number;
+        maxSize: number;
+        hitRate: number;
+    };
+    /** Shutdown service */
+    shutdown(): Promise<void>;
+}
+/**
+ * Embedding service events
+ */
+export type EmbeddingEvent = {
+    type: 'embed_start';
+    text: string;
+} | {
+    type: 'embed_complete';
+    text: string;
+    latencyMs: number;
+} | {
+    type: 'embed_error';
+    text: string;
+    error: string;
+} | {
+    type: 'batch_start';
+    count: number;
+} | {
+    type: 'batch_complete';
+    count: number;
+    latencyMs: number;
+} | {
+    type: 'cache_hit';
+    text: string;
+} | {
+    type: 'cache_eviction';
+    size: number;
+};
+/**
+ * Event listener type
+ */
+export type EmbeddingEventListener = (event: EmbeddingEvent) => void | Promise<void>;
+/**
+ * Similarity metric type
+ */
+export type SimilarityMetric = 'cosine' | 'euclidean' | 'dot';
+/**
+ * Similarity result
+ */
+export interface SimilarityResult {
+    /** Similarity score (0-1 for cosine, unbounded for others) */
+    score: number;
+    /** Metric used */
+    metric: SimilarityMetric;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,cAAc,GAAG,MAAM,GAAG,cAAc,GAAG,KAAK,CAAC;AAE5F;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,IAAI,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,QAAQ,EAAE,iBAAiB,CAAC;IAE5B,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,qBAAqB;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,0EAA0E;IAC1E,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAElC,0CAA0C;IAC1C,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,QAAQ,EAAE,QAAQ,CAAC;IAEnB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IAEf,mBAAmB;IACnB,KAAK,CAAC,EAAE,wBAAwB,GAAG,wBAAwB,GAAG,wBAAwB,CAAC;IAEvF,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,mBAAmB;IACtE,QAAQ,EAAE,cAAc,CAAC;IAEzB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yBAAyB;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,qBAAqB;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,QAAQ,EAAE,MAAM,CAAC;IAEjB,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8BAA8B;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,0BAA2B,SAAQ,mBAAmB;IACrE,QAAQ,EAAE,cAAc,CAAC;IAEzB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,QAAQ,EAAE,KAAK,CAAC;IAEhB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uDAAuD;IACvD,MAAM,CAAC,EAAE,QAAQ,GAAG,IAAI,GAAG,YAAY,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,qBAAqB,GACrB,2BAA2B,GAC3B,mBAAmB,GACnB,0BAA0B,GAC1B,kBAAkB,CAAC;AAMvB;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,SAAS,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;IAEnC,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,sCAAsC;IACtC,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,oCAAoC;IACpC,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,UAAU,EAAE,KAAK,CAAC,YAAY,GAAG,MAAM,EAAE,CAAC,CAAC;IAE3C,oCAAoC;IACpC,cAAc,EAAE,MAAM,CAAC;IAEvB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,uBAAuB;IACvB,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IAErC,oCAAoC;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE9C,wCAAwC;IACxC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAE3D,kBAAkB;IAClB,UAAU,IAAI,IAAI,CAAC;IAEnB,2BAA2B;IAC3B,aAAa,IAAI;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF,uBAAuB;IACvB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAMrF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,WAAW,GAAG,KAAK,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IAEd,kBAAkB;IAClB,MAAM,EAAE,gBAAgB,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,15 @@
+/**
+ * V3 Embedding Service Types
+ *
+ * Type definitions for embedding service aligned with agentic-flow@alpha:
+ * - OpenAI provider
+ * - Transformers.js provider
+ * - Mock provider
+ *
+ * Performance Targets:
+ * - Single embedding: <100ms (API), <50ms (local)
+ * - Batch embedding: <500ms for 10 items
+ * - Cache hit: <1ms
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sparkleideas/embeddings",
-  "version": "3.0.0-alpha.12-patch.25",
+  "version": "3.0.0-alpha.12-patch.27",
   "description": "V3 Embedding Service - OpenAI, Transformers.js, Agentic-Flow (ONNX), Mock providers with hyperbolic embeddings, normalization, and chunking",
   "type": "module",
   "main": "./dist/index.js",
@@ -48,8 +48,8 @@
     "vitest": "^4.0.16"
   },
   "peerDependencies": {
-    "@sparkleideas/shared": "3.0.0-alpha.6-patch.25",
-    "@sparkleideas/agentic-flow": "2.0.2-alpha-patch.17"
+    "@sparkleideas/shared": "3.0.0-alpha.6-patch.27",
+    "@sparkleideas/agentic-flow": "2.0.2-alpha-patch.19"
   },
   "peerDependenciesMeta": {
     "agentic-flow": {