@liendev/core 0.19.5

package/dist/embeddings/cache.js

@@ -0,0 +1,109 @@
+/**
+ * LRU cache for embeddings with configurable max size.
+ * Wraps any EmbeddingService to add caching functionality.
+ *
+ * Benefits:
+ * - Faster repeated searches
+ * - Reduced CPU usage
+ * - Better user experience for common queries
+ */
+export class CachedEmbeddings {
+    cache = new Map();
+    maxSize;
+    underlying;
+    /**
+     * Creates a new cached embeddings service
+     * @param underlying - The underlying embedding service to wrap
+     * @param maxSize - Maximum number of embeddings to cache (default: 1000)
+     */
+    constructor(underlying, maxSize = 1000) {
+        this.underlying = underlying;
+        this.maxSize = maxSize;
+    }
+    async initialize() {
+        return this.underlying.initialize();
+    }
+    async embed(text) {
+        // Check cache first
+        const cached = this.cache.get(text);
+        if (cached) {
+            return cached;
+        }
+        // Generate embedding
+        const result = await this.underlying.embed(text);
+        // Add to cache with LRU eviction
+        if (this.cache.size >= this.maxSize) {
+            // Remove oldest entry (first key in Map)
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                this.cache.delete(firstKey);
+            }
+        }
+        this.cache.set(text, result);
+        return result;
+    }
+    async embedBatch(texts) {
+        const results = [];
+        const uncachedTexts = [];
+        const uncachedIndices = [];
+        // Check cache for each text
+        for (let i = 0; i < texts.length; i++) {
+            const cached = this.cache.get(texts[i]);
+            if (cached) {
+                results[i] = cached;
+            }
+            else {
+                uncachedTexts.push(texts[i]);
+                uncachedIndices.push(i);
+            }
+        }
+        // Generate embeddings for uncached texts
+        if (uncachedTexts.length > 0) {
+            const newEmbeddings = await this.underlying.embedBatch(uncachedTexts);
+            // Store in cache and results
+            for (let i = 0; i < newEmbeddings.length; i++) {
+                const text = uncachedTexts[i];
+                const embedding = newEmbeddings[i];
+                const resultIndex = uncachedIndices[i];
+                // Add to cache with LRU eviction
+                if (this.cache.size >= this.maxSize) {
+                    const firstKey = this.cache.keys().next().value;
+                    if (firstKey !== undefined) {
+                        this.cache.delete(firstKey);
+                    }
+                }
+                this.cache.set(text, embedding);
+                results[resultIndex] = embedding;
+            }
+        }
+        return results;
+    }
+    /**
+     * Gets the current cache size
+     */
+    getCacheSize() {
+        return this.cache.size;
+    }
+    /**
+     * Gets cache statistics
+     */
+    getCacheStats() {
+        return {
+            size: this.cache.size,
+            maxSize: this.maxSize,
+        };
+    }
+    /**
+     * Clears the cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Checks if a text is in the cache
+     */
+    has(text) {
+        return this.cache.has(text);
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/embeddings/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/embeddings/cache.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IACnB,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC/B,OAAO,CAAS;IAChB,UAAU,CAAmB;IAE9C;;;;OAIG;IACH,YAAY,UAA4B,EAAE,UAAkB,IAAI;QAC9D,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,oBAAoB;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,qBAAqB;QACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjD,iCAAiC;QACjC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACpC,yCAAyC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,MAAM,OAAO,GAAmB,EAAE,CAAC;QACnC,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,4BAA4B;QAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC7B,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,yCAAyC;QACzC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;YAEtE,6BAA6B;YAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9C,MAAM,IAAI,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;gBAC9B,MAAM,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;gBACnC,MAAM,WAAW,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;gBAEvC,iCAAiC;gBACjC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;oBAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;wBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAC9B,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAChC,OAAO,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;CACF"}

package/dist/embeddings/local.d.ts

@@ -0,0 +1,10 @@
+import { EmbeddingService } from './types.js';
+export declare class LocalEmbeddings implements EmbeddingService {
+    private extractor;
+    private readonly modelName;
+    private initPromise;
+    initialize(): Promise<void>;
+    embed(text: string): Promise<Float32Array>;
+    embedBatch(texts: string[]): Promise<Float32Array[]>;
+}
+//# sourceMappingURL=local.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/embeddings/local.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAQ9C,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,SAAS,CAA0C;IAC3D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,WAAW,CAA8B;IAE3C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAmB1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAkB3D"}

package/dist/embeddings/local.js

@@ -0,0 +1,63 @@
+import { pipeline, env } from '@xenova/transformers';
+import { EmbeddingError, wrapError } from '../errors/index.js';
+import { DEFAULT_EMBEDDING_MODEL } from '../constants.js';
+// Configure transformers.js to cache models locally
+env.allowRemoteModels = true;
+env.allowLocalModels = true;
+export class LocalEmbeddings {
+    extractor = null;
+    modelName = DEFAULT_EMBEDDING_MODEL;
+    initPromise = null;
+    async initialize() {
+        // Prevent multiple simultaneous initializations
+        if (this.initPromise) {
+            return this.initPromise;
+        }
+        if (this.extractor) {
+            return;
+        }
+        this.initPromise = (async () => {
+            try {
+                // This downloads ~100MB on first run, then caches in ~/.cache/huggingface
+                this.extractor = await pipeline('feature-extraction', this.modelName);
+            }
+            catch (error) {
+                this.initPromise = null;
+                throw wrapError(error, 'Failed to initialize embedding model');
+            }
+        })();
+        return this.initPromise;
+    }
+    async embed(text) {
+        await this.initialize();
+        if (!this.extractor) {
+            throw new EmbeddingError('Embedding model not initialized');
+        }
+        try {
+            const output = await this.extractor(text, {
+                pooling: 'mean',
+                normalize: true,
+            });
+            return output.data;
+        }
+        catch (error) {
+            throw wrapError(error, 'Failed to generate embedding', { textLength: text.length });
+        }
+    }
+    async embedBatch(texts) {
+        await this.initialize();
+        if (!this.extractor) {
+            throw new EmbeddingError('Embedding model not initialized');
+        }
+        try {
+            // Process embeddings with Promise.all for concurrent execution
+            // Each call is sequential but Promise.all allows task interleaving
+            const results = await Promise.all(texts.map(text => this.embed(text)));
+            return results;
+        }
+        catch (error) {
+            throw wrapError(error, 'Failed to generate batch embeddings', { batchSize: texts.length });
+        }
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/embeddings/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/embeddings/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAkC,MAAM,sBAAsB,CAAC;AAErF,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,oDAAoD;AACpD,GAAG,CAAC,iBAAiB,GAAG,IAAI,CAAC;AAC7B,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC;AAE5B,MAAM,OAAO,eAAe;IAClB,SAAS,GAAqC,IAAI,CAAC;IAC1C,SAAS,GAAG,uBAAuB,CAAC;IAC7C,WAAW,GAAyB,IAAI,CAAC;IAEjD,KAAK,CAAC,UAAU;QACd,gDAAgD;QAChD,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,CAAC,KAAK,IAAI,EAAE;YAC7B,IAAI,CAAC;gBACH,0EAA0E;gBAC1E,IAAI,CAAC,SAAS,GAAG,MAAM,QAAQ,CAAC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAA8B,CAAC;YACrG,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;gBACxB,MAAM,SAAS,CAAC,KAAK,EAAE,sCAAsC,CAAC,CAAC;YACjE,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,cAAc,CAAC,iCAAiC,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;gBACxC,OAAO,EAAE,MAAM;gBACf,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC,IAAoB,CAAC;QACrC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,SAAS,CAAC,KAAK,EAAE,8BAA8B,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAe;QAC9B,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAExB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,cAAc,CAAC,iCAAiC,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC;YACH,+DAA+D;YAC/D,mEAAmE;YACnE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CACpC,CAAC;YACF,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,SAAS,CAAC,KAAK,EAAE,qCAAqC,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7F,CAAC;IACH,CAAC;CACF"}

package/dist/embeddings/types.d.ts

@@ -0,0 +1,9 @@
+import { EMBEDDING_DIMENSIONS } from '../constants.js';
+export interface EmbeddingService {
+    initialize(): Promise<void>;
+    embed(text: string): Promise<Float32Array>;
+    embedBatch(texts: string[]): Promise<Float32Array[]>;
+}
+export declare const EMBEDDING_DIMENSION = 384;
+export { EMBEDDING_DIMENSIONS };
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACtD;AAED,eAAO,MAAM,mBAAmB,MAAuB,CAAC;AAGxD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/embeddings/types.js

@@ -0,0 +1,5 @@
+import { EMBEDDING_DIMENSIONS } from '../constants.js';
+export const EMBEDDING_DIMENSION = EMBEDDING_DIMENSIONS;
+// Re-export for convenience
+export { EMBEDDING_DIMENSIONS };
+//# sourceMappingURL=types.js.map

package/dist/embeddings/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/embeddings/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAQvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAExD,4BAA4B;AAC5B,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/errors/codes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Error codes for all Lien-specific errors.
+ * Used to identify error types programmatically.
+ */
+export declare enum LienErrorCode {
+    CONFIG_NOT_FOUND = "CONFIG_NOT_FOUND",
+    CONFIG_INVALID = "CONFIG_INVALID",
+    INDEX_NOT_FOUND = "INDEX_NOT_FOUND",
+    INDEX_CORRUPTED = "INDEX_CORRUPTED",
+    EMBEDDING_MODEL_FAILED = "EMBEDDING_MODEL_FAILED",
+    EMBEDDING_GENERATION_FAILED = "EMBEDDING_GENERATION_FAILED",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    FILE_NOT_READABLE = "FILE_NOT_READABLE",
+    INVALID_PATH = "INVALID_PATH",
+    INVALID_INPUT = "INVALID_INPUT",
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}
+//# sourceMappingURL=codes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../src/errors/codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,aAAa;IAEvB,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IAGjC,eAAe,oBAAoB;IACnC,eAAe,oBAAoB;IAGnC,sBAAsB,2BAA2B;IACjD,2BAA2B,gCAAgC;IAG3D,cAAc,mBAAmB;IACjC,iBAAiB,sBAAsB;IACvC,YAAY,iBAAiB;IAG7B,aAAa,kBAAkB;IAG/B,cAAc,mBAAmB;CAClC"}

package/dist/errors/codes.js

@@ -0,0 +1,25 @@
+/**
+ * Error codes for all Lien-specific errors.
+ * Used to identify error types programmatically.
+ */
+export var LienErrorCode;
+(function (LienErrorCode) {
+    // Configuration
+    LienErrorCode["CONFIG_NOT_FOUND"] = "CONFIG_NOT_FOUND";
+    LienErrorCode["CONFIG_INVALID"] = "CONFIG_INVALID";
+    // Index
+    LienErrorCode["INDEX_NOT_FOUND"] = "INDEX_NOT_FOUND";
+    LienErrorCode["INDEX_CORRUPTED"] = "INDEX_CORRUPTED";
+    // Embeddings
+    LienErrorCode["EMBEDDING_MODEL_FAILED"] = "EMBEDDING_MODEL_FAILED";
+    LienErrorCode["EMBEDDING_GENERATION_FAILED"] = "EMBEDDING_GENERATION_FAILED";
+    // File System
+    LienErrorCode["FILE_NOT_FOUND"] = "FILE_NOT_FOUND";
+    LienErrorCode["FILE_NOT_READABLE"] = "FILE_NOT_READABLE";
+    LienErrorCode["INVALID_PATH"] = "INVALID_PATH";
+    // Tool Input
+    LienErrorCode["INVALID_INPUT"] = "INVALID_INPUT";
+    // System
+    LienErrorCode["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(LienErrorCode || (LienErrorCode = {}));
+//# sourceMappingURL=codes.js.map

package/dist/errors/codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.js","sourceRoot":"","sources":["../../src/errors/codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,aAuBX;AAvBD,WAAY,aAAa;IACvB,gBAAgB;IAChB,sDAAqC,CAAA;IACrC,kDAAiC,CAAA;IAEjC,QAAQ;IACR,oDAAmC,CAAA;IACnC,oDAAmC,CAAA;IAEnC,aAAa;IACb,kEAAiD,CAAA;IACjD,4EAA2D,CAAA;IAE3D,cAAc;IACd,kDAAiC,CAAA;IACjC,wDAAuC,CAAA;IACvC,8CAA6B,CAAA;IAE7B,aAAa;IACb,gDAA+B,CAAA;IAE/B,SAAS;IACT,kDAAiC,CAAA;AACnC,CAAC,EAvBW,aAAa,KAAb,aAAa,QAuBxB"}

package/dist/errors/index.d.ts

@@ -0,0 +1,85 @@
+import { LienErrorCode } from './codes.js';
+export { LienErrorCode } from './codes.js';
+/**
+ * Severity levels for errors
+ */
+export type ErrorSeverity = 'low' | 'medium' | 'high' | 'critical';
+/**
+ * Base error class for all Lien-specific errors
+ */
+export declare class LienError extends Error {
+    readonly code: LienErrorCode;
+    readonly context?: Record<string, unknown> | undefined;
+    readonly severity: ErrorSeverity;
+    readonly recoverable: boolean;
+    readonly retryable: boolean;
+    constructor(message: string, code: LienErrorCode, context?: Record<string, unknown> | undefined, severity?: ErrorSeverity, recoverable?: boolean, retryable?: boolean);
+    /**
+     * Serialize error to JSON for MCP responses
+     */
+    toJSON(): {
+        error: string;
+        code: LienErrorCode;
+        severity: ErrorSeverity;
+        recoverable: boolean;
+        context: Record<string, unknown> | undefined;
+    };
+    /**
+     * Check if this error is retryable
+     */
+    isRetryable(): boolean;
+    /**
+     * Check if this error is recoverable
+     */
+    isRecoverable(): boolean;
+}
+/**
+ * Configuration-related errors (loading, parsing, migration)
+ */
+export declare class ConfigError extends LienError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Indexing-related errors (file processing, chunking)
+ */
+export declare class IndexingError extends LienError {
+    readonly file?: string | undefined;
+    constructor(message: string, file?: string | undefined, context?: Record<string, unknown>);
+}
+/**
+ * Embedding generation errors
+ */
+export declare class EmbeddingError extends LienError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Vector database errors (connection, query, storage)
+ */
+export declare class DatabaseError extends LienError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/**
+ * Helper function to wrap unknown errors with context
+ * @param error - Unknown error object to wrap
+ * @param context - Context message describing what operation failed
+ * @param additionalContext - Optional additional context data
+ * @returns LienError with proper message and context
+ */
+export declare function wrapError(error: unknown, context: string, additionalContext?: Record<string, unknown>): LienError;
+/**
+ * Type guard to check if an error is a LienError
+ */
+export declare function isLienError(error: unknown): error is LienError;
+/**
+ * Extract error message from unknown error type
+ * @param error - Unknown error object
+ * @returns Error message string
+ */
+export declare function getErrorMessage(error: unknown): string;
+/**
+ * Extract stack trace from unknown error type
+ * @param error - Unknown error object
+ * @returns Stack trace string or undefined
+ */
+export declare function getErrorStack(error: unknown): string | undefined;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEnE;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;aAGhB,IAAI,EAAE,aAAa;aACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;aACjC,QAAQ,EAAE,aAAa;aACvB,WAAW,EAAE,OAAO;aACpB,SAAS,EAAE,OAAO;gBALlC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA,EACjC,QAAQ,GAAE,aAAwB,EAClC,WAAW,GAAE,OAAc,EAC3B,SAAS,GAAE,OAAe;IAW5C;;OAEG;IACH,MAAM;;;;;;;IAUN;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,aAAa,IAAI,OAAO;CAGzB;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,SAAS;gBAC5B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;aAGxB,IAAI,CAAC,EAAE,MAAM;gBAD7B,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAKpC;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,SAAS;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAI/D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,EACf,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1C,SAAS,CAgBX;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKtD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAKhE"}

package/dist/errors/index.js

@@ -0,0 +1,134 @@
+import { LienErrorCode } from './codes.js';
+// Re-export for consumers
+export { LienErrorCode } from './codes.js';
+/**
+ * Base error class for all Lien-specific errors
+ */
+export class LienError extends Error {
+    code;
+    context;
+    severity;
+    recoverable;
+    retryable;
+    constructor(message, code, context, severity = 'medium', recoverable = true, retryable = false) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.severity = severity;
+        this.recoverable = recoverable;
+        this.retryable = retryable;
+        this.name = 'LienError';
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Serialize error to JSON for MCP responses
+     */
+    toJSON() {
+        return {
+            error: this.message,
+            code: this.code,
+            severity: this.severity,
+            recoverable: this.recoverable,
+            context: this.context,
+        };
+    }
+    /**
+     * Check if this error is retryable
+     */
+    isRetryable() {
+        return this.retryable;
+    }
+    /**
+     * Check if this error is recoverable
+     */
+    isRecoverable() {
+        return this.recoverable;
+    }
+}
+/**
+ * Configuration-related errors (loading, parsing, migration)
+ */
+export class ConfigError extends LienError {
+    constructor(message, context) {
+        super(message, LienErrorCode.CONFIG_INVALID, context, 'medium', true, false);
+        this.name = 'ConfigError';
+    }
+}
+/**
+ * Indexing-related errors (file processing, chunking)
+ */
+export class IndexingError extends LienError {
+    file;
+    constructor(message, file, context) {
+        super(message, LienErrorCode.INTERNAL_ERROR, { ...context, file }, 'medium', true, false);
+        this.file = file;
+        this.name = 'IndexingError';
+    }
+}
+/**
+ * Embedding generation errors
+ */
+export class EmbeddingError extends LienError {
+    constructor(message, context) {
+        super(message, LienErrorCode.EMBEDDING_GENERATION_FAILED, context, 'high', true, true);
+        this.name = 'EmbeddingError';
+    }
+}
+/**
+ * Vector database errors (connection, query, storage)
+ */
+export class DatabaseError extends LienError {
+    constructor(message, context) {
+        super(message, LienErrorCode.INTERNAL_ERROR, context, 'high', true, true);
+        this.name = 'DatabaseError';
+    }
+}
+/**
+ * Helper function to wrap unknown errors with context
+ * @param error - Unknown error object to wrap
+ * @param context - Context message describing what operation failed
+ * @param additionalContext - Optional additional context data
+ * @returns LienError with proper message and context
+ */
+export function wrapError(error, context, additionalContext) {
+    const message = error instanceof Error ? error.message : String(error);
+    const stack = error instanceof Error ? error.stack : undefined;
+    const wrappedError = new LienError(`${context}: ${message}`, LienErrorCode.INTERNAL_ERROR, additionalContext);
+    // Preserve original stack trace if available
+    if (stack) {
+        wrappedError.stack = `${wrappedError.stack}\n\nCaused by:\n${stack}`;
+    }
+    return wrappedError;
+}
+/**
+ * Type guard to check if an error is a LienError
+ */
+export function isLienError(error) {
+    return error instanceof LienError;
+}
+/**
+ * Extract error message from unknown error type
+ * @param error - Unknown error object
+ * @returns Error message string
+ */
+export function getErrorMessage(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * Extract stack trace from unknown error type
+ * @param error - Unknown error object
+ * @returns Stack trace string or undefined
+ */
+export function getErrorStack(error) {
+    if (error instanceof Error) {
+        return error.stack;
+    }
+    return undefined;
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/frameworks/detector-service.d.ts

@@ -0,0 +1,59 @@
+import { DetectionResult, DetectionOptions } from './types.js';
+/** Detection result with internal priority for conflict resolution */
+export type DetectionWithPriority = DetectionResult & {
+    priority: number;
+};
+/** Detections grouped by confidence level */
+export interface GroupedDetections {
+    high: DetectionWithPriority[];
+    medium: DetectionWithPriority[];
+    low: DetectionWithPriority[];
+}
+/**
+ * Group detections by confidence level.
+ */
+export declare function groupByConfidence(detections: DetectionWithPriority[]): GroupedDetections;
+/**
+ * Select the winner from a list using priority (highest priority wins).
+ * Returns the winner and the remaining (skipped) detections.
+ *
+ * @throws Error if detections array is empty
+ */
+export declare function selectByPriority(detections: DetectionWithPriority[]): {
+    winner: DetectionWithPriority;
+    skipped: DetectionWithPriority[];
+};
+/**
+ * Resolve conflicts when multiple frameworks are detected at the same path.
+ *
+ * Resolution rules (applied in order):
+ * 1. Multiple HIGH confidence → keep ALL (hybrid project support)
+ * 2. Single HIGH confidence → keep it, skip lower confidence
+ * 3. No HIGH but have MEDIUM → use priority to select winner
+ * 4. Only LOW confidence → use priority to select winner
+ *
+ * @param detections - All detected frameworks with their priorities
+ * @param relativePath - Path being analyzed (for logging)
+ * @returns Array of resolved detection results
+ */
+export declare function resolveFrameworkConflicts(detections: DetectionWithPriority[], relativePath: string): DetectionResult[];
+/**
+ * Run all framework detectors at a path and collect results.
+ *
+ * @param rootDir - Project root directory
+ * @param relativePath - Path relative to root being scanned
+ * @returns Array of detection results with priorities
+ */
+export declare function runAllDetectors(rootDir: string, relativePath: string): Promise<DetectionWithPriority[]>;
+/**
+ * Detect all frameworks in a monorepo by recursively scanning subdirectories
+ * @param rootDir - Absolute path to project root
+ * @param options - Detection options (max depth, skip dirs)
+ * @returns Array of detected frameworks with their paths
+ */
+export declare function detectAllFrameworks(rootDir: string, options?: Partial<DetectionOptions>): Promise<DetectionResult[]>;
+/**
+ * Get a human-readable summary of detected frameworks
+ */
+export declare function getDetectionSummary(results: DetectionResult[]): string;
+//# sourceMappingURL=detector-service.d.ts.map

package/dist/frameworks/detector-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector-service.d.ts","sourceRoot":"","sources":["../../src/frameworks/detector-service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAA2B,MAAM,YAAY,CAAC;AAGxF,sEAAsE;AACtE,MAAM,MAAM,qBAAqB,GAAG,eAAe,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,EAAE,CAAC;IAC9B,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,GAAG,EAAE,qBAAqB,EAAE,CAAC;CAC9B;AA4BD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,qBAAqB,EAAE,GAAG,iBAAiB,CAMxF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,qBAAqB,EAAE,GAClC;IAAE,MAAM,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,qBAAqB,EAAE,CAAA;CAAE,CASrE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,qBAAqB,EAAE,EACnC,YAAY,EAAE,MAAM,GACnB,eAAe,EAAE,CA4CnB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAkBlC;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACtC,OAAO,CAAC,eAAe,EAAE,CAAC,CAY5B;AAgFD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAmBtE"}