claude-conversation-memory-mcp 0.1.0

package/dist/embeddings/EmbeddingConfig.js

@@ -0,0 +1,132 @@
+/**
+ * Embedding Configuration Management
+ * Loads config from file and environment variables (env vars take precedence)
+ */
+import { readFileSync, existsSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+export class ConfigLoader {
+    static CONFIG_FILENAME = ".claude-memory-config.json";
+    /**
+     * Load configuration with precedence: env vars > project config > home config > defaults
+     */
+    static load() {
+        // Start with defaults
+        let config = {
+            provider: "transformers",
+            model: "Xenova/all-MiniLM-L6-v2",
+            dimensions: 384,
+        };
+        // Try loading from home directory config
+        const homeConfigPath = join(homedir(), this.CONFIG_FILENAME);
+        if (existsSync(homeConfigPath)) {
+            const homeConfig = this.loadConfigFile(homeConfigPath);
+            if (homeConfig?.embedding) {
+                config = { ...config, ...homeConfig.embedding };
+            }
+        }
+        // Try loading from project config (overrides home config)
+        const projectConfigPath = join(process.cwd(), this.CONFIG_FILENAME);
+        if (existsSync(projectConfigPath)) {
+            const projectConfig = this.loadConfigFile(projectConfigPath);
+            if (projectConfig?.embedding) {
+                config = { ...config, ...projectConfig.embedding };
+            }
+        }
+        // Environment variables override everything
+        if (process.env.EMBEDDING_PROVIDER) {
+            config.provider = process.env.EMBEDDING_PROVIDER;
+        }
+        if (process.env.EMBEDDING_MODEL) {
+            config.model = process.env.EMBEDDING_MODEL;
+        }
+        if (process.env.EMBEDDING_DIMENSIONS) {
+            config.dimensions = parseInt(process.env.EMBEDDING_DIMENSIONS, 10);
+        }
+        if (process.env.EMBEDDING_BASE_URL) {
+            config.baseUrl = process.env.EMBEDDING_BASE_URL;
+        }
+        if (process.env.OPENAI_API_KEY) {
+            config.apiKey = process.env.OPENAI_API_KEY;
+        }
+        // Set provider-specific defaults
+        config = this.applyProviderDefaults(config);
+        return config;
+    }
+    /**
+     * Load and parse config file
+     */
+    static loadConfigFile(path) {
+        try {
+            const content = readFileSync(path, "utf-8");
+            return JSON.parse(content);
+        }
+        catch (error) {
+            console.warn(`Warning: Could not load config file ${path}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Apply provider-specific defaults
+     */
+    static applyProviderDefaults(config) {
+        switch (config.provider) {
+            case "ollama":
+                return {
+                    ...config,
+                    baseUrl: config.baseUrl || "http://localhost:11434",
+                    model: config.model || "mxbai-embed-large",
+                    dimensions: config.dimensions || 1024, // mxbai-embed-large default
+                };
+            case "openai":
+                return {
+                    ...config,
+                    model: config.model || "text-embedding-3-small",
+                    dimensions: config.dimensions || 1536, // text-embedding-3-small default
+                };
+            case "transformers":
+                return {
+                    ...config,
+                    model: config.model || "Xenova/all-MiniLM-L6-v2",
+                    dimensions: config.dimensions || 384,
+                };
+            default:
+                return config;
+        }
+    }
+    /**
+     * Validate configuration
+     */
+    static validate(config) {
+        const errors = [];
+        if (!["ollama", "transformers", "openai"].includes(config.provider)) {
+            errors.push(`Invalid provider: ${config.provider}. Must be 'ollama', 'transformers', or 'openai'`);
+        }
+        if (!config.model || config.model.trim() === "") {
+            errors.push("Model name is required");
+        }
+        if (config.provider === "openai" && !config.apiKey) {
+            errors.push("OpenAI provider requires OPENAI_API_KEY environment variable or apiKey in config");
+        }
+        if (config.dimensions && (config.dimensions < 1 || config.dimensions > 10000)) {
+            errors.push("Dimensions must be between 1 and 10000");
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+    /**
+     * Get example config for documentation
+     */
+    static getExampleConfig() {
+        return JSON.stringify({
+            embedding: {
+                provider: "ollama",
+                model: "nomic-embed-text",
+                baseUrl: "http://localhost:11434",
+            },
+        }, null, 2);
+    }
+}
+//# sourceMappingURL=EmbeddingConfig.js.map

package/dist/embeddings/EmbeddingConfig.js.map

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

package/dist/embeddings/EmbeddingGenerator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Embedding Generator Factory
+ * Creates appropriate embedding provider based on configuration
+ */
+import type { EmbeddingProvider } from "./EmbeddingProvider.js";
+/**
+ * Factory class for creating embedding providers
+ */
+export declare class EmbeddingGenerator {
+    private static instance;
+    /**
+     * Get or create embedding provider based on configuration
+     */
+    static getProvider(): Promise<EmbeddingProvider>;
+    /**
+     * Create specific provider instance
+     */
+    private static createProvider;
+    /**
+     * Auto-detect best available provider
+     * Tries in order: Ollama (fast, free, local) → Transformers (slower startup, offline)
+     */
+    private static autoDetectProvider;
+    /**
+     * Reset singleton (useful for testing)
+     */
+    static reset(): void;
+    /**
+     * Get current provider info (if initialized)
+     */
+    static getInfo(): {
+        provider: string;
+        model: string;
+        available: boolean;
+    } | null;
+}
+/**
+ * Legacy API compatibility - returns provider instance
+ */
+export declare function getEmbeddingGenerator(): Promise<EmbeddingProvider>;
+/**
+ * Legacy API compatibility - resets singleton
+ */
+export declare function resetEmbeddingGenerator(): void;
+//# sourceMappingURL=EmbeddingGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingGenerator.d.ts","sourceRoot":"","sources":["../../src/embeddings/EmbeddingGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAMhE;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IAEzD;;OAEG;WACU,WAAW,IAAI,OAAO,CAAC,iBAAiB,CAAC;IA0CtD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IA2B7B;;;OAGG;mBACkB,kBAAkB;IA6BvC;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;CAYjF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAExE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

package/dist/embeddings/EmbeddingGenerator.js

@@ -0,0 +1,129 @@
+/**
+ * Embedding Generator Factory
+ * Creates appropriate embedding provider based on configuration
+ */
+import { ConfigLoader } from "./EmbeddingConfig.js";
+import { OllamaEmbeddings } from "./providers/OllamaEmbeddings.js";
+import { OpenAIEmbeddings } from "./providers/OpenAIEmbeddings.js";
+import { TransformersEmbeddings } from "./providers/TransformersEmbeddings.js";
+/**
+ * Factory class for creating embedding providers
+ */
+export class EmbeddingGenerator {
+    static instance = null;
+    /**
+     * Get or create embedding provider based on configuration
+     */
+    static async getProvider() {
+        if (this.instance) {
+            return this.instance;
+        }
+        // Load configuration
+        const config = ConfigLoader.load();
+        // Validate configuration
+        const validation = ConfigLoader.validate(config);
+        if (!validation.valid) {
+            console.warn("⚠️ Invalid embedding configuration:");
+            validation.errors.forEach((error) => console.warn(`   - ${error}`));
+            console.warn("   Falling back to auto-detection...");
+        }
+        // Try to create provider based on config (or auto-detect)
+        let provider;
+        if (validation.valid) {
+            console.log(`Attempting to use ${config.provider} embeddings...`);
+            provider = this.createProvider(config.provider, config);
+        }
+        else {
+            // Auto-detect: try providers in order of preference
+            console.log("Auto-detecting available embedding provider...");
+            provider = await this.autoDetectProvider();
+        }
+        // Initialize the provider
+        await provider.initialize();
+        // If provider is not available, try fallback
+        if (!provider.isAvailable()) {
+            console.warn(`⚠️ ${config.provider} provider not available, trying fallback...`);
+            provider = await this.autoDetectProvider();
+            await provider.initialize();
+        }
+        this.instance = provider;
+        return provider;
+    }
+    /**
+     * Create specific provider instance
+     */
+    static createProvider(type, config) {
+        switch (type) {
+            case "ollama":
+                return new OllamaEmbeddings(config.baseUrl || "http://localhost:11434", config.model, config.dimensions);
+            case "openai":
+                return new OpenAIEmbeddings(config.apiKey || "", config.model, config.dimensions);
+            case "transformers":
+                return new TransformersEmbeddings(config.model, config.dimensions);
+            default:
+                throw new Error(`Unknown provider type: ${type}`);
+        }
+    }
+    /**
+     * Auto-detect best available provider
+     * Tries in order: Ollama (fast, free, local) → Transformers (slower startup, offline)
+     */
+    static async autoDetectProvider() {
+        // Try Ollama first (fastest, no download required if already running)
+        const ollama = new OllamaEmbeddings();
+        await ollama.initialize();
+        if (ollama.isAvailable()) {
+            console.log("✓ Auto-detected: Using Ollama embeddings");
+            return ollama;
+        }
+        // Try Transformers.js (works offline, but requires download on first run)
+        const transformers = new TransformersEmbeddings();
+        await transformers.initialize();
+        if (transformers.isAvailable()) {
+            console.log("✓ Auto-detected: Using Transformers.js embeddings");
+            return transformers;
+        }
+        // No provider available - return transformers as placeholder
+        // It will fail gracefully when used, falling back to FTS
+        console.warn("⚠️ No embedding provider available");
+        console.warn("   Options:");
+        console.warn("   1. Install Ollama: https://ollama.com");
+        console.warn("   2. Install @xenova/transformers: npm install @xenova/transformers");
+        console.warn("   3. Configure OpenAI: Set OPENAI_API_KEY environment variable");
+        console.warn("   Falling back to full-text search only.");
+        return transformers; // Return uninitialized provider (will fail gracefully)
+    }
+    /**
+     * Reset singleton (useful for testing)
+     */
+    static reset() {
+        this.instance = null;
+    }
+    /**
+     * Get current provider info (if initialized)
+     */
+    static getInfo() {
+        if (!this.instance) {
+            return null;
+        }
+        const info = this.instance.getModelInfo();
+        return {
+            provider: info.provider,
+            model: info.model,
+            available: info.available,
+        };
+    }
+}
+/**
+ * Legacy API compatibility - returns provider instance
+ */
+export async function getEmbeddingGenerator() {
+    return EmbeddingGenerator.getProvider();
+}
+/**
+ * Legacy API compatibility - resets singleton
+ */
+export function resetEmbeddingGenerator() {
+    EmbeddingGenerator.reset();
+}
+//# sourceMappingURL=EmbeddingGenerator.js.map

package/dist/embeddings/EmbeddingGenerator.js.map

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

package/dist/embeddings/EmbeddingProvider.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Embedding Provider Interface
+ * Defines the contract for all embedding implementations
+ */
+export interface ModelInfo {
+    provider: string;
+    model: string;
+    dimensions: number;
+    available: boolean;
+}
+export interface EmbeddingProvider {
+    /**
+     * Initialize the embedding provider
+     * Should handle graceful failure if provider unavailable
+     */
+    initialize(): Promise<void>;
+    /**
+     * Check if embeddings are available
+     */
+    isAvailable(): boolean;
+    /**
+     * Generate embedding for a single text
+     */
+    embed(text: string): Promise<Float32Array>;
+    /**
+     * Generate embeddings for multiple texts (batched for efficiency)
+     */
+    embedBatch(texts: string[], batchSize?: number): Promise<Float32Array[]>;
+    /**
+     * Get information about the model being used
+     */
+    getModelInfo(): ModelInfo;
+}
+//# sourceMappingURL=EmbeddingProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EmbeddingProvider.d.ts","sourceRoot":"","sources":["../../src/embeddings/EmbeddingProvider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE3C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEzE;;OAEG;IACH,YAAY,IAAI,SAAS,CAAC;CAC3B"}

package/dist/embeddings/EmbeddingProvider.js

@@ -0,0 +1,6 @@
+/**
+ * Embedding Provider Interface
+ * Defines the contract for all embedding implementations
+ */
+export {};
+//# sourceMappingURL=EmbeddingProvider.js.map

package/dist/embeddings/EmbeddingProvider.js.map

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

package/dist/embeddings/VectorStore.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Vector Store with sqlite-vec integration
+ * Dual-schema support (vector extension or BLOB fallback)
+ */
+import type { SQLiteManager } from "../storage/SQLiteManager.js";
+export interface VectorSearchResult {
+    id: string;
+    content: string;
+    similarity: number;
+    metadata?: Record<string, unknown>;
+}
+export declare class VectorStore {
+    private db;
+    private sqliteManager;
+    private hasVecExtension;
+    private vecTablesInitialized;
+    constructor(sqliteManager: SQLiteManager);
+    /**
+     * Detect if sqlite-vec extension is available
+     */
+    private detectVecExtension;
+    /**
+     * Check if vec extension is enabled
+     */
+    isVecEnabled(): boolean;
+    /**
+     * Ensure vec tables exist with correct dimensions
+     */
+    private ensureVecTables;
+    /**
+     * Store an embedding for a message
+     */
+    storeMessageEmbedding(messageId: string, content: string, embedding: Float32Array): Promise<void>;
+    /**
+     * Store embedding in BLOB table (fallback)
+     */
+    private storeInBlobTable;
+    /**
+     * Store an embedding for a decision
+     */
+    storeDecisionEmbedding(decisionId: string, embedding: Float32Array): Promise<void>;
+    /**
+     * Search for similar messages
+     */
+    searchMessages(queryEmbedding: Float32Array, limit?: number): Promise<VectorSearchResult[]>;
+    /**
+     * Search using sqlite-vec extension
+     */
+    private searchWithVecExtension;
+    /**
+     * Search using manual cosine similarity (fallback)
+     */
+    private searchWithCosine;
+    /**
+     * Calculate cosine similarity between two vectors
+     */
+    private cosineSimilarity;
+    /**
+     * Convert Float32Array to Buffer for storage
+     */
+    private float32ArrayToBuffer;
+    /**
+     * Convert Buffer to Float32Array for retrieval
+     */
+    private bufferToFloat32Array;
+    /**
+     * Get embedding count
+     */
+    getEmbeddingCount(): number;
+    /**
+     * Clear all embeddings
+     */
+    clearAllEmbeddings(): void;
+}
+//# sourceMappingURL=VectorStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VectorStore.d.ts","sourceRoot":"","sources":["../../src/embeddings/VectorStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,oBAAoB,CAAkB;gBAElC,aAAa,EAAE,aAAa;IAMxC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACG,qBAAqB,CACzB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,IAAI,CAAC;IAuChB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqBxB;;OAEG;IACG,sBAAsB,CAC1B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,GACtB,OAAO,CAAC,IAAI,CAAC;IAehB;;OAEG;IACG,cAAc,CAClB,cAAc,EAAE,YAAY,EAC5B,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAQhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoC9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,iBAAiB,IAAI,MAAM;IAO3B;;OAEG;IACH,kBAAkB,IAAI,IAAI;CAY3B"}

package/dist/embeddings/VectorStore.js

@@ -0,0 +1,220 @@
+/**
+ * Vector Store with sqlite-vec integration
+ * Dual-schema support (vector extension or BLOB fallback)
+ */
+export class VectorStore {
+    db;
+    sqliteManager;
+    hasVecExtension = false;
+    vecTablesInitialized = false;
+    constructor(sqliteManager) {
+        this.db = sqliteManager.getDatabase();
+        this.sqliteManager = sqliteManager;
+        this.detectVecExtension();
+    }
+    /**
+     * Detect if sqlite-vec extension is available
+     */
+    detectVecExtension() {
+        try {
+            // Try to create a test virtual table
+            this.db.exec("CREATE VIRTUAL TABLE IF NOT EXISTS vec_test USING vec0(test float[1])");
+            this.db.exec("DROP TABLE vec_test");
+            this.hasVecExtension = true;
+            console.log("✓ sqlite-vec extension detected");
+        }
+        catch (_error) {
+            this.hasVecExtension = false;
+            console.log("⚠ sqlite-vec not available, using BLOB fallback");
+        }
+    }
+    /**
+     * Check if vec extension is enabled
+     */
+    isVecEnabled() {
+        return this.hasVecExtension;
+    }
+    /**
+     * Ensure vec tables exist with correct dimensions
+     */
+    ensureVecTables(dimensions) {
+        if (!this.hasVecExtension || this.vecTablesInitialized) {
+            return;
+        }
+        this.sqliteManager.createVecTablesWithDimensions(dimensions);
+        this.vecTablesInitialized = true;
+    }
+    /**
+     * Store an embedding for a message
+     */
+    async storeMessageEmbedding(messageId, content, embedding) {
+        const embedId = `msg_${messageId}`;
+        if (this.hasVecExtension) {
+            // Ensure vec tables exist with correct dimensions
+            this.ensureVecTables(embedding.length);
+            // Use sqlite-vec virtual table
+            try {
+                // Try to delete existing entry first (handles dimension mismatches)
+                try {
+                    this.db
+                        .prepare("DELETE FROM vec_message_embeddings WHERE id = ?")
+                        .run(embedId);
+                }
+                catch (_deleteError) {
+                    // Ignore - entry might not exist
+                }
+                // Now insert the new embedding
+                this.db
+                    .prepare("INSERT INTO vec_message_embeddings (id, embedding) VALUES (?, ?)")
+                    .run(embedId, this.float32ArrayToBuffer(embedding));
+            }
+            catch (error) {
+                // Only log non-UNIQUE-constraint errors
+                const errorMessage = error.message;
+                if (!errorMessage.includes("UNIQUE constraint")) {
+                    console.error("Error storing vector embedding:", error);
+                }
+                // Fallback to BLOB
+                this.storeInBlobTable(messageId, content, embedding);
+            }
+        }
+        else {
+            // Use BLOB storage
+            this.storeInBlobTable(messageId, content, embedding);
+        }
+    }
+    /**
+     * Store embedding in BLOB table (fallback)
+     */
+    storeInBlobTable(messageId, content, embedding) {
+        this.db
+            .prepare(`INSERT OR REPLACE INTO message_embeddings
+         (id, message_id, content, embedding, model_name, created_at)
+         VALUES (?, ?, ?, ?, ?, ?)`)
+            .run(`msg_${messageId}`, messageId, content, this.float32ArrayToBuffer(embedding), "all-MiniLM-L6-v2", Date.now());
+    }
+    /**
+     * Store an embedding for a decision
+     */
+    async storeDecisionEmbedding(decisionId, embedding) {
+        this.db
+            .prepare(`INSERT OR REPLACE INTO decision_embeddings
+         (id, decision_id, embedding, created_at)
+         VALUES (?, ?, ?, ?)`)
+            .run(`dec_${decisionId}`, decisionId, this.float32ArrayToBuffer(embedding), Date.now());
+    }
+    /**
+     * Search for similar messages
+     */
+    async searchMessages(queryEmbedding, limit = 10) {
+        if (this.hasVecExtension) {
+            return this.searchWithVecExtension(queryEmbedding, limit);
+        }
+        else {
+            return this.searchWithCosine(queryEmbedding, limit);
+        }
+    }
+    /**
+     * Search using sqlite-vec extension
+     */
+    searchWithVecExtension(queryEmbedding, limit) {
+        try {
+            const queryBuffer = this.float32ArrayToBuffer(queryEmbedding);
+            const results = this.db
+                .prepare(`SELECT
+            vec.id,
+            me.content,
+            vec_distance_cosine(vec.embedding, ?) as distance
+          FROM vec_message_embeddings vec
+          JOIN message_embeddings me ON vec.id = me.id
+          ORDER BY distance
+          LIMIT ?`)
+                .all(queryBuffer, limit);
+            return results.map((r) => ({
+                id: r.id.replace("msg_", ""),
+                content: r.content,
+                similarity: 1 - r.distance, // Convert distance to similarity
+            }));
+        }
+        catch (error) {
+            console.error("Error in vec search:", error);
+            // Fallback to cosine
+            return this.searchWithCosine(queryEmbedding, limit);
+        }
+    }
+    /**
+     * Search using manual cosine similarity (fallback)
+     */
+    searchWithCosine(queryEmbedding, limit) {
+        const allEmbeddings = this.db
+            .prepare("SELECT id, message_id, content, embedding FROM message_embeddings")
+            .all();
+        const results = allEmbeddings
+            .map((row) => {
+            const embedding = this.bufferToFloat32Array(row.embedding);
+            const similarity = this.cosineSimilarity(queryEmbedding, embedding);
+            return {
+                id: row.message_id,
+                content: row.content,
+                similarity,
+            };
+        })
+            .sort((a, b) => b.similarity - a.similarity)
+            .slice(0, limit);
+        return results;
+    }
+    /**
+     * Calculate cosine similarity between two vectors
+     */
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length) {
+            throw new Error("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];
+        }
+        return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+    }
+    /**
+     * Convert Float32Array to Buffer for storage
+     */
+    float32ArrayToBuffer(array) {
+        return Buffer.from(array.buffer, array.byteOffset, array.byteLength);
+    }
+    /**
+     * Convert Buffer to Float32Array for retrieval
+     */
+    bufferToFloat32Array(buffer) {
+        return new Float32Array(buffer.buffer, buffer.byteOffset, buffer.byteLength / 4);
+    }
+    /**
+     * Get embedding count
+     */
+    getEmbeddingCount() {
+        const result = this.db
+            .prepare("SELECT COUNT(*) as count FROM message_embeddings")
+            .get();
+        return result.count;
+    }
+    /**
+     * Clear all embeddings
+     */
+    clearAllEmbeddings() {
+        this.db.exec("DELETE FROM message_embeddings");
+        this.db.exec("DELETE FROM decision_embeddings");
+        if (this.hasVecExtension) {
+            try {
+                this.db.exec("DELETE FROM vec_message_embeddings");
+            }
+            catch (_e) {
+                // Vector table might not exist
+            }
+        }
+    }
+}
+//# sourceMappingURL=VectorStore.js.map