@hazeljs/memory 0.2.0-alpha.3

package/dist/store/adapters/redis.store.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Redis memory store adapter.
+ * Pass a Redis client (e.g. from "ioredis") so this package has no direct redis dependency.
+ */
+import { MemoryItem } from '../../types/memory-item.types';
+import { MemoryQuery, MemorySearchOptions, MemoryStats, PruneOptions } from '../../types/store.types';
+import { MemoryStore } from '../memory-store.interface';
+export interface RedisStoreOptions {
+    /** Redis client with get, set, del, sadd, smembers, srem, keys (or scan), mget. */
+    client: {
+        get(key: string): Promise<string | null>;
+        set(key: string, value: string, ...args: string[]): Promise<unknown>;
+        del(...keys: string[]): Promise<number>;
+        sadd(key: string, ...members: string[]): Promise<number>;
+        smembers(key: string): Promise<string[]>;
+        srem(key: string, ...members: string[]): Promise<number>;
+        mget(...keys: string[]): Promise<(string | null)[]>;
+        keys(pattern: string): Promise<string[]>;
+    };
+    /** Key prefix. Default: memory */
+    keyPrefix?: string;
+    /** Default TTL in seconds for keys with expiresAt (emotional). */
+    defaultTtlSeconds?: number;
+}
+export declare class RedisStore implements MemoryStore {
+    private readonly client;
+    private readonly prefix;
+    private readonly defaultTtlSeconds;
+    constructor(options: RedisStoreOptions);
+    initialize(): Promise<void>;
+    private serialize;
+    private static deserialize;
+    save(item: MemoryItem): Promise<string>;
+    saveBatch(items: MemoryItem[]): Promise<string[]>;
+    get(id: string): Promise<MemoryItem | null>;
+    update(id: string, updates: Partial<MemoryItem>): Promise<void>;
+    delete(id: string): Promise<void>;
+    deleteBatch(ids: string[]): Promise<void>;
+    query(options: MemoryQuery): Promise<MemoryItem[]>;
+    search(query: string | number[], options: MemorySearchOptions): Promise<MemoryItem[]>;
+    getStats(userId?: string): Promise<MemoryStats>;
+    prune(options?: PruneOptions): Promise<number>;
+}
+//# sourceMappingURL=redis.store.d.ts.map

package/dist/store/adapters/redis.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.store.d.ts","sourceRoot":"","sources":["../../../src/store/adapters/redis.store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,MAAM,EAAE;QACN,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACrE,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACzD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;KAC1C,CAAC;IACF,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAgBD,qBAAa,UAAW,YAAW,WAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IACrD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;gBAE/B,OAAO,EAAE,iBAAiB;IAMhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,MAAM,CAAC,WAAW;IAUpB,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBvC,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQjD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAY3C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAqDlD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAgBrF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAuD/C,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CA8BrD"}

package/dist/store/adapters/redis.store.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * Redis memory store adapter.
+ * Pass a Redis client (e.g. from "ioredis") so this package has no direct redis dependency.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisStore = void 0;
+const category_types_1 = require("../../types/category.types");
+const DEFAULT_PREFIX = 'memory';
+function itemKey(prefix, id) {
+    return `${prefix}:item:${id}`;
+}
+function userSetKey(prefix, userId) {
+    return `${prefix}:user:${userId}:ids`;
+}
+function userCategorySetKey(prefix, userId, category) {
+    return `${prefix}:user:${userId}:${category}:ids`;
+}
+class RedisStore {
+    constructor(options) {
+        this.client = options.client;
+        this.prefix = options.keyPrefix ?? DEFAULT_PREFIX;
+        this.defaultTtlSeconds = options.defaultTtlSeconds ?? 30 * 60; // 30 min
+    }
+    async initialize() {
+        // No schema needed for Redis
+    }
+    serialize(item) {
+        return JSON.stringify({
+            ...item,
+            createdAt: item.createdAt.toISOString(),
+            updatedAt: item.updatedAt.toISOString(),
+            expiresAt: item.expiresAt?.toISOString(),
+        });
+    }
+    static deserialize(raw) {
+        const o = JSON.parse(raw);
+        return {
+            ...o,
+            createdAt: new Date(o.createdAt),
+            updatedAt: new Date(o.updatedAt),
+            expiresAt: o.expiresAt ? new Date(o.expiresAt) : undefined,
+        };
+    }
+    async save(item) {
+        const key = itemKey(this.prefix, item.id);
+        const value = this.serialize(item);
+        const ttl = item.expiresAt != null
+            ? Math.max(0, Math.ceil((item.expiresAt.getTime() - Date.now()) / 1000))
+            : item.category === category_types_1.MemoryCategory.EMOTIONAL
+                ? this.defaultTtlSeconds
+                : 0;
+        if (ttl > 0) {
+            await this.client.set(key, value, 'EX', String(ttl));
+        }
+        else {
+            await this.client.set(key, value);
+        }
+        await this.client.sadd(userSetKey(this.prefix, item.userId), item.id);
+        await this.client.sadd(userCategorySetKey(this.prefix, item.userId, item.category), item.id);
+        return item.id;
+    }
+    async saveBatch(items) {
+        const ids = [];
+        for (const item of items) {
+            ids.push(await this.save(item));
+        }
+        return ids;
+    }
+    async get(id) {
+        const key = itemKey(this.prefix, id);
+        const raw = await this.client.get(key);
+        if (!raw)
+            return null;
+        const item = RedisStore.deserialize(raw);
+        if (item.expiresAt && item.expiresAt.getTime() < Date.now()) {
+            await this.delete(id);
+            return null;
+        }
+        return item;
+    }
+    async update(id, updates) {
+        const existing = await this.get(id);
+        if (!existing)
+            return;
+        const updated = {
+            ...existing,
+            ...updates,
+            id: existing.id,
+            userId: existing.userId,
+            category: existing.category,
+            key: existing.key,
+            updatedAt: new Date(),
+        };
+        await this.save(updated);
+    }
+    async delete(id) {
+        const item = await this.get(id);
+        const key = itemKey(this.prefix, id);
+        await this.client.del(key);
+        if (item) {
+            await this.client.srem(userSetKey(this.prefix, item.userId), id);
+            await this.client.srem(userCategorySetKey(this.prefix, item.userId, item.category), id);
+        }
+    }
+    async deleteBatch(ids) {
+        for (const id of ids) {
+            await this.delete(id);
+        }
+    }
+    async query(options) {
+        const categories = options.category != null
+            ? Array.isArray(options.category)
+                ? options.category
+                : [options.category]
+            : Object.values(category_types_1.MemoryCategory);
+        let ids = [];
+        for (const cat of categories) {
+            const setKey = userCategorySetKey(this.prefix, options.userId, cat);
+            const memberIds = await this.client.smembers(setKey);
+            ids = ids.concat(memberIds);
+        }
+        ids = [...new Set(ids)];
+        if (ids.length === 0)
+            return [];
+        const keys = ids.map((id) => itemKey(this.prefix, id));
+        const raws = await this.client.mget(...keys);
+        const items = [];
+        const now = Date.now();
+        for (let i = 0; i < raws.length; i++) {
+            const raw = raws[i];
+            if (!raw)
+                continue;
+            const item = RedisStore.deserialize(raw);
+            if (item.expiresAt && item.expiresAt.getTime() < now) {
+                await this.delete(item.id);
+                continue;
+            }
+            if (options.source != null) {
+                const srcs = Array.isArray(options.source) ? options.source : [options.source];
+                if (!srcs.includes(item.source))
+                    continue;
+            }
+            if (options.minConfidence != null && item.confidence < options.minConfidence)
+                continue;
+            if (options.notExpired !== false && item.expiresAt && item.expiresAt.getTime() < now)
+                continue;
+            items.push(item);
+        }
+        const orderBy = options.orderBy ?? 'updatedAt';
+        const order = options.order ?? 'desc';
+        items.sort((a, b) => {
+            const ta = a[orderBy].getTime();
+            const tb = b[orderBy].getTime();
+            return order === 'asc' ? ta - tb : tb - ta;
+        });
+        const offset = options.offset ?? 0;
+        const limit = options.limit ?? 100;
+        return items.slice(offset, offset + limit);
+    }
+    async search(query, options) {
+        if (typeof query !== 'string')
+            return [];
+        const q = query.toLowerCase();
+        const items = await this.query({
+            userId: options.userId,
+            category: options.category,
+            limit: options.topK ?? 10,
+        });
+        const filtered = items.filter((m) => (typeof m.value === 'string' && m.value.toLowerCase().includes(q)) ||
+            m.key.toLowerCase().includes(q));
+        return filtered.slice(0, options.topK ?? 10);
+    }
+    async getStats(userId) {
+        const byCategory = Object.values(category_types_1.MemoryCategory).reduce((acc, cat) => ({ ...acc, [cat]: 0 }), {});
+        const iterateUserIds = userId
+            ? [userId]
+            : (await this.client.keys(`${this.prefix}:user:*:ids`))
+                .map((k) => {
+                const m = k.match(new RegExp(`^${this.prefix}:user:(.+):ids$`));
+                return m ? m[1] : '';
+            })
+                .filter(Boolean);
+        const now = Date.now();
+        for (const uid of iterateUserIds) {
+            const ids = await this.client.smembers(userSetKey(this.prefix, uid));
+            const keys = ids.map((id) => itemKey(this.prefix, id));
+            if (keys.length === 0)
+                continue;
+            const raws = await this.client.mget(...keys);
+            for (const raw of raws) {
+                if (!raw)
+                    continue;
+                const item = RedisStore.deserialize(raw);
+                if (item.expiresAt && item.expiresAt.getTime() < now)
+                    continue;
+                byCategory[item.category]++;
+            }
+        }
+        let oldest = null;
+        let newest = null;
+        for (const uid of iterateUserIds) {
+            const ids = await this.client.smembers(userSetKey(this.prefix, uid));
+            const keys = ids.map((id) => itemKey(this.prefix, id));
+            if (keys.length === 0)
+                continue;
+            const raws = await this.client.mget(...keys);
+            for (const raw of raws) {
+                if (!raw)
+                    continue;
+                const item = RedisStore.deserialize(raw);
+                if (item.expiresAt && item.expiresAt.getTime() < now)
+                    continue;
+                const t = item.updatedAt.getTime();
+                if (oldest == null || t < oldest)
+                    oldest = t;
+                if (newest == null || t > newest)
+                    newest = t;
+            }
+        }
+        const total = Object.values(byCategory).reduce((a, b) => a + b, 0);
+        return {
+            total,
+            byCategory,
+            oldestMemory: oldest != null ? new Date(oldest) : null,
+            newestMemory: newest != null ? new Date(newest) : null,
+        };
+    }
+    async prune(options) {
+        const now = Date.now();
+        const userIds = options?.userId
+            ? [options.userId]
+            : (await this.client.keys(`${this.prefix}:user:*:ids`))
+                .map((k) => {
+                const m = k.match(new RegExp(`^${this.prefix}:user:(.+):ids$`));
+                return m ? m[1] : '';
+            })
+                .filter(Boolean);
+        let removed = 0;
+        for (const uid of userIds) {
+            const ids = await this.client.smembers(userSetKey(this.prefix, uid));
+            for (const id of ids) {
+                const item = await this.get(id);
+                if (!item)
+                    continue;
+                if (options?.category && item.category !== options.category)
+                    continue;
+                const isExpired = item.expiresAt != null && item.expiresAt.getTime() < now;
+                const isTooOld = options?.olderThan != null && item.updatedAt < options.olderThan;
+                const isLowConfidence = options?.minConfidence != null && item.confidence < options.minConfidence;
+                if (isExpired || isTooOld || isLowConfidence) {
+                    await this.delete(id);
+                    removed++;
+                }
+            }
+        }
+        return removed;
+    }
+}
+exports.RedisStore = RedisStore;
+//# sourceMappingURL=redis.store.js.map

package/dist/store/adapters/redis.store.js.map

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

package/dist/store/adapters/vector-episodic.store.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Vector-backed episodic (and optional semantic_summary) memory store.
+ * Stores MemoryItems in memory and optionally in a vector index for similarity search.
+ */
+import { MemoryCategory } from '../../types/category.types';
+import { MemoryItem } from '../../types/memory-item.types';
+import { MemoryQuery, MemorySearchOptions, MemoryStats, PruneOptions } from '../../types/store.types';
+import { MemoryStore } from '../memory-store.interface';
+/** Minimal vector store for episodic search (consumer can pass a real vector DB adapter). */
+export interface VectorStoreAdapter {
+    add(id: string, embedding: number[], metadata?: Record<string, unknown>): Promise<void>;
+    search(embedding: number[], options: {
+        topK?: number;
+        filter?: {
+            userId?: string;
+            category?: string;
+        };
+    }): Promise<Array<{
+        id: string;
+        score: number;
+    }>>;
+    delete(id: string): Promise<void>;
+}
+export interface VectorEpisodicStoreOptions {
+    /** Categories this store handles. Default: [EPISODIC, SEMANTIC_SUMMARY]. */
+    categories?: MemoryCategory[];
+    /** Optional vector store for similarity search. If omitted, search() returns []. */
+    vectorStore?: VectorStoreAdapter;
+}
+/**
+ * Store for episodic/semantic_summary only. Items are kept in memory; optional vector store for search.
+ */
+export declare class VectorEpisodicStore implements MemoryStore {
+    private readonly items;
+    private readonly byUser;
+    private readonly byUserCategory;
+    private readonly categories;
+    private readonly vectorStore?;
+    constructor(options?: VectorEpisodicStoreOptions);
+    private assertCategory;
+    private index;
+    private unindex;
+    initialize(): Promise<void>;
+    save(item: MemoryItem): Promise<string>;
+    saveBatch(items: MemoryItem[]): Promise<string[]>;
+    get(id: string): Promise<MemoryItem | null>;
+    update(id: string, updates: Partial<MemoryItem>): Promise<void>;
+    delete(id: string): Promise<void>;
+    deleteBatch(ids: string[]): Promise<void>;
+    query(options: MemoryQuery): Promise<MemoryItem[]>;
+    search(query: string | number[], options: MemorySearchOptions): Promise<MemoryItem[]>;
+    getStats(userId?: string): Promise<MemoryStats>;
+    prune(options?: PruneOptions): Promise<number>;
+}
+//# sourceMappingURL=vector-episodic.store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vector-episodic.store.d.ts","sourceRoot":"","sources":["../../../src/store/adapters/vector-episodic.store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,YAAY,EACb,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,MAAM,CACJ,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAC1E,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACjD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,0BAA0B;IACzC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,cAAc,EAAE,CAAC;IAC9B,oFAAoF;IACpF,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC;AAOD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+B;IAC9D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAqB;gBAEtC,OAAO,GAAE,0BAA+B;IAKpD,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,OAAO;IAgBT,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IA2BvC,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAQjD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAI3C,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB/D,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASjC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA6ClD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkCrF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAwB/C,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;CAsBrD"}

package/dist/store/adapters/vector-episodic.store.js

@@ -0,0 +1,253 @@
+"use strict";
+/**
+ * Vector-backed episodic (and optional semantic_summary) memory store.
+ * Stores MemoryItems in memory and optionally in a vector index for similarity search.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorEpisodicStore = void 0;
+const crypto_1 = require("crypto");
+const category_types_1 = require("../../types/category.types");
+const DEFAULT_CATEGORIES = [
+    category_types_1.MemoryCategory.EPISODIC,
+    category_types_1.MemoryCategory.SEMANTIC_SUMMARY,
+];
+/**
+ * Store for episodic/semantic_summary only. Items are kept in memory; optional vector store for search.
+ */
+class VectorEpisodicStore {
+    constructor(options = {}) {
+        this.items = new Map();
+        this.byUser = new Map();
+        this.byUserCategory = new Map();
+        this.categories = new Set(options.categories ?? DEFAULT_CATEGORIES);
+        this.vectorStore = options.vectorStore;
+    }
+    assertCategory(category) {
+        if (!this.categories.has(category)) {
+            throw new Error(`VectorEpisodicStore only accepts categories: ${[...this.categories].join(', ')}`);
+        }
+    }
+    index(userId, category, id) {
+        if (!this.byUser.has(userId))
+            this.byUser.set(userId, []);
+        this.byUser.get(userId).push(id);
+        const uck = `${userId}:${category}`;
+        if (!this.byUserCategory.has(uck))
+            this.byUserCategory.set(uck, []);
+        this.byUserCategory.get(uck).push(id);
+    }
+    unindex(userId, category, id) {
+        const list = this.byUser.get(userId);
+        if (list) {
+            const i = list.indexOf(id);
+            if (i !== -1)
+                list.splice(i, 1);
+            if (list.length === 0)
+                this.byUser.delete(userId);
+        }
+        const uck = `${userId}:${category}`;
+        const catList = this.byUserCategory.get(uck);
+        if (catList) {
+            const i = catList.indexOf(id);
+            if (i !== -1)
+                catList.splice(i, 1);
+            if (catList.length === 0)
+                this.byUserCategory.delete(uck);
+        }
+    }
+    async initialize() {
+        // No-op
+    }
+    async save(item) {
+        this.assertCategory(item.category);
+        const id = item.id || (0, crypto_1.randomUUID)();
+        const now = new Date();
+        const full = {
+            ...item,
+            id,
+            createdAt: item.createdAt ?? now,
+            updatedAt: item.updatedAt ?? now,
+            accessCount: item.accessCount ?? 0,
+        };
+        const existing = this.items.get(id);
+        if (existing) {
+            this.unindex(existing.userId, existing.category, id);
+            if (this.vectorStore)
+                await this.vectorStore.delete(id);
+        }
+        this.items.set(id, full);
+        this.index(full.userId, full.category, id);
+        if (this.vectorStore && Array.isArray(full.value) && full.value.length > 0) {
+            await this.vectorStore.add(id, full.value, {
+                userId: full.userId,
+                category: full.category,
+            });
+        }
+        return id;
+    }
+    async saveBatch(items) {
+        const ids = [];
+        for (const item of items) {
+            ids.push(await this.save(item));
+        }
+        return ids;
+    }
+    async get(id) {
+        return this.items.get(id) ?? null;
+    }
+    async update(id, updates) {
+        const existing = this.items.get(id);
+        if (!existing)
+            return;
+        this.assertCategory(existing.category);
+        const updated = {
+            ...existing,
+            ...updates,
+            id: existing.id,
+            userId: existing.userId,
+            category: existing.category,
+            key: existing.key,
+            updatedAt: new Date(),
+        };
+        this.items.set(id, updated);
+        if (this.vectorStore && Array.isArray(updated.value) && updated.value.length > 0) {
+            await this.vectorStore.delete(id);
+            await this.vectorStore.add(id, updated.value, {
+                userId: updated.userId,
+                category: updated.category,
+            });
+        }
+    }
+    async delete(id) {
+        const item = this.items.get(id);
+        if (item) {
+            this.unindex(item.userId, item.category, id);
+            if (this.vectorStore)
+                await this.vectorStore.delete(id);
+        }
+        this.items.delete(id);
+    }
+    async deleteBatch(ids) {
+        for (const id of ids)
+            await this.delete(id);
+    }
+    async query(options) {
+        const categories = options.category != null
+            ? Array.isArray(options.category)
+                ? options.category
+                : [options.category]
+            : [...this.categories];
+        const allowed = categories.filter((c) => this.categories.has(c));
+        if (allowed.length === 0)
+            return [];
+        let ids = [];
+        for (const cat of allowed) {
+            const uck = `${options.userId}:${cat}`;
+            const list = this.byUserCategory.get(uck);
+            if (list)
+                ids = ids.concat(list);
+        }
+        ids = [...new Set(ids)];
+        let items = ids.map((id) => this.items.get(id)).filter((m) => m != null);
+        if (options.source != null) {
+            const srcs = Array.isArray(options.source) ? options.source : [options.source];
+            items = items.filter((m) => srcs.includes(m.source));
+        }
+        if (options.minConfidence != null) {
+            items = items.filter((m) => m.confidence >= options.minConfidence);
+        }
+        if (options.notExpired !== false) {
+            const now = Date.now();
+            items = items.filter((m) => !m.expiresAt || m.expiresAt.getTime() >= now);
+        }
+        const orderBy = options.orderBy ?? 'updatedAt';
+        const order = options.order ?? 'desc';
+        items.sort((a, b) => {
+            const ta = a[orderBy].getTime();
+            const tb = b[orderBy].getTime();
+            return order === 'asc' ? ta - tb : tb - ta;
+        });
+        const offset = options.offset ?? 0;
+        const limit = options.limit ?? 100;
+        return items.slice(offset, offset + limit);
+    }
+    async search(query, options) {
+        if (!this.vectorStore || !Array.isArray(query) || query.length === 0) {
+            if (typeof query === 'string') {
+                const items = await this.query({
+                    userId: options.userId,
+                    category: options.category,
+                    limit: options.topK ?? 10,
+                });
+                const q = query.toLowerCase();
+                return items
+                    .filter((m) => (typeof m.value === 'string' && m.value.toLowerCase().includes(q)) ||
+                    m.key.toLowerCase().includes(q))
+                    .slice(0, options.topK ?? 10);
+            }
+            return [];
+        }
+        const results = await this.vectorStore.search(query, {
+            topK: options.topK ?? 10,
+            filter: {
+                userId: options.userId,
+                category: Array.isArray(options.category) ? options.category[0] : options.category,
+            },
+        });
+        const items = [];
+        for (const { id } of results) {
+            const item = this.items.get(id);
+            if (item)
+                items.push(item);
+        }
+        return items;
+    }
+    async getStats(userId) {
+        const byCategory = Object.values(category_types_1.MemoryCategory).reduce((acc, cat) => ({ ...acc, [cat]: 0 }), {});
+        const iterate = userId ? (this.byUser.get(userId) ?? []) : Array.from(this.items.keys());
+        let oldest = null;
+        let newest = null;
+        for (const id of iterate) {
+            const item = this.items.get(id);
+            if (!item)
+                continue;
+            byCategory[item.category]++;
+            const t = item.updatedAt.getTime();
+            if (oldest == null || t < oldest)
+                oldest = t;
+            if (newest == null || t > newest)
+                newest = t;
+        }
+        return {
+            total: Object.values(byCategory).reduce((a, b) => a + b, 0),
+            byCategory,
+            oldestMemory: oldest != null ? new Date(oldest) : null,
+            newestMemory: newest != null ? new Date(newest) : null,
+        };
+    }
+    async prune(options) {
+        const now = Date.now();
+        const userIds = options?.userId ? [options.userId] : Array.from(this.byUser.keys());
+        let removed = 0;
+        for (const uid of userIds) {
+            const ids = this.byUser.get(uid) ?? [];
+            for (const id of ids) {
+                const item = this.items.get(id);
+                if (!item)
+                    continue;
+                if (options?.category && item.category !== options.category)
+                    continue;
+                const isExpired = item.expiresAt != null && item.expiresAt.getTime() < now;
+                const isTooOld = options?.olderThan != null && item.updatedAt < options.olderThan;
+                const isLowConfidence = options?.minConfidence != null && item.confidence < options.minConfidence;
+                if (isExpired || isTooOld || isLowConfidence) {
+                    await this.delete(id);
+                    removed++;
+                }
+            }
+        }
+        return removed;
+    }
+}
+exports.VectorEpisodicStore = VectorEpisodicStore;
+//# sourceMappingURL=vector-episodic.store.js.map

package/dist/store/adapters/vector-episodic.store.js.map

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