@astrive-ai/memory 1.0.1

package/dist/embeddings.d.ts

@@ -0,0 +1,14 @@
+import { IProvider } from '@astrive-ai/types';
+export interface EmbeddingResult {
+    text: string;
+    vector: number[];
+}
+export declare class EmbeddingModel {
+    private provider?;
+    private modelName;
+    constructor(provider?: IProvider, modelName?: string);
+    embedText(text: string): Promise<number[]>;
+    embedBatch(texts: string[]): Promise<EmbeddingResult[]>;
+    private mockEmbedding;
+}
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAY;IAC7B,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,CAAC,EAAE,SAAS,EAAE,SAAS,GAAE,MAAiC;IAKjE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY1C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IASpE,OAAO,CAAC,aAAa;CAiBtB"}

package/dist/embeddings.js

@@ -0,0 +1,42 @@
+export class EmbeddingModel {
+    provider;
+    modelName;
+    constructor(provider, modelName = 'text-embedding-3-small') {
+        this.provider = provider;
+        this.modelName = modelName;
+    }
+    async embedText(text) {
+        if (!this.provider) {
+            // Mock embedding if no provider
+            return this.mockEmbedding(text, 1536);
+        }
+        // In a real implementation, this would call the provider's embedding endpoint
+        // For now, if the provider doesn't support embeddings explicitly, we mock it or 
+        // implement a standard fetch to an embeddings API.
+        return this.mockEmbedding(text, 1536);
+    }
+    async embedBatch(texts) {
+        const results = [];
+        for (const text of texts) {
+            const vector = await this.embedText(text);
+            results.push({ text, vector });
+        }
+        return results;
+    }
+    mockEmbedding(text, dimensions) {
+        // Generate a deterministic pseudo-random vector based on text
+        let hash = 0;
+        for (let i = 0; i < text.length; i++) {
+            hash = ((hash << 5) - hash) + text.charCodeAt(i);
+            hash = hash & hash;
+        }
+        const vector = new Array(dimensions);
+        for (let i = 0; i < dimensions; i++) {
+            vector[i] = Math.sin(hash + i);
+        }
+        // Normalize
+        const magnitude = Math.sqrt(vector.reduce((sum, val) => sum + val * val, 0));
+        return vector.map(val => val / (magnitude || 1));
+    }
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/embeddings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.js","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,cAAc;IACjB,QAAQ,CAAa;IACrB,SAAS,CAAS;IAE1B,YAAY,QAAoB,EAAE,YAAoB,wBAAwB;QAC5E,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAEM,KAAK,CAAC,SAAS,CAAC,IAAY;QACjC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,gCAAgC;YAChC,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,8EAA8E;QAC9E,iFAAiF;QACjF,mDAAmD;QACnD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,UAAU,CAAC,KAAe;QACrC,MAAM,OAAO,GAAsB,EAAE,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,aAAa,CAAC,IAAY,EAAE,UAAkB;QACpD,8DAA8D;QAC9D,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACjD,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;QACrB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;QACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC;QAED,YAAY;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7E,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/file-store.d.ts

@@ -0,0 +1,15 @@
+import { InMemoryStore } from './memory-store.js';
+import { MemoryEntry } from '@astrive-ai/types';
+export declare class FileMemoryStore extends InMemoryStore {
+    private filePath;
+    private saveTimeout;
+    constructor(filePath: string, maxEntries?: number);
+    init(): Promise<void>;
+    add(entry: MemoryEntry): Promise<string>;
+    update(id: string, partial: Partial<MemoryEntry>): Promise<void>;
+    delete(id: string): Promise<void>;
+    clear(): Promise<void>;
+    private scheduleSave;
+    private saveToDisk;
+}
+//# sourceMappingURL=file-store.d.ts.map

package/dist/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../src/file-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,qBAAa,eAAgB,SAAQ,aAAa;IAChD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAA+B;gBAEtC,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAa;IAK1C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrB,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnC,OAAO,CAAC,YAAY;YASN,UAAU;CAIzB"}

package/dist/file-store.js

@@ -0,0 +1,54 @@
+import { InMemoryStore } from './memory-store.js';
+import fs from 'fs/promises';
+export class FileMemoryStore extends InMemoryStore {
+    filePath;
+    saveTimeout = null;
+    constructor(filePath, maxEntries = 1000) {
+        super(maxEntries);
+        this.filePath = filePath;
+    }
+    async init() {
+        try {
+            const data = await fs.readFile(this.filePath, 'utf-8');
+            const parsed = JSON.parse(data);
+            for (const entry of parsed) {
+                this.entries.set(entry.id, entry);
+            }
+        }
+        catch (e) {
+            if (e.code !== 'ENOENT') {
+                throw e;
+            }
+        }
+    }
+    async add(entry) {
+        const id = await super.add(entry);
+        this.scheduleSave();
+        return id;
+    }
+    async update(id, partial) {
+        await super.update(id, partial);
+        this.scheduleSave();
+    }
+    async delete(id) {
+        await super.delete(id);
+        this.scheduleSave();
+    }
+    async clear() {
+        await super.clear();
+        this.scheduleSave();
+    }
+    scheduleSave() {
+        if (this.saveTimeout) {
+            clearTimeout(this.saveTimeout);
+        }
+        this.saveTimeout = setTimeout(() => {
+            this.saveToDisk();
+        }, 500);
+    }
+    async saveToDisk() {
+        const data = JSON.stringify(Array.from(this.entries.values()), null, 2);
+        await fs.writeFile(this.filePath, data, 'utf-8');
+    }
+}
+//# sourceMappingURL=file-store.js.map

package/dist/file-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.js","sourceRoot":"","sources":["../src/file-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B,MAAM,OAAO,eAAgB,SAAQ,aAAa;IACxC,QAAQ,CAAS;IACjB,WAAW,GAA0B,IAAI,CAAC;IAElD,YAAY,QAAgB,EAAE,aAAqB,IAAI;QACrD,KAAK,CAAC,UAAU,CAAC,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,MAAM,GAAkB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,MAAM,CAAC,CAAC;YACV,CAAC;QACH,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,GAAG,CAAC,KAAkB;QACjC,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,OAA6B;QAC3D,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,EAAU;QAC5B,MAAM,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAEO,YAAY;QAClB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE;YACjC,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,CAAC,EAAE,GAAG,CAAC,CAAC;IACV,CAAC;IAEO,KAAK,CAAC,UAAU;QACtB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './memory-store.js';
+export * from './file-store.js';
+export * from './memory-manager.js';
+export * from './embeddings.js';
+export * from './vector-store.js';
+export * from './reranker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './memory-store.js';
+export * from './file-store.js';
+export * from './memory-manager.js';
+export * from './embeddings.js';
+export * from './vector-store.js';
+export * from './reranker.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/dist/memory-manager.d.ts

@@ -0,0 +1,19 @@
+import { MemoryConfig, MemoryType, MemoryMetadata, MemorySearchOptions, MemoryEntry, Message, ILogger, IEventEmitter } from '@astrive-ai/types';
+export declare class MemoryManager {
+    private logger;
+    private events;
+    private store;
+    private vectorStore;
+    private reranker;
+    constructor(config: Partial<MemoryConfig> | undefined, logger: ILogger, events: IEventEmitter);
+    addMemory(content: string, type: MemoryType, metadata?: Partial<MemoryMetadata>): Promise<string>;
+    searchMemories(query: string, options?: MemorySearchOptions): Promise<MemoryEntry[]>;
+    getRelevantContext(prompt: string, limit?: number): Promise<string>;
+    extractAndSaveMemories(messages: Message[]): Promise<void>;
+    get(id: string): Promise<MemoryEntry | null>;
+    update(id: string, partial: Partial<MemoryEntry>): Promise<void>;
+    delete(id: string): Promise<void>;
+    clear(): Promise<void>;
+    getStats(): Promise<import("@astrive-ai/types").MemoryStats>;
+}
+//# sourceMappingURL=memory-manager.d.ts.map

package/dist/memory-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-manager.d.ts","sourceRoot":"","sources":["../src/memory-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EACZ,UAAU,EACV,cAAc,EACd,mBAAmB,EACnB,WAAW,EACX,OAAO,EACP,OAAO,EACP,aAAa,EACd,MAAM,mBAAmB,CAAC;AAO3B,qBAAa,aAAa;IAOtB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IAPhB,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAW;gBAGzB,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,EACjC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,aAAa;IAgBlB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBrG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAKpF,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBtE,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1D,GAAG,CAAC,EAAE,EAAE,MAAM;IACd,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC;IAChD,MAAM,CAAC,EAAE,EAAE,MAAM;IACjB,KAAK;IACL,QAAQ;CACtB"}

package/dist/memory-manager.js

@@ -0,0 +1,87 @@
+import { InMemoryStore } from './memory-store.js';
+import { FileMemoryStore } from './file-store.js';
+import { VectorStore } from './vector-store.js';
+import { Reranker } from './reranker.js';
+import { randomUUID } from 'crypto';
+export class MemoryManager {
+    logger;
+    events;
+    store;
+    vectorStore;
+    reranker;
+    constructor(config, logger, events) {
+        this.logger = logger;
+        this.events = events;
+        const maxEntries = config?.maxEntries || 1000;
+        if (config?.store === 'file' && config.filePath) {
+            const fileStore = new FileMemoryStore(config.filePath, maxEntries);
+            fileStore.init().catch(e => logger.error('Failed to init FileMemoryStore', e));
+            this.store = fileStore;
+        }
+        else {
+            this.store = new InMemoryStore(maxEntries);
+        }
+        this.vectorStore = new VectorStore();
+        this.reranker = new Reranker();
+    }
+    async addMemory(content, type, metadata = {}) {
+        const importance = Math.min(10, Math.ceil(content.length / 100)); // basic scoring
+        const fullMetadata = {
+            source: 'user',
+            importance,
+            tags: [],
+            ...metadata
+        };
+        const entry = {
+            id: randomUUID(),
+            content,
+            type,
+            metadata: fullMetadata,
+            createdAt: Date.now(),
+            updatedAt: Date.now()
+        };
+        const id = await this.store.add(entry);
+        await this.vectorStore.add(entry);
+        this.events.emit('memory:save', { id, type, importance });
+        this.logger.debug(`Saved memory ${id}`);
+        return id;
+    }
+    async searchMemories(query, options) {
+        this.events.emit('memory:search', { query, options });
+        return this.store.search(query, options);
+    }
+    async getRelevantContext(prompt, limit = 5) {
+        // Basic store search
+        const textMemories = await this.searchMemories(prompt, { limit });
+        // Vector search
+        const vectorResults = await this.vectorStore.search(prompt, limit * 2);
+        // Combine and deduplicate
+        const combined = new Map();
+        for (const m of textMemories) {
+            combined.set(m.id, { entry: m, score: 0.5 });
+        }
+        for (const v of vectorResults) {
+            combined.set(v.entry.id, v);
+        }
+        const combinedList = Array.from(combined.values());
+        // Rerank
+        const ranked = this.reranker.rerank(prompt, combinedList).slice(0, limit);
+        if (ranked.length === 0)
+            return '';
+        return ranked.map(r => r.entry.content).join('\n---\n');
+    }
+    async extractAndSaveMemories(messages) {
+        for (const msg of messages) {
+            if (msg.role === 'user' && msg.content.length > 50) {
+                await this.addMemory(msg.content, 'conversation', { tags: ['extracted'] });
+            }
+        }
+    }
+    // Delegated methods
+    async get(id) { return this.store.get(id); }
+    async update(id, partial) { return this.store.update(id, partial); }
+    async delete(id) { return this.store.delete(id); }
+    async clear() { return this.store.clear(); }
+    async getStats() { return this.store.getStats(); }
+}
+//# sourceMappingURL=memory-manager.js.map

package/dist/memory-manager.js.map

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

package/dist/memory-store.d.ts

@@ -0,0 +1,15 @@
+import { IMemoryStore, MemoryEntry, MemorySearchOptions, MemoryStats } from '@astrive-ai/types';
+export declare class InMemoryStore implements IMemoryStore {
+    protected entries: Map<string, MemoryEntry>;
+    protected maxEntries: number;
+    constructor(maxEntries?: number);
+    add(entry: MemoryEntry): Promise<string>;
+    search(query: string, options?: MemorySearchOptions): Promise<MemoryEntry[]>;
+    get(id: string): Promise<MemoryEntry | null>;
+    update(id: string, partial: Partial<MemoryEntry>): Promise<void>;
+    delete(id: string): Promise<void>;
+    clear(): Promise<void>;
+    getStats(): Promise<MemoryStats>;
+    private evictOldest;
+}
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../src/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,WAAW,EAEZ,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,aAAc,YAAW,YAAY;IAChD,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAa;IACxD,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEjB,UAAU,GAAE,MAAa;IAIxB,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAcxC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IA+B5E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAI5C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOhE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAgB7C,OAAO,CAAC,WAAW;CAgBpB"}

package/dist/memory-store.js

@@ -0,0 +1,91 @@
+export class InMemoryStore {
+    entries = new Map();
+    maxEntries;
+    constructor(maxEntries = 1000) {
+        this.maxEntries = maxEntries;
+    }
+    async add(entry) {
+        if (this.entries.size >= this.maxEntries) {
+            this.evictOldest();
+        }
+        // Ensure entry has an id if not provided, though the type might require it.
+        // If it doesn't have an ID, we'll generate one (useful if called loosely).
+        const id = entry.id || `mem_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+        const newEntry = { ...entry, id };
+        this.entries.set(id, newEntry);
+        return id;
+    }
+    async search(query, options) {
+        const keywords = query.toLowerCase().split(/\s+/).filter(w => w.length > 2);
+        const results = [];
+        for (const entry of this.entries.values()) {
+            let score = 0;
+            const content = entry.content.toLowerCase();
+            for (const kw of keywords) {
+                if (content.includes(kw)) {
+                    score += 1;
+                }
+            }
+            if (score > 0) {
+                if (options?.types && !options.types.includes(entry.type))
+                    continue;
+                if (options?.tags && !options.tags.some(t => entry.metadata?.tags?.includes(t)))
+                    continue;
+                if (options?.dateRange) {
+                    const time = entry.createdAt;
+                    if (options.dateRange.from && time < options.dateRange.from)
+                        continue;
+                    if (options.dateRange.to && time > options.dateRange.to)
+                        continue;
+                }
+                results.push({ entry, score });
+            }
+        }
+        results.sort((a, b) => b.score - a.score);
+        const limit = options?.limit || 10;
+        return results.slice(0, limit).map(r => r.entry);
+    }
+    async get(id) {
+        return this.entries.get(id) || null;
+    }
+    async update(id, partial) {
+        const entry = this.entries.get(id);
+        if (entry) {
+            this.entries.set(id, { ...entry, ...partial, updatedAt: Date.now() });
+        }
+    }
+    async delete(id) {
+        this.entries.delete(id);
+    }
+    async clear() {
+        this.entries.clear();
+    }
+    async getStats() {
+        let size = 0;
+        const byType = {};
+        for (const entry of this.entries.values()) {
+            size += entry.content.length;
+            byType[entry.type] = (byType[entry.type] || 0) + 1;
+        }
+        return {
+            totalEntries: this.entries.size,
+            storageBytes: size,
+            byType
+        };
+    }
+    evictOldest() {
+        let oldestId = null;
+        let oldestTime = Infinity;
+        for (const [id, entry] of this.entries.entries()) {
+            const time = entry.createdAt || 0;
+            if (time < oldestTime) {
+                oldestTime = time;
+                oldestId = id;
+            }
+        }
+        if (oldestId) {
+            this.entries.delete(oldestId);
+        }
+    }
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/memory-store.js.map

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

package/dist/reranker.d.ts

@@ -0,0 +1,9 @@
+import { VectorSearchResult } from './vector-store.js';
+export declare class Reranker {
+    /**
+     * Reranks a set of search results based on a combined score of vector similarity,
+     * recency, and importance.
+     */
+    rerank(query: string, results: VectorSearchResult[]): VectorSearchResult[];
+}
+//# sourceMappingURL=reranker.d.ts.map

package/dist/reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranker.d.ts","sourceRoot":"","sources":["../src/reranker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,qBAAa,QAAQ;IACnB;;;OAGG;IACI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,EAAE;CAoClF"}

package/dist/reranker.js

@@ -0,0 +1,37 @@
+export class Reranker {
+    /**
+     * Reranks a set of search results based on a combined score of vector similarity,
+     * recency, and importance.
+     */
+    rerank(query, results) {
+        const now = Date.now();
+        return results.map(result => {
+            const { entry, score: simScore } = result;
+            // Calculate recency score (0.0 to 1.0)
+            // Exponential decay over time (e.g., half-life of 7 days)
+            const ageMs = Math.max(0, now - entry.updatedAt);
+            const sevenDaysMs = 7 * 24 * 60 * 60 * 1000;
+            const recencyScore = Math.exp(-ageMs / sevenDaysMs);
+            // Get importance from metadata (0.0 to 1.0, default 0.5)
+            const importance = typeof entry.metadata?.importance === 'number'
+                ? entry.metadata.importance
+                : 0.5;
+            // Also slight boost if query keywords match content directly (lexical match)
+            const queryTerms = query.toLowerCase().split(/\s+/).filter(t => t.length > 2);
+            const contentLower = entry.content.toLowerCase();
+            let lexicalScore = 0;
+            for (const term of queryTerms) {
+                if (contentLower.includes(term))
+                    lexicalScore += 0.1;
+            }
+            lexicalScore = Math.min(1.0, lexicalScore);
+            // Final combined score weights
+            const finalScore = (simScore * 0.6) +
+                (recencyScore * 0.15) +
+                (importance * 0.15) +
+                (lexicalScore * 0.10);
+            return { entry, score: finalScore };
+        }).sort((a, b) => b.score - a.score);
+    }
+}
+//# sourceMappingURL=reranker.js.map

package/dist/reranker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranker.js","sourceRoot":"","sources":["../src/reranker.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,QAAQ;IACnB;;;OAGG;IACI,MAAM,CAAC,KAAa,EAAE,OAA6B;QACxD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;YAC1B,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;YAE1C,uCAAuC;YACvC,0DAA0D;YAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;YACjD,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;YAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,WAAW,CAAC,CAAC;YAEpD,yDAAyD;YACzD,MAAM,UAAU,GAAG,OAAO,KAAK,CAAC,QAAQ,EAAE,UAAU,KAAK,QAAQ;gBAC/D,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU;gBAC3B,CAAC,CAAC,GAAG,CAAC;YAER,6EAA6E;YAC7E,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC9E,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACjD,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;gBAC9B,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;oBAAE,YAAY,IAAI,GAAG,CAAC;YACvD,CAAC;YACD,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAE3C,+BAA+B;YAC/B,MAAM,UAAU,GACd,CAAC,QAAQ,GAAG,GAAG,CAAC;gBAChB,CAAC,YAAY,GAAG,IAAI,CAAC;gBACrB,CAAC,UAAU,GAAG,IAAI,CAAC;gBACnB,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;YAExB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QACtC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/vector-store.d.ts

@@ -0,0 +1,18 @@
+import { MemoryEntry } from '@astrive-ai/types';
+import { EmbeddingModel } from './embeddings.js';
+export interface VectorSearchResult {
+    entry: MemoryEntry;
+    score: number;
+}
+export declare class VectorStore {
+    private entries;
+    private embeddingModel;
+    constructor(embeddingModel?: EmbeddingModel);
+    add(entry: MemoryEntry): Promise<string>;
+    addBatch(entries: MemoryEntry[]): Promise<string[]>;
+    search(query: string, topK?: number): Promise<VectorSearchResult[]>;
+    get(id: string): MemoryEntry | undefined;
+    delete(id: string): boolean;
+    private cosineSimilarity;
+}
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../src/vector-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,cAAc,CAAiB;gBAE3B,cAAc,CAAC,EAAE,cAAc;IAI9B,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQnD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAU,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAgB5E,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIxC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIlC,OAAO,CAAC,gBAAgB;CAgBzB"}

package/dist/vector-store.js

@@ -0,0 +1,57 @@
+import { EmbeddingModel } from './embeddings.js';
+export class VectorStore {
+    entries = new Map();
+    embeddingModel;
+    constructor(embeddingModel) {
+        this.embeddingModel = embeddingModel || new EmbeddingModel();
+    }
+    async add(entry) {
+        if (!entry.embedding) {
+            entry.embedding = await this.embeddingModel.embedText(entry.content);
+        }
+        this.entries.set(entry.id, entry);
+        return entry.id;
+    }
+    async addBatch(entries) {
+        const ids = [];
+        for (const entry of entries) {
+            ids.push(await this.add(entry));
+        }
+        return ids;
+    }
+    async search(query, topK = 5) {
+        const queryVector = await this.embeddingModel.embedText(query);
+        const results = [];
+        for (const entry of this.entries.values()) {
+            if (entry.embedding) {
+                const score = this.cosineSimilarity(queryVector, entry.embedding);
+                results.push({ entry, score });
+            }
+        }
+        return results
+            .sort((a, b) => b.score - a.score)
+            .slice(0, topK);
+    }
+    get(id) {
+        return this.entries.get(id);
+    }
+    delete(id) {
+        return this.entries.delete(id);
+    }
+    cosineSimilarity(vecA, vecB) {
+        if (vecA.length !== vecB.length)
+            return 0;
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < vecA.length; i++) {
+            dotProduct += vecA[i] * vecB[i];
+            normA += vecA[i] * vecA[i];
+            normB += vecB[i] * vecB[i];
+        }
+        if (normA === 0 || normB === 0)
+            return 0;
+        return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+    }
+}
+//# sourceMappingURL=vector-store.js.map

package/dist/vector-store.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@astrive-ai/memory",
+  "version": "1.0.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@astrive-ai/types": "*",
+    "@astrive-ai/logger": "*",
+    "@astrive-ai/events": "*"
+  },
+  "devDependencies": {
+    "typescript": "5.4.5",
+    "@types/node": "^20.0.0"
+  }
+}

package/src/embeddings.ts

@@ -0,0 +1,55 @@
+import { IProvider } from '@astrive-ai/types';
+
+export interface EmbeddingResult {
+  text: string;
+  vector: number[];
+}
+
+export class EmbeddingModel {
+  private provider?: IProvider;
+  private modelName: string;
+
+  constructor(provider?: IProvider, modelName: string = 'text-embedding-3-small') {
+    this.provider = provider;
+    this.modelName = modelName;
+  }
+
+  public async embedText(text: string): Promise<number[]> {
+    if (!this.provider) {
+      // Mock embedding if no provider
+      return this.mockEmbedding(text, 1536);
+    }
+    
+    // In a real implementation, this would call the provider's embedding endpoint
+    // For now, if the provider doesn't support embeddings explicitly, we mock it or 
+    // implement a standard fetch to an embeddings API.
+    return this.mockEmbedding(text, 1536);
+  }
+
+  public async embedBatch(texts: string[]): Promise<EmbeddingResult[]> {
+    const results: EmbeddingResult[] = [];
+    for (const text of texts) {
+      const vector = await this.embedText(text);
+      results.push({ text, vector });
+    }
+    return results;
+  }
+
+  private mockEmbedding(text: string, dimensions: number): number[] {
+    // Generate a deterministic pseudo-random vector based on text
+    let hash = 0;
+    for (let i = 0; i < text.length; i++) {
+      hash = ((hash << 5) - hash) + text.charCodeAt(i);
+      hash = hash & hash;
+    }
+    
+    const vector = new Array(dimensions);
+    for (let i = 0; i < dimensions; i++) {
+      vector[i] = Math.sin(hash + i);
+    }
+    
+    // Normalize
+    const magnitude = Math.sqrt(vector.reduce((sum, val) => sum + val * val, 0));
+    return vector.map(val => val / (magnitude || 1));
+  }
+}

package/src/file-store.ts

@@ -0,0 +1,62 @@
+import { InMemoryStore } from './memory-store.js';
+import { MemoryEntry } from '@astrive-ai/types';
+import fs from 'fs/promises';
+
+export class FileMemoryStore extends InMemoryStore {
+  private filePath: string;
+  private saveTimeout: NodeJS.Timeout | null = null;
+
+  constructor(filePath: string, maxEntries: number = 1000) {
+    super(maxEntries);
+    this.filePath = filePath;
+  }
+
+  public async init(): Promise<void> {
+    try {
+      const data = await fs.readFile(this.filePath, 'utf-8');
+      const parsed: MemoryEntry[] = JSON.parse(data);
+      for (const entry of parsed) {
+        this.entries.set(entry.id, entry);
+      }
+    } catch (e: any) {
+      if (e.code !== 'ENOENT') {
+        throw e;
+      }
+    }
+  }
+
+  public async add(entry: MemoryEntry): Promise<string> {
+    const id = await super.add(entry);
+    this.scheduleSave();
+    return id;
+  }
+
+  public async update(id: string, partial: Partial<MemoryEntry>): Promise<void> {
+    await super.update(id, partial);
+    this.scheduleSave();
+  }
+
+  public async delete(id: string): Promise<void> {
+    await super.delete(id);
+    this.scheduleSave();
+  }
+
+  public async clear(): Promise<void> {
+    await super.clear();
+    this.scheduleSave();
+  }
+
+  private scheduleSave(): void {
+    if (this.saveTimeout) {
+      clearTimeout(this.saveTimeout);
+    }
+    this.saveTimeout = setTimeout(() => {
+      this.saveToDisk();
+    }, 500);
+  }
+
+  private async saveToDisk(): Promise<void> {
+    const data = JSON.stringify(Array.from(this.entries.values()), null, 2);
+    await fs.writeFile(this.filePath, data, 'utf-8');
+  }
+}

package/src/index.ts

@@ -0,0 +1,6 @@
+export * from './memory-store.js';
+export * from './file-store.js';
+export * from './memory-manager.js';
+export * from './embeddings.js';
+export * from './vector-store.js';
+export * from './reranker.js';

package/src/memory-manager.ts

@@ -0,0 +1,111 @@
+import {
+  IMemoryStore,
+  MemoryConfig,
+  MemoryType,
+  MemoryMetadata,
+  MemorySearchOptions,
+  MemoryEntry,
+  Message,
+  ILogger,
+  IEventEmitter
+} from '@astrive-ai/types';
+import { InMemoryStore } from './memory-store.js';
+import { FileMemoryStore } from './file-store.js';
+import { VectorStore } from './vector-store.js';
+import { Reranker } from './reranker.js';
+import { randomUUID } from 'crypto';
+
+export class MemoryManager {
+  private store: IMemoryStore;
+  private vectorStore: VectorStore;
+  private reranker: Reranker;
+
+  constructor(
+    config: Partial<MemoryConfig> | undefined,
+    private logger: ILogger,
+    private events: IEventEmitter
+  ) {
+    const maxEntries = config?.maxEntries || 1000;
+    
+    if (config?.store === 'file' && config.filePath) {
+      const fileStore = new FileMemoryStore(config.filePath, maxEntries);
+      fileStore.init().catch(e => logger.error('Failed to init FileMemoryStore', e));
+      this.store = fileStore;
+    } else {
+      this.store = new InMemoryStore(maxEntries);
+    }
+    
+    this.vectorStore = new VectorStore();
+    this.reranker = new Reranker();
+  }
+
+  public async addMemory(content: string, type: MemoryType, metadata: Partial<MemoryMetadata> = {}): Promise<string> {
+    const importance = Math.min(10, Math.ceil(content.length / 100)); // basic scoring
+    const fullMetadata: MemoryMetadata = {
+      source: 'user',
+      importance,
+      tags: [],
+      ...metadata
+    };
+
+    const entry: MemoryEntry = {
+      id: randomUUID(),
+      content,
+      type,
+      metadata: fullMetadata,
+      createdAt: Date.now(),
+      updatedAt: Date.now()
+    };
+
+    const id = await this.store.add(entry);
+    await this.vectorStore.add(entry);
+    this.events.emit('memory:save', { id, type, importance });
+    this.logger.debug(`Saved memory ${id}`);
+    return id;
+  }
+
+  public async searchMemories(query: string, options?: MemorySearchOptions): Promise<MemoryEntry[]> {
+    this.events.emit('memory:search', { query, options });
+    return this.store.search(query, options);
+  }
+
+  public async getRelevantContext(prompt: string, limit: number = 5): Promise<string> {
+    // Basic store search
+    const textMemories = await this.searchMemories(prompt, { limit });
+    
+    // Vector search
+    const vectorResults = await this.vectorStore.search(prompt, limit * 2);
+    
+    // Combine and deduplicate
+    const combined = new Map<string, any>();
+    for (const m of textMemories) {
+      combined.set(m.id, { entry: m, score: 0.5 });
+    }
+    for (const v of vectorResults) {
+      combined.set(v.entry.id, v);
+    }
+    
+    const combinedList = Array.from(combined.values());
+    
+    // Rerank
+    const ranked = this.reranker.rerank(prompt, combinedList).slice(0, limit);
+    
+    if (ranked.length === 0) return '';
+    return ranked.map(r => r.entry.content).join('\n---\n');
+  }
+
+  public async extractAndSaveMemories(messages: Message[]): Promise<void> {
+    for (const msg of messages) {
+      if (msg.role === 'user' && msg.content.length > 50) {
+        await this.addMemory(msg.content, 'conversation', { tags: ['extracted'] });
+      }
+    }
+  }
+
+  // Delegated methods
+  public async get(id: string) { return this.store.get(id); }
+  public async update(id: string, partial: Partial<MemoryEntry>) { return this.store.update(id, partial); }
+  public async delete(id: string) { return this.store.delete(id); }
+  public async clear() { return this.store.clear(); }
+  public async getStats() { return this.store.getStats(); }
+}

package/src/memory-store.ts

@@ -0,0 +1,113 @@
+import {
+  IMemoryStore,
+  MemoryEntry,
+  MemorySearchOptions,
+  MemoryStats,
+  MemoryType
+} from '@astrive-ai/types';
+
+export class InMemoryStore implements IMemoryStore {
+  protected entries: Map<string, MemoryEntry> = new Map();
+  protected maxEntries: number;
+
+  constructor(maxEntries: number = 1000) {
+    this.maxEntries = maxEntries;
+  }
+
+  public async add(entry: MemoryEntry): Promise<string> {
+    if (this.entries.size >= this.maxEntries) {
+      this.evictOldest();
+    }
+    
+    // Ensure entry has an id if not provided, though the type might require it.
+    // If it doesn't have an ID, we'll generate one (useful if called loosely).
+    const id = entry.id || `mem_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+    const newEntry: MemoryEntry = { ...entry, id };
+    
+    this.entries.set(id, newEntry);
+    return id;
+  }
+
+  public async search(query: string, options?: MemorySearchOptions): Promise<MemoryEntry[]> {
+    const keywords = query.toLowerCase().split(/\s+/).filter(w => w.length > 2);
+    const results: { entry: MemoryEntry; score: number }[] = [];
+
+    for (const entry of this.entries.values()) {
+      let score = 0;
+      const content = entry.content.toLowerCase();
+      
+      for (const kw of keywords) {
+        if (content.includes(kw)) {
+          score += 1;
+        }
+      }
+
+      if (score > 0) {
+        if (options?.types && !options.types.includes(entry.type)) continue;
+        if (options?.tags && !options.tags.some(t => entry.metadata?.tags?.includes(t))) continue;
+        if (options?.dateRange) {
+           const time = entry.createdAt;
+           if (options.dateRange.from && time < options.dateRange.from) continue;
+           if (options.dateRange.to && time > options.dateRange.to) continue;
+        }
+        results.push({ entry, score });
+      }
+    }
+
+    results.sort((a, b) => b.score - a.score);
+    const limit = options?.limit || 10;
+    return results.slice(0, limit).map(r => r.entry);
+  }
+
+  public async get(id: string): Promise<MemoryEntry | null> {
+    return this.entries.get(id) || null;
+  }
+
+  public async update(id: string, partial: Partial<MemoryEntry>): Promise<void> {
+    const entry = this.entries.get(id);
+    if (entry) {
+      this.entries.set(id, { ...entry, ...partial, updatedAt: Date.now() });
+    }
+  }
+
+  public async delete(id: string): Promise<void> {
+    this.entries.delete(id);
+  }
+
+  public async clear(): Promise<void> {
+    this.entries.clear();
+  }
+
+  public async getStats(): Promise<MemoryStats> {
+    let size = 0;
+    const byType: Record<MemoryType, number> = {} as any;
+
+    for (const entry of this.entries.values()) {
+      size += entry.content.length; 
+      byType[entry.type] = (byType[entry.type] || 0) + 1;
+    }
+
+    return {
+      totalEntries: this.entries.size,
+      storageBytes: size,
+      byType
+    };
+  }
+
+  private evictOldest(): void {
+    let oldestId: string | null = null;
+    let oldestTime = Infinity;
+
+    for (const [id, entry] of this.entries.entries()) {
+      const time = entry.createdAt || 0;
+      if (time < oldestTime) {
+        oldestTime = time;
+        oldestId = id;
+      }
+    }
+
+    if (oldestId) {
+      this.entries.delete(oldestId);
+    }
+  }
+}

package/src/reranker.ts

@@ -0,0 +1,45 @@
+import { MemoryEntry } from '@astrive-ai/types';
+import { VectorSearchResult } from './vector-store.js';
+
+export class Reranker {
+  /**
+   * Reranks a set of search results based on a combined score of vector similarity, 
+   * recency, and importance.
+   */
+  public rerank(query: string, results: VectorSearchResult[]): VectorSearchResult[] {
+    const now = Date.now();
+    
+    return results.map(result => {
+      const { entry, score: simScore } = result;
+      
+      // Calculate recency score (0.0 to 1.0)
+      // Exponential decay over time (e.g., half-life of 7 days)
+      const ageMs = Math.max(0, now - entry.updatedAt);
+      const sevenDaysMs = 7 * 24 * 60 * 60 * 1000;
+      const recencyScore = Math.exp(-ageMs / sevenDaysMs);
+      
+      // Get importance from metadata (0.0 to 1.0, default 0.5)
+      const importance = typeof entry.metadata?.importance === 'number' 
+        ? entry.metadata.importance 
+        : 0.5;
+        
+      // Also slight boost if query keywords match content directly (lexical match)
+      const queryTerms = query.toLowerCase().split(/\s+/).filter(t => t.length > 2);
+      const contentLower = entry.content.toLowerCase();
+      let lexicalScore = 0;
+      for (const term of queryTerms) {
+        if (contentLower.includes(term)) lexicalScore += 0.1;
+      }
+      lexicalScore = Math.min(1.0, lexicalScore);
+
+      // Final combined score weights
+      const finalScore = 
+        (simScore * 0.6) + 
+        (recencyScore * 0.15) + 
+        (importance * 0.15) + 
+        (lexicalScore * 0.10);
+        
+      return { entry, score: finalScore };
+    }).sort((a, b) => b.score - a.score);
+  }
+}

package/src/vector-store.ts

@@ -0,0 +1,73 @@
+import { MemoryEntry } from '@astrive-ai/types';
+import { EmbeddingModel } from './embeddings.js';
+
+export interface VectorSearchResult {
+  entry: MemoryEntry;
+  score: number;
+}
+
+export class VectorStore {
+  private entries: Map<string, MemoryEntry> = new Map();
+  private embeddingModel: EmbeddingModel;
+
+  constructor(embeddingModel?: EmbeddingModel) {
+    this.embeddingModel = embeddingModel || new EmbeddingModel();
+  }
+
+  public async add(entry: MemoryEntry): Promise<string> {
+    if (!entry.embedding) {
+      entry.embedding = await this.embeddingModel.embedText(entry.content);
+    }
+    this.entries.set(entry.id, entry);
+    return entry.id;
+  }
+
+  public async addBatch(entries: MemoryEntry[]): Promise<string[]> {
+    const ids: string[] = [];
+    for (const entry of entries) {
+      ids.push(await this.add(entry));
+    }
+    return ids;
+  }
+
+  public async search(query: string, topK: number = 5): Promise<VectorSearchResult[]> {
+    const queryVector = await this.embeddingModel.embedText(query);
+    const results: VectorSearchResult[] = [];
+
+    for (const entry of this.entries.values()) {
+      if (entry.embedding) {
+        const score = this.cosineSimilarity(queryVector, entry.embedding);
+        results.push({ entry, score });
+      }
+    }
+
+    return results
+      .sort((a, b) => b.score - a.score)
+      .slice(0, topK);
+  }
+  
+  public get(id: string): MemoryEntry | undefined {
+    return this.entries.get(id);
+  }
+  
+  public delete(id: string): boolean {
+    return this.entries.delete(id);
+  }
+
+  private cosineSimilarity(vecA: number[], vecB: number[]): number {
+    if (vecA.length !== vecB.length) return 0;
+    
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    
+    for (let i = 0; i < vecA.length; i++) {
+      dotProduct += vecA[i] * vecB[i];
+      normA += vecA[i] * vecA[i];
+      normB += vecB[i] * vecB[i];
+    }
+    
+    if (normA === 0 || normB === 0) return 0;
+    return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB));
+  }
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"]
+}