vesper-memory 0.3.0

package/dist/embeddings/client.js

@@ -0,0 +1,162 @@
+/**
+ * BGE-large Embedding Client
+ *
+ * TypeScript client for the BGE-large embedding service.
+ * Provides methods for generating 1024-dimensional dense embeddings.
+ */
+import { LRUCache } from 'lru-cache';
+/**
+ * BGE-large Embedding Client
+ *
+ * Communicates with the Python embedding service to generate
+ * 1024-dimensional dense embeddings using BGE-large-en-v1.5.
+ */
+export class EmbeddingClient {
+    serviceUrl;
+    timeout;
+    maxRetries;
+    embeddingCache;
+    constructor(config = {}) {
+        this.serviceUrl = config.serviceUrl || process.env.EMBEDDING_SERVICE_URL || 'http://localhost:8000';
+        this.timeout = config.timeout || 30000;
+        this.maxRetries = config.maxRetries || 3;
+        // Initialize LRU cache for embeddings (1000 entries, 1 hour TTL)
+        this.embeddingCache = new LRUCache({
+            max: 1000,
+            ttl: 1000 * 60 * 60, // 1 hour
+        });
+    }
+    /**
+     * Check if the embedding service is healthy
+     *
+     * @returns Health status and model information
+     */
+    async health() {
+        const response = await this.fetchWithRetry(`${this.serviceUrl}/health`, {
+            method: 'GET',
+        });
+        if (!response.ok) {
+            throw new Error(`Health check failed: ${response.status} ${response.statusText}`);
+        }
+        return (await response.json());
+    }
+    /**
+     * Generate embedding for a single text
+     *
+     * @param text - Text to embed
+     * @param normalize - Whether to normalize the embedding (default: true)
+     * @returns 1024-dimensional embedding vector
+     */
+    async embed(text, normalize = true) {
+        // Create cache key from text and normalize flag
+        const cacheKey = `${text}:${normalize}`;
+        // Check cache first
+        const cached = this.embeddingCache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Cache miss - generate embedding
+        const response = await this.embedBatch([text], normalize);
+        const embedding = response.embeddings[0];
+        // Store in cache
+        this.embeddingCache.set(cacheKey, embedding);
+        return embedding;
+    }
+    /**
+     * Generate embeddings for multiple texts
+     *
+     * @param texts - Array of texts to embed
+     * @param normalize - Whether to normalize embeddings (default: true)
+     * @returns Array of 1024-dimensional embedding vectors
+     */
+    async embedBatch(texts, normalize = true) {
+        if (texts.length === 0) {
+            return {
+                embeddings: [],
+                dimensions: 1024,
+                count: 0,
+            };
+        }
+        const response = await this.fetchWithRetry(`${this.serviceUrl}/embed`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                text: texts,
+                normalize,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Embedding generation failed: ${response.status} ${error}`);
+        }
+        const result = (await response.json());
+        // Validate dimensions
+        if (result.dimensions !== 1024) {
+            throw new Error(`Expected 1024-dimensional embeddings, got ${result.dimensions}`);
+        }
+        // Validate count
+        if (result.count !== texts.length) {
+            throw new Error(`Expected ${texts.length} embeddings, got ${result.count}`);
+        }
+        return result;
+    }
+    /**
+     * Generate embeddings with optimized batching
+     *
+     * Automatically splits large batches to avoid memory issues
+     * and timeouts on the embedding service.
+     *
+     * @param texts - Array of texts to embed
+     * @param batchSize - Number of texts per batch (default: 32)
+     * @returns Array of 1024-dimensional embedding vectors
+     */
+    async embedLargeBatch(texts, batchSize = 32) {
+        const allEmbeddings = [];
+        for (let i = 0; i < texts.length; i += batchSize) {
+            const batch = texts.slice(i, i + batchSize);
+            const response = await this.embedBatch(batch);
+            allEmbeddings.push(...response.embeddings);
+        }
+        return allEmbeddings;
+    }
+    /**
+     * Fetch with automatic retry on failure
+     *
+     * @param url - URL to fetch
+     * @param options - Fetch options
+     * @returns Response
+     */
+    async fetchWithRetry(url, options, retries = 0) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            return response;
+        }
+        catch (error) {
+            if (retries < this.maxRetries) {
+                // Wait before retrying (exponential backoff)
+                const delay = Math.pow(2, retries) * 1000;
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                return this.fetchWithRetry(url, options, retries + 1);
+            }
+            throw new Error(`Embedding service request failed after ${this.maxRetries} retries: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+/**
+ * Factory function to create an embedding client
+ *
+ * @param config - Optional configuration
+ * @returns Embedding client instance
+ */
+export function createEmbeddingClient(config) {
+    return new EmbeddingClient(config);
+}
+//# sourceMappingURL=client.js.map

package/dist/embeddings/client.js.map

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

package/dist/embeddings 2/client.d.ts

@@ -0,0 +1,94 @@
+/**
+ * BGE-large Embedding Client
+ *
+ * TypeScript client for the BGE-large embedding service.
+ * Provides methods for generating 1024-dimensional dense embeddings.
+ */
+/**
+ * Embedding service response
+ */
+export interface EmbeddingResponse {
+    embeddings: number[][];
+    dimensions: number;
+    count: number;
+}
+/**
+ * Health check response
+ */
+export interface HealthResponse {
+    status: string;
+    model: string;
+    dimensions: number;
+}
+/**
+ * BGE-large embedding client configuration
+ */
+export interface EmbeddingClientConfig {
+    /** Embedding service URL (default: http://localhost:8000) */
+    serviceUrl?: string;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Maximum retries on failure (default: 3) */
+    maxRetries?: number;
+}
+/**
+ * BGE-large Embedding Client
+ *
+ * Communicates with the Python embedding service to generate
+ * 1024-dimensional dense embeddings using BGE-large-en-v1.5.
+ */
+export declare class EmbeddingClient {
+    private serviceUrl;
+    private timeout;
+    private maxRetries;
+    constructor(config?: EmbeddingClientConfig);
+    /**
+     * Check if the embedding service is healthy
+     *
+     * @returns Health status and model information
+     */
+    health(): Promise<HealthResponse>;
+    /**
+     * Generate embedding for a single text
+     *
+     * @param text - Text to embed
+     * @param normalize - Whether to normalize the embedding (default: true)
+     * @returns 1024-dimensional embedding vector
+     */
+    embed(text: string, normalize?: boolean): Promise<number[]>;
+    /**
+     * Generate embeddings for multiple texts
+     *
+     * @param texts - Array of texts to embed
+     * @param normalize - Whether to normalize embeddings (default: true)
+     * @returns Array of 1024-dimensional embedding vectors
+     */
+    embedBatch(texts: string[], normalize?: boolean): Promise<EmbeddingResponse>;
+    /**
+     * Generate embeddings with optimized batching
+     *
+     * Automatically splits large batches to avoid memory issues
+     * and timeouts on the embedding service.
+     *
+     * @param texts - Array of texts to embed
+     * @param batchSize - Number of texts per batch (default: 32)
+     * @returns Array of 1024-dimensional embedding vectors
+     */
+    embedLargeBatch(texts: string[], batchSize?: number): Promise<number[][]>;
+    /**
+     * Fetch with automatic retry on failure
+     *
+     * @param url - URL to fetch
+     * @param options - Fetch options
+     * @returns Response
+     */
+    private fetchWithRetry;
+}
+/**
+ * Factory function to create an embedding client
+ *
+ * @param config - Optional configuration
+ * @returns Embedding client instance
+ */
+export declare function createEmbeddingClient(config?: EmbeddingClientConfig): EmbeddingClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/embeddings 2/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/embeddings/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,EAAE,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,GAAE,qBAA0B;IAM9C;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAYvC;;;;;;OAMG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,OAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAKvE;;;;;;OAMG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,GAAE,OAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4CxF;;;;;;;;;OASG;IACG,eAAe,CACnB,KAAK,EAAE,MAAM,EAAE,EACf,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;IAYtB;;;;;;OAMG;YACW,cAAc;CA6B7B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,CAAC,EAAE,qBAAqB,GAC7B,eAAe,CAEjB"}

package/dist/embeddings 2/client.js

@@ -0,0 +1,144 @@
+/**
+ * BGE-large Embedding Client
+ *
+ * TypeScript client for the BGE-large embedding service.
+ * Provides methods for generating 1024-dimensional dense embeddings.
+ */
+/**
+ * BGE-large Embedding Client
+ *
+ * Communicates with the Python embedding service to generate
+ * 1024-dimensional dense embeddings using BGE-large-en-v1.5.
+ */
+export class EmbeddingClient {
+    serviceUrl;
+    timeout;
+    maxRetries;
+    constructor(config = {}) {
+        this.serviceUrl = config.serviceUrl || process.env.EMBEDDING_SERVICE_URL || 'http://localhost:8000';
+        this.timeout = config.timeout || 30000;
+        this.maxRetries = config.maxRetries || 3;
+    }
+    /**
+     * Check if the embedding service is healthy
+     *
+     * @returns Health status and model information
+     */
+    async health() {
+        const response = await this.fetchWithRetry(`${this.serviceUrl}/health`, {
+            method: 'GET',
+        });
+        if (!response.ok) {
+            throw new Error(`Health check failed: ${response.status} ${response.statusText}`);
+        }
+        return (await response.json());
+    }
+    /**
+     * Generate embedding for a single text
+     *
+     * @param text - Text to embed
+     * @param normalize - Whether to normalize the embedding (default: true)
+     * @returns 1024-dimensional embedding vector
+     */
+    async embed(text, normalize = true) {
+        const response = await this.embedBatch([text], normalize);
+        return response.embeddings[0];
+    }
+    /**
+     * Generate embeddings for multiple texts
+     *
+     * @param texts - Array of texts to embed
+     * @param normalize - Whether to normalize embeddings (default: true)
+     * @returns Array of 1024-dimensional embedding vectors
+     */
+    async embedBatch(texts, normalize = true) {
+        if (texts.length === 0) {
+            return {
+                embeddings: [],
+                dimensions: 1024,
+                count: 0,
+            };
+        }
+        const response = await this.fetchWithRetry(`${this.serviceUrl}/embed`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                text: texts,
+                normalize,
+            }),
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Embedding generation failed: ${response.status} ${error}`);
+        }
+        const result = (await response.json());
+        // Validate dimensions
+        if (result.dimensions !== 1024) {
+            throw new Error(`Expected 1024-dimensional embeddings, got ${result.dimensions}`);
+        }
+        // Validate count
+        if (result.count !== texts.length) {
+            throw new Error(`Expected ${texts.length} embeddings, got ${result.count}`);
+        }
+        return result;
+    }
+    /**
+     * Generate embeddings with optimized batching
+     *
+     * Automatically splits large batches to avoid memory issues
+     * and timeouts on the embedding service.
+     *
+     * @param texts - Array of texts to embed
+     * @param batchSize - Number of texts per batch (default: 32)
+     * @returns Array of 1024-dimensional embedding vectors
+     */
+    async embedLargeBatch(texts, batchSize = 32) {
+        const allEmbeddings = [];
+        for (let i = 0; i < texts.length; i += batchSize) {
+            const batch = texts.slice(i, i + batchSize);
+            const response = await this.embedBatch(batch);
+            allEmbeddings.push(...response.embeddings);
+        }
+        return allEmbeddings;
+    }
+    /**
+     * Fetch with automatic retry on failure
+     *
+     * @param url - URL to fetch
+     * @param options - Fetch options
+     * @returns Response
+     */
+    async fetchWithRetry(url, options, retries = 0) {
+        try {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+            const response = await fetch(url, {
+                ...options,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            return response;
+        }
+        catch (error) {
+            if (retries < this.maxRetries) {
+                // Wait before retrying (exponential backoff)
+                const delay = Math.pow(2, retries) * 1000;
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                return this.fetchWithRetry(url, options, retries + 1);
+            }
+            throw new Error(`Embedding service request failed after ${this.maxRetries} retries: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+}
+/**
+ * Factory function to create an embedding client
+ *
+ * @param config - Optional configuration
+ * @returns Embedding client instance
+ */
+export function createEmbeddingClient(config) {
+    return new EmbeddingClient(config);
+}
+//# sourceMappingURL=client.js.map

package/dist/embeddings 2/client.js.map

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

package/dist/memory-layers/semantic-memory.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Semantic Memory Layer - v3.0 Implementation
+ *
+ * SQLite knowledge graph with HippoRAG Personalized PageRank.
+ */
+import Database from 'better-sqlite3';
+export interface Entity {
+    id: string;
+    name: string;
+    type: 'person' | 'project' | 'concept' | 'preference';
+    description?: string;
+    confidence: number;
+}
+export interface Fact {
+    id: string;
+    entity_id: string;
+    property: string;
+    value: string;
+    confidence: number;
+    valid_from?: string;
+    valid_until?: string;
+    source_conversation?: string;
+}
+export interface TraversalPath {
+    sourceId: string;
+    targetId: string;
+    hops: number;
+    path: string[];
+    relationType: string;
+}
+export interface FactChain {
+    targetId: string;
+    targetName: string;
+    intermediaries: string[];
+    totalScore: number;
+}
+export interface PageRankWithFactsResult {
+    entities: Array<Entity & {
+        relevanceScore: number;
+    }>;
+    facts: Fact[];
+    paths: TraversalPath[];
+    chains?: FactChain[];
+}
+export declare class SemanticMemoryLayer {
+    private db;
+    constructor(db: Database.Database);
+    upsertEntity(entity: Partial<Entity> & {
+        name: string;
+        type: string;
+    }): Entity;
+    getEntity(name: string): any | null;
+    upsertRelationship(rel: {
+        sourceId: string;
+        targetId: string;
+        relationType: string;
+        strength?: number;
+    }): void;
+    personalizedPageRank(entityId: string, depth?: number): any[];
+    /**
+     * Enhanced Personalized PageRank with fact retrieval for multi-hop reasoning.
+     *
+     * Returns both entities AND their associated facts along the traversal path,
+     * enabling multi-hop query answering (e.g., "What protocol does Vesper follow?"
+     * can chain Vesper -> MCP -> "Model Context Protocol").
+     *
+     * @param entityId - Starting entity ID for traversal
+     * @param depth - Maximum hops to traverse (default: 3 for multi-hop queries)
+     * @returns PageRankWithFactsResult containing entities, facts, paths, and chains
+     */
+    personalizedPageRankWithFacts(entityId: string, depth?: number): PageRankWithFactsResult;
+    applyTemporalDecay(): number;
+    getPreferences(domain?: string): any[];
+    getByTimeRange(start?: Date, end?: Date): any[];
+}
+//# sourceMappingURL=semantic-memory.d.ts.map

package/dist/memory-layers/semantic-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-memory.d.ts","sourceRoot":"","sources":["../../src/memory-layers/semantic-memory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAIjC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAiC9E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAcnC,kBAAkB,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAuB9G,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,GAAG,EAAE;IAmChE;;;;;;;;;;OAUG;IACH,6BAA6B,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,uBAAuB;IAyI3F,kBAAkB,IAAI,MAAM;IAgB5B,cAAc,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE;IAStC,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,GAAG,EAAE;CAgBhD"}