@vinaes/succ 1.3.19

package/dist/lib/embedding-worker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Worker thread for embedding generation.
+ * Each worker loads its own native ORT session instance
+ * with single-threaded CPU for true parallelism across OS threads.
+ */
+export {};
+//# sourceMappingURL=embedding-worker.d.ts.map

package/dist/lib/embedding-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-worker.d.ts","sourceRoot":"","sources":["../../src/lib/embedding-worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/lib/embedding-worker.js

@@ -0,0 +1,49 @@
+/**
+ * Worker thread for embedding generation.
+ * Each worker loads its own native ORT session instance
+ * with single-threaded CPU for true parallelism across OS threads.
+ */
+import { parentPort } from 'worker_threads';
+import { NativeOrtSession } from './ort-session.js';
+import { DependencyError } from './errors.js';
+let session = null;
+async function initSession(model) {
+    session = new NativeOrtSession({
+        model,
+        providers: ['cpu'],
+        numThreads: 1, // Single-threaded per worker for true parallelism
+    });
+    await session.init();
+}
+if (parentPort) {
+    const port = parentPort;
+    port.on('message', async (msg) => {
+        try {
+            switch (msg.type) {
+                case 'init':
+                    await initSession(msg.model);
+                    port.postMessage({ type: 'ready' });
+                    break;
+                case 'embed': {
+                    if (!session)
+                        throw new DependencyError('Session not initialized');
+                    const embeddings = await session.embed(msg.texts || []);
+                    port.postMessage({ type: 'result', embeddings });
+                    break;
+                }
+                case 'shutdown':
+                    if (session) {
+                        await session.dispose();
+                        session = null;
+                    }
+                    process.exit(0);
+                    break;
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            port.postMessage({ type: 'error', error });
+        }
+    });
+}
+//# sourceMappingURL=embedding-worker.js.map

package/dist/lib/embedding-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-worker.js","sourceRoot":"","sources":["../../src/lib/embedding-worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,IAAI,OAAO,GAA4B,IAAI,CAAC;AAc5C,KAAK,UAAU,WAAW,CAAC,KAAa;IACtC,OAAO,GAAG,IAAI,gBAAgB,CAAC;QAC7B,KAAK;QACL,SAAS,EAAE,CAAC,KAAK,CAAC;QAClB,UAAU,EAAE,CAAC,EAAE,kDAAkD;KAClE,CAAC,CAAC;IACH,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,UAAU,EAAE,CAAC;IACf,MAAM,IAAI,GAAG,UAAU,CAAC;IAExB,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,GAAkB,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;gBACjB,KAAK,MAAM;oBACT,MAAM,WAAW,CAAC,GAAG,CAAC,KAAM,CAAC,CAAC;oBAC9B,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAoB,CAAC,CAAC;oBACtD,MAAM;gBAER,KAAK,OAAO,CAAC,CAAC,CAAC;oBACb,IAAI,CAAC,OAAO;wBAAE,MAAM,IAAI,eAAe,CAAC,yBAAyB,CAAC,CAAC;oBACnE,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;oBACxD,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAoB,CAAC,CAAC;oBACnE,MAAM;gBACR,CAAC;gBAED,KAAK,UAAU;oBACb,IAAI,OAAO,EAAE,CAAC;wBACZ,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;wBACxB,OAAO,GAAG,IAAI,CAAC;oBACjB,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAChB,MAAM;YACV,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/D,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAoB,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/embeddings.d.ts

@@ -0,0 +1,54 @@
+export interface EmbeddingResponse {
+    data: Array<{
+        embedding: number[];
+        index: number;
+    }>;
+    usage?: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+/**
+ * Cleanup embedding session and worker pool to free memory
+ */
+export declare function cleanupEmbeddings(): void;
+/**
+ * Get expected dimension for a model (or undefined if unknown)
+ */
+export declare function getModelDimension(model: string): number | undefined;
+/**
+ * Get the currently active backend (webgpu/cpu)
+ */
+export declare function getGpuBackend(): string | null;
+/**
+ * Check if embedding API endpoint is available
+ * Returns true if server responds, false otherwise
+ */
+export declare function checkApiHealth(): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/**
+ * Get embeddings (auto-selects based on llm.embeddings.mode)
+ * Modes: local (ONNX, default) | api (any OpenAI-compatible endpoint)
+ * Uses configOverride if set (for benchmarking)
+ */
+export declare function getEmbeddings(texts: string[]): Promise<number[][]>;
+/**
+ * Get embedding for a single text (with caching)
+ */
+export declare function getEmbedding(text: string): Promise<number[]>;
+/**
+ * Get info about current embedding configuration
+ */
+export declare function getEmbeddingInfo(): {
+    mode: string;
+    model: string;
+    dimensions: number | undefined;
+};
+/**
+ * Cosine similarity between two vectors.
+ * Returns 0 for zero-vectors to avoid division by zero.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/lib/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/lib/embeddings.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,CAAC;QACV,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAiCD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAsBxC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AA8KD;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,GAAG,IAAI,CAE7C;AA6ED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+C/E;AAqED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAUxE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAclE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC,CAQA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAmBjE"}

package/dist/lib/embeddings.js

@@ -0,0 +1,437 @@
+import { getConfig, getConfigWithOverride, getLLMTaskConfig, LOCAL_MODEL } from './config.js';
+import { createHash } from 'crypto';
+import { logWarn } from './fault-logger.js';
+import { NativeOrtSession } from './ort-session.js';
+import { detectExecutionProvider } from './ort-provider.js';
+import { NetworkError, ValidationError } from './errors.js';
+// Track which GPU backend is being used
+let gpuBackend = null;
+// Known model dimensions for validation
+const MODEL_DIMENSIONS = {
+    'Xenova/all-MiniLM-L6-v2': 384,
+    'Xenova/bge-small-en-v1.5': 384,
+    'Xenova/bge-base-en-v1.5': 768,
+    'Xenova/bge-large-en-v1.5': 1024,
+    'Xenova/multilingual-e5-large': 1024,
+    'openai/text-embedding-3-small': 1536,
+    'openai/text-embedding-3-large': 3072,
+    'openai/text-embedding-ada-002': 1536,
+    'qwen/qwen3-embedding-0.6b': 1024,
+    'qwen/qwen3-embedding-4b': 2560,
+    'qwen/qwen3-embedding-8b': 4096,
+    'baai/bge-m3': 1024,
+    'mistralai/mistral-embed-2312': 1024,
+    'mistralai/codestral-embed-2505': 3072,
+    'google/gemini-embedding-001': 3072,
+};
+// Default timeout for API requests (30 seconds)
+const API_TIMEOUT_MS = 30000;
+import { EmbeddingPool } from './embedding-pool.js';
+// Lazy-loaded native ORT session (replaces transformers.js WASM pipeline)
+let nativeSession = null;
+// Worker pool for parallel local embeddings (lazy init)
+let embeddingPool = null;
+let poolInitFailed = false; // Don't retry if pool init failed
+/**
+ * Cleanup embedding session and worker pool to free memory
+ */
+export function cleanupEmbeddings() {
+    if (nativeSession) {
+        nativeSession
+            .dispose()
+            .catch((err) => logWarn('embeddings', err instanceof Error ? err.message : 'Session dispose failed'));
+        nativeSession = null;
+        embeddingCache.clear();
+        // Hint GC if available
+        if (global.gc) {
+            global.gc();
+        }
+    }
+    if (embeddingPool) {
+        embeddingPool
+            .shutdown()
+            .catch((err) => logWarn('embeddings', err instanceof Error ? err.message : 'Pool shutdown failed'));
+        embeddingPool = null;
+    }
+}
+/**
+ * Get expected dimension for a model (or undefined if unknown)
+ */
+export function getModelDimension(model) {
+    return MODEL_DIMENSIONS[model];
+}
+/**
+ * Validate embedding dimension matches expected model dimension.
+ * If configDimensions is set (MRL override), use that instead of model native dims.
+ */
+function validateEmbedding(embedding, model, configDimensions) {
+    const expectedDim = configDimensions ?? MODEL_DIMENSIONS[model];
+    if (expectedDim && embedding.length !== expectedDim) {
+        throw new ValidationError(`Embedding dimension mismatch: expected ${expectedDim} for ${model}, got ${embedding.length}`);
+    }
+    // Check for NaN/Infinity
+    if (embedding.some((v) => !isFinite(v))) {
+        throw new ValidationError('Embedding contains NaN or Infinity values');
+    }
+}
+/**
+ * Fetch with timeout
+ */
+async function fetchWithTimeout(url, options, timeoutMs = API_TIMEOUT_MS) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, {
+            ...options,
+            signal: controller.signal,
+        });
+        return response;
+    }
+    catch (error) {
+        if (error.name === 'AbortError') {
+            throw new NetworkError(`Request timeout after ${timeoutMs}ms`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+// Simple LRU cache for embeddings (size configurable via embedding_cache_size)
+let cacheMaxSize = null;
+const embeddingCache = new Map();
+function getCacheMaxSize() {
+    if (cacheMaxSize === null) {
+        cacheMaxSize = getConfig().embedding_cache_size ?? 500;
+    }
+    return cacheMaxSize;
+}
+/**
+ * Generate a cache key using full SHA-256 hash to prevent collisions
+ */
+function getCacheKey(text, mode, model) {
+    const textHash = createHash('sha256').update(text).digest('hex');
+    return `${mode}:${model}:${textHash}`;
+}
+function cacheGet(key) {
+    const value = embeddingCache.get(key);
+    if (value) {
+        // Move to end (most recently used)
+        embeddingCache.delete(key);
+        embeddingCache.set(key, value);
+    }
+    return value;
+}
+function cacheSet(key, value) {
+    // Evict oldest if at capacity
+    if (embeddingCache.size >= getCacheMaxSize()) {
+        const firstKey = embeddingCache.keys().next().value;
+        if (firstKey)
+            embeddingCache.delete(firstKey);
+    }
+    embeddingCache.set(key, value);
+}
+/**
+ * Retry wrapper with exponential backoff
+ */
+async function withRetry(fn, options = {}) {
+    const { retries = 3, baseDelay = 1000, maxDelay = 10000 } = options;
+    let lastError = null;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry on client errors (4xx except 429)
+            if (error.message?.includes('API error: 4') && !error.message?.includes('429')) {
+                throw error;
+            }
+            if (attempt < retries) {
+                const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
+                logWarn('embeddings', `Retry attempt ${attempt + 1}/${retries} after ${delay}ms delay`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+    }
+    throw lastError;
+}
+/**
+ * Get the resolved embedding model name.
+ * Reads from llm.embeddings.model → LOCAL_MODEL for local mode.
+ */
+function getEmbeddingModel() {
+    const taskCfg = getLLMTaskConfig('embeddings');
+    return taskCfg.model || LOCAL_MODEL;
+}
+/**
+ * Get native ORT session (lazy loaded)
+ * Auto-detects GPU provider per platform: DirectML (Windows), CoreML (macOS arm64),
+ * CUDA (Linux), CPU (all). Uses onnxruntime-node for 4-17x speedup over WASM.
+ */
+async function getNativeSession() {
+    if (!nativeSession) {
+        const config = getConfigWithOverride();
+        const embeddingModel = getEmbeddingModel();
+        const providerResult = detectExecutionProvider(process.platform, {
+            gpu_enabled: config.gpu_enabled,
+            gpu_device: config.gpu_device,
+            arch: process.arch,
+        });
+        if (providerResult.warning) {
+            logWarn('embeddings', providerResult.warning);
+        }
+        gpuBackend = providerResult.provider;
+        console.log(`Loading native ORT session: ${embeddingModel} ` +
+            `(${providerResult.provider}, fallback: ${providerResult.fallbackChain.slice(1).join(' → ') || 'none'})...`);
+        nativeSession = new NativeOrtSession({
+            model: embeddingModel,
+            providers: providerResult.fallbackChain,
+        });
+        try {
+            await nativeSession.init();
+            gpuBackend = nativeSession.provider;
+            console.log(`Model loaded (${nativeSession.provider}).`);
+        }
+        catch (error) {
+            nativeSession = null;
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to load embedding model '${embeddingModel}'. ` +
+                `This may be due to network issues, disk space, or invalid model name. ` +
+                `Error: ${message}`);
+        }
+    }
+    return nativeSession;
+}
+/**
+ * Get the currently active backend (webgpu/cpu)
+ */
+export function getGpuBackend() {
+    return gpuBackend;
+}
+/**
+ * Try to use worker pool for large embedding batches.
+ * Returns null if pool is unavailable or disabled.
+ */
+async function tryPoolEmbeddings(texts, config) {
+    if (poolInitFailed)
+        return null;
+    if (config.embedding_worker_pool_enabled === false)
+        return null;
+    // Only use pool for batches large enough to benefit from parallelism
+    if (texts.length < 8)
+        return null;
+    try {
+        if (!embeddingPool) {
+            const poolSize = config.embedding_worker_pool_size ?? undefined;
+            const maxWorkers = config.embedding_worker_pool_max ?? 8;
+            embeddingPool = new EmbeddingPool({ poolSize, maxWorkers, model: getEmbeddingModel() });
+            console.log(`Initializing embedding worker pool (${embeddingPool.size} workers)...`);
+            await embeddingPool.init();
+            console.log('Worker pool ready.');
+        }
+        return await embeddingPool.getEmbeddings(texts);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logWarn('embeddings', `Worker pool failed, falling back to single-threaded: ${msg}`);
+        poolInitFailed = true;
+        if (embeddingPool) {
+            embeddingPool
+                .shutdown()
+                .catch((err) => logWarn('embeddings', err instanceof Error ? err.message : 'Pool cleanup failed'));
+            embeddingPool = null;
+        }
+        return null;
+    }
+}
+/**
+ * Get embeddings using local native ORT model (batch optimized)
+ * For large batches (32+), uses worker thread pool for true CPU parallelism.
+ * Native ORT workers are single-threaded — pool provides real parallel scaling.
+ * Falls back to main session for small batches or if pool unavailable.
+ */
+async function getLocalEmbeddings(texts) {
+    const config = getConfigWithOverride();
+    // Try worker pool for large batches
+    const poolResult = await tryPoolEmbeddings(texts, config);
+    if (poolResult) {
+        for (const embedding of poolResult) {
+            validateEmbedding(embedding, getEmbeddingModel());
+        }
+        return poolResult;
+    }
+    const session = await getNativeSession();
+    // Native ORT session handles batching internally
+    const BATCH_SIZE = config.embedding_local_batch_size ?? 64;
+    const results = [];
+    for (let i = 0; i < texts.length; i += BATCH_SIZE) {
+        const batch = texts.slice(i, i + BATCH_SIZE);
+        const embeddings = await session.embed(batch);
+        results.push(...embeddings);
+    }
+    // Validate all embeddings
+    for (const embedding of results) {
+        validateEmbedding(embedding, getEmbeddingModel());
+    }
+    return results;
+}
+/**
+ * Check if embedding API endpoint is available
+ * Returns true if server responds, false otherwise
+ */
+export async function checkApiHealth() {
+    const taskCfg = getLLMTaskConfig('embeddings');
+    const apiUrl = taskCfg.api_url;
+    try {
+        // Try to get the base URL (without /embeddings) for health check
+        const baseUrl = apiUrl.replace(/\/embeddings\/?$/, '');
+        const healthUrl = `${baseUrl}/health`;
+        const response = await fetchWithTimeout(healthUrl, { method: 'GET' }, 5000);
+        if (response.ok) {
+            return { ok: true };
+        }
+        // Some servers don't have /health, try a minimal embedding request
+        const headers = { 'Content-Type': 'application/json' };
+        if (taskCfg.api_key) {
+            headers['Authorization'] = `Bearer ${taskCfg.api_key}`;
+        }
+        // Auto-add OpenRouter headers when URL contains openrouter.ai
+        if (apiUrl.includes('openrouter.ai')) {
+            headers['HTTP-Referer'] = 'https://github.com/vinaes/succ';
+            headers['X-Title'] = 'succ';
+        }
+        const testResponse = await fetchWithTimeout(apiUrl, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                model: taskCfg.model,
+                input: ['test'],
+            }),
+        }, 10000);
+        if (testResponse.ok) {
+            return { ok: true };
+        }
+        return { ok: false, error: `Server returned ${testResponse.status}` };
+    }
+    catch (error) {
+        return { ok: false, error: error.message || 'Connection failed' };
+    }
+}
+/**
+ * Get embeddings from API endpoint (OpenRouter, Ollama, llama.cpp, LM Studio, etc.)
+ * Expects OpenAI-compatible /v1/embeddings endpoint (with retry and timeout)
+ * Supports batching (default 32, configurable via llm.embeddings.batch_size)
+ */
+async function getApiEmbeddings(texts) {
+    const taskCfg = getLLMTaskConfig('embeddings');
+    const apiUrl = taskCfg.api_url;
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    // Add API key if provided
+    if (taskCfg.api_key) {
+        headers['Authorization'] = `Bearer ${taskCfg.api_key}`;
+    }
+    // Auto-add OpenRouter headers when URL contains openrouter.ai
+    if (apiUrl.includes('openrouter.ai')) {
+        headers['HTTP-Referer'] = 'https://github.com/vinaes/succ';
+        headers['X-Title'] = 'succ';
+    }
+    const config = getConfigWithOverride();
+    const batchSize = taskCfg.batch_size ?? config.llm?.embeddings?.batch_size ?? 32;
+    const expectedDimensions = config.llm?.embeddings?.dimensions;
+    // Process in batches
+    const results = [];
+    for (let i = 0; i < texts.length; i += batchSize) {
+        const batch = texts.slice(i, i + batchSize);
+        const batchEmbeddings = await withRetry(async () => {
+            const response = await fetchWithTimeout(apiUrl, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({
+                    model: taskCfg.model,
+                    input: batch,
+                    ...(expectedDimensions ? { dimensions: expectedDimensions } : {}),
+                }),
+            });
+            if (!response.ok) {
+                const error = await response.text();
+                throw new NetworkError(`Embedding API error: ${response.status} - ${error}`, response.status);
+            }
+            const data = (await response.json());
+            return data.data.map((d) => d.embedding);
+        });
+        // Validate embeddings (configDimensions overrides model native dims for MRL)
+        for (const embedding of batchEmbeddings) {
+            validateEmbedding(embedding, getEmbeddingModel(), expectedDimensions);
+        }
+        results.push(...batchEmbeddings);
+    }
+    return results;
+}
+/**
+ * Get embeddings (auto-selects based on llm.embeddings.mode)
+ * Modes: local (ONNX, default) | api (any OpenAI-compatible endpoint)
+ * Uses configOverride if set (for benchmarking)
+ */
+export async function getEmbeddings(texts) {
+    const taskCfg = getLLMTaskConfig('embeddings');
+    switch (taskCfg.mode) {
+        case 'api':
+            return getApiEmbeddings(texts);
+        case 'local':
+        default:
+            return getLocalEmbeddings(texts);
+    }
+}
+/**
+ * Get embedding for a single text (with caching)
+ */
+export async function getEmbedding(text) {
+    const taskCfg = getLLMTaskConfig('embeddings');
+    const cacheKey = getCacheKey(text, taskCfg.mode, taskCfg.model);
+    // Check cache first
+    const cached = cacheGet(cacheKey);
+    if (cached)
+        return cached;
+    // Compute and cache
+    const embeddings = await getEmbeddings([text]);
+    const result = embeddings[0];
+    cacheSet(cacheKey, result);
+    return result;
+}
+/**
+ * Get info about current embedding configuration
+ */
+export function getEmbeddingInfo() {
+    const taskCfg = getLLMTaskConfig('embeddings');
+    const config = getConfigWithOverride();
+    return {
+        mode: taskCfg.mode,
+        model: taskCfg.model,
+        dimensions: config.llm?.embeddings?.dimensions ?? getModelDimension(taskCfg.model),
+    };
+}
+/**
+ * Cosine similarity between two vectors.
+ * Returns 0 for zero-vectors to avoid division by zero.
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new ValidationError('Vectors must have same length');
+    }
+    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 denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0)
+        return 0;
+    return dotProduct / denominator;
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/lib/embeddings.js.map

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

package/dist/lib/errors.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Custom error hierarchy for succ.
+ *
+ * Provides programmatic error discrimination without parsing message strings.
+ * Each subclass carries a `code` string for structured error handling.
+ */
+/** Base error for all succ errors. Carries a `code` and optional `context`. */
+export declare class SuccError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, code?: string, context?: Record<string, unknown>);
+}
+/** Configuration errors: invalid config values, missing required settings. */
+export declare class ConfigError extends SuccError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Storage/database errors: connection failures, query errors, constraint violations. */
+export declare class StorageError extends SuccError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Validation errors: bad input, precondition failures, argument checks. */
+export declare class ValidationError extends SuccError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Network/API errors: HTTP failures, timeouts, API response errors. */
+export declare class NetworkError extends SuccError {
+    readonly statusCode?: number;
+    constructor(message: string, statusCode?: number, context?: Record<string, unknown>);
+}
+/** Resource not found: files, PRDs, sessions, memories. */
+export declare class NotFoundError extends SuccError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Dependency errors: missing optional deps, runtime init failures. */
+export declare class DependencyError extends SuccError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Type guard: check if an error is a SuccError or subclass. */
+export declare function isSuccError(error: unknown): error is SuccError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE/B,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAqB,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAM5F;AAED,8EAA8E;AAC9E,qBAAa,WAAY,SAAQ,SAAS;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,yFAAyF;AACzF,qBAAa,YAAa,SAAQ,SAAS;gBAC7B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,4EAA4E;AAC5E,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,wEAAwE;AACxE,qBAAa,YAAa,SAAQ,SAAS;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpF;AAED,2DAA2D;AAC3D,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,uEAAuE;AACvE,qBAAa,eAAgB,SAAQ,SAAS;gBAChC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D"}