@easynet/agent-memory 0.0.2 → 1.0.0

package/dist/src/providers/in-memory-store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * In-memory cross-thread store: namespace-scoped MemoryItems.
+ * Suitable for dev and single-process; use SQLite/Postgres for production.
+ */
+import type { MemoryItem, MemoryProvider, MemoryQueryRequest, MemoryWriteRequest } from "../core/types.js";
+export declare class InMemoryStoreProvider implements MemoryProvider {
+    private store;
+    private key;
+    write(req: MemoryWriteRequest): Promise<MemoryItem>;
+    query(req: MemoryQueryRequest): Promise<MemoryItem[]>;
+    delete(id: string, namespace: string): Promise<void>;
+    getByKey(namespace: string, key: string): Promise<MemoryItem | null>;
+    deleteByKey(namespace: string, key: string): Promise<void>;
+}
+//# sourceMappingURL=in-memory-store.d.ts.map

package/dist/src/providers/in-memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../../../src/providers/in-memory-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAG1B,qBAAa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,KAAK,CAAiC;IAE9C,OAAO,CAAC,GAAG;IAIL,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAmBnD,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAYrD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQpE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIjE"}

package/dist/src/providers/in-memory-store.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * In-memory cross-thread store: namespace-scoped MemoryItems.
+ * Suitable for dev and single-process; use SQLite/Postgres for production.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryStoreProvider = void 0;
+const node_crypto_1 = require("node:crypto");
+class InMemoryStoreProvider {
+    store = new Map();
+    key(id, namespace) {
+        return `${namespace}:${id}`;
+    }
+    async write(req) {
+        const now = new Date().toISOString();
+        const id = (0, node_crypto_1.randomUUID)();
+        const item = {
+            id,
+            type: req.type,
+            namespace: req.namespace,
+            scope: req.scope ?? "global",
+            content: req.content,
+            metadata: {
+                ...req.metadata,
+                created_at: req.metadata?.created_at ?? now,
+                updated_at: now,
+            },
+        };
+        this.store.set(this.key(id, req.namespace), item);
+        return item;
+    }
+    async query(req) {
+        const prefix = req.namespace + ":";
+        const items = [];
+        for (const [k, v] of this.store) {
+            if (!k.startsWith(prefix))
+                continue;
+            if (req.types && !req.types.includes(v.type))
+                continue;
+            items.push(v);
+        }
+        const topK = req.topK ?? 10;
+        return items.slice(0, topK);
+    }
+    async delete(id, namespace) {
+        this.store.delete(this.key(id, namespace));
+    }
+    async getByKey(namespace, key) {
+        for (const [, v] of this.store) {
+            if (v.namespace === namespace && v.metadata?.path === key)
+                return v;
+        }
+        return null;
+    }
+    async deleteByKey(namespace, key) {
+        const item = await this.getByKey(namespace, key);
+        if (item)
+            this.store.delete(this.key(item.id, namespace));
+    }
+}
+exports.InMemoryStoreProvider = InMemoryStoreProvider;
+//# sourceMappingURL=in-memory-store.js.map

package/dist/src/providers/in-memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../../../src/providers/in-memory-store.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAQH,6CAAyC;AAEzC,MAAa,qBAAqB;IACxB,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEtC,GAAG,CAAC,EAAU,EAAE,SAAiB;QACvC,OAAO,GAAG,SAAS,IAAI,EAAE,EAAE,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAuB;QACjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAA,wBAAU,GAAE,CAAC;QACxB,MAAM,IAAI,GAAe;YACvB,EAAE;YACF,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,QAAQ;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE;gBACR,GAAG,GAAG,CAAC,QAAQ;gBACf,UAAU,EAAG,GAAG,CAAC,QAAQ,EAAE,UAAqB,IAAI,GAAG;gBACvD,UAAU,EAAE,GAAG;aAChB;SACF,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAuB;QACjC,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC;QACnC,MAAM,KAAK,GAAiB,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,SAAS;YACpC,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,SAAS;YACvD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,SAAiB;QACxC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,GAAW;QAC3C,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,IAAK,CAAC,CAAC,QAAQ,EAAE,IAAe,KAAK,GAAG;gBACnE,OAAO,CAAC,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,GAAW;QAC9C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,IAAI;YAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5D,CAAC;CACF;AAtDD,sDAsDC"}

package/dist/src/providers/mem0-provider.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Mem0 provider: wraps mem0ai (OSS) as a MemoryProvider.
+ * Use with an initialized Memory instance from mem0ai/oss.
+ */
+import type { MemoryItem, MemoryProvider, MemoryQueryRequest, MemoryWriteRequest } from "../core/types.js";
+/** Simplified mem0ai Memory interface (avoids hard dependency). */
+export interface Mem0MemoryLike {
+    add(messages: Array<{
+        role: string;
+        content: string;
+    }>, options?: {
+        userId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<unknown>;
+    search(query: string, options?: {
+        userId?: string;
+        limit?: number;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        results: Array<{
+            id: string;
+            memory: string;
+            score?: number;
+            metadata?: Record<string, unknown>;
+            userId?: string;
+        }>;
+    }>;
+    delete(memoryId: string): Promise<unknown>;
+    deleteAll?(options?: {
+        userId?: string;
+    }): Promise<unknown>;
+}
+export interface Mem0ProviderOptions {
+    memory: Mem0MemoryLike;
+    /** Map agent-memory namespace to mem0 userId; default: namespace as-is */
+    namespaceToUserId?: (namespace: string) => string;
+}
+export declare class Mem0Provider implements MemoryProvider {
+    private mem0;
+    private namespaceToUserId;
+    constructor(options: Mem0ProviderOptions);
+    write(req: MemoryWriteRequest): Promise<MemoryItem>;
+    query(req: MemoryQueryRequest): Promise<MemoryItem[]>;
+    delete(id: string, _namespace: string): Promise<void>;
+    deleteAllForNamespace(namespace: string): Promise<void>;
+}
+//# sourceMappingURL=mem0-provider.d.ts.map

package/dist/src/providers/mem0-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mem0-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/mem0-provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,GAAG,CACD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAClD,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAChE,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAChF,OAAO,CAAC;QACT,OAAO,EAAE,KAAK,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACnC,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC,CAAC;KACJ,CAAC,CAAC;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAC;IACvB,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;CACnD;AAID,qBAAa,YAAa,YAAW,cAAc;IACjD,OAAO,CAAC,IAAI,CAAiB;IAC7B,OAAO,CAAC,iBAAiB,CAAgC;gBAE7C,OAAO,EAAE,mBAAmB;IAUlC,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IA+CnD,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAwBrD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM9D"}

package/dist/src/providers/mem0-provider.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Mem0 provider: wraps mem0ai (OSS) as a MemoryProvider.
+ * Use with an initialized Memory instance from mem0ai/oss.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Mem0Provider = void 0;
+const defaultNamespaceToUserId = (namespace) => namespace;
+class Mem0Provider {
+    mem0;
+    namespaceToUserId;
+    constructor(options) {
+        if (!options.memory) {
+            throw new Error("Mem0Provider requires options.memory (Memory instance from mem0ai/oss). Install: pnpm add mem0ai");
+        }
+        this.mem0 = options.memory;
+        this.namespaceToUserId = options.namespaceToUserId ?? defaultNamespaceToUserId;
+    }
+    async write(req) {
+        const userId = this.namespaceToUserId(req.namespace);
+        const messages = [{ role: "user", content: req.content }];
+        await this.mem0.add(messages, {
+            userId,
+            metadata: {
+                ...req.metadata,
+                type: req.type,
+                scope: req.scope,
+            },
+        });
+        const search = await this.mem0.search(req.content, {
+            userId,
+            limit: 1,
+        });
+        const first = search.results?.[0];
+        const now = new Date().toISOString();
+        if (first) {
+            return {
+                id: first.id,
+                type: req.type,
+                namespace: req.namespace,
+                scope: req.scope ?? "global",
+                content: first.memory,
+                metadata: {
+                    ...req.metadata,
+                    ...first.metadata,
+                    created_at: now,
+                    updated_at: now,
+                },
+            };
+        }
+        const id = `mem0-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+        return {
+            id,
+            type: req.type,
+            namespace: req.namespace,
+            scope: req.scope ?? "global",
+            content: req.content,
+            metadata: {
+                ...req.metadata,
+                created_at: now,
+                updated_at: now,
+            },
+        };
+    }
+    async query(req) {
+        const userId = this.namespaceToUserId(req.namespace);
+        const limit = req.topK ?? 10;
+        const search = await this.mem0.search(req.query, {
+            userId,
+            limit,
+            metadata: req.filters,
+        });
+        const results = search.results ?? [];
+        const now = new Date().toISOString();
+        return results.map((r) => ({
+            id: r.id,
+            type: r.metadata?.type ?? "cross_thread",
+            namespace: req.namespace,
+            scope: "global",
+            content: r.memory,
+            metadata: {
+                ...r.metadata,
+                created_at: now,
+                updated_at: now,
+            },
+        }));
+    }
+    async delete(id, _namespace) {
+        await this.mem0.delete(id);
+    }
+    async deleteAllForNamespace(namespace) {
+        const userId = this.namespaceToUserId(namespace);
+        if (typeof this.mem0.deleteAll === "function") {
+            await this.mem0.deleteAll({ userId });
+        }
+    }
+}
+exports.Mem0Provider = Mem0Provider;
+//# sourceMappingURL=mem0-provider.js.map

package/dist/src/providers/mem0-provider.js.map

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

package/dist/src/providers/rag-provider.d.ts

@@ -0,0 +1,27 @@
+/**
+ * RAG provider: vector store + chunking.
+ * Implementations can use Qdrant, PGVector, Weaviate, or in-memory vectors.
+ */
+import type { MemoryItem, MemoryProvider, MemoryQueryRequest, MemoryWriteRequest } from "../core/types.js";
+export interface RAGProviderOptions {
+    /** Optional embedding function; if not provided, no embedding is stored. */
+    embed?(text: string): Promise<number[]>;
+    /** Optional similarity search; if not provided, fallback to keyword/filter only. */
+    search?(namespace: string, query: string, topK: number, filters?: Record<string, unknown>): Promise<Array<{
+        item: MemoryItem;
+        score: number;
+    }>>;
+}
+/**
+ * RAG provider that stores knowledge-type items and supports semantic (or keyword) query.
+ */
+export declare class RAGProvider implements MemoryProvider {
+    private items;
+    private embed?;
+    private search?;
+    constructor(options?: RAGProviderOptions);
+    write(req: MemoryWriteRequest): Promise<MemoryItem>;
+    query(req: MemoryQueryRequest): Promise<MemoryItem[]>;
+    delete(id: string, namespace: string): Promise<void>;
+}
+//# sourceMappingURL=rag-provider.d.ts.map

package/dist/src/providers/rag-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-provider.d.ts","sourceRoot":"","sources":["../../../src/providers/rag-provider.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,oFAAoF;IACpF,MAAM,CAAC,CACL,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,qBAAa,WAAY,YAAW,cAAc;IAChD,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,KAAK,CAAC,CAAsC;IACpD,OAAO,CAAC,MAAM,CAAC,CAA+B;gBAElC,OAAO,GAAE,kBAAuB;IAKtC,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAyBnD,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAmBrD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK3D"}

package/dist/src/providers/rag-provider.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * RAG provider: vector store + chunking.
+ * Implementations can use Qdrant, PGVector, Weaviate, or in-memory vectors.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RAGProvider = void 0;
+/**
+ * RAG provider that stores knowledge-type items and supports semantic (or keyword) query.
+ */
+class RAGProvider {
+    items = [];
+    embed;
+    search;
+    constructor(options = {}) {
+        this.embed = options.embed;
+        this.search = options.search;
+    }
+    async write(req) {
+        const { randomUUID } = await import("node:crypto");
+        const now = new Date().toISOString();
+        const id = randomUUID();
+        let embedding;
+        if (this.embed) {
+            embedding = await this.embed(req.content);
+        }
+        const item = {
+            id,
+            type: req.type,
+            namespace: req.namespace,
+            scope: req.scope ?? "global",
+            content: req.content,
+            embedding,
+            metadata: {
+                ...req.metadata,
+                created_at: req.metadata?.created_at ?? now,
+                updated_at: now,
+            },
+        };
+        this.items.push(item);
+        return item;
+    }
+    async query(req) {
+        const topK = req.topK ?? 8;
+        const types = req.types ?? ["knowledge"];
+        const inNamespace = this.items.filter((i) => i.namespace === req.namespace && types.includes(i.type));
+        if (this.search) {
+            const results = await this.search(req.namespace, req.query, topK, req.filters);
+            return results.map((r) => r.item).slice(0, topK);
+        }
+        return inNamespace.slice(0, topK);
+    }
+    async delete(id, namespace) {
+        this.items = this.items.filter((i) => !(i.id === id && i.namespace === namespace));
+    }
+}
+exports.RAGProvider = RAGProvider;
+//# sourceMappingURL=rag-provider.js.map

package/dist/src/providers/rag-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag-provider.js","sourceRoot":"","sources":["../../../src/providers/rag-provider.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAqBH;;GAEG;AACH,MAAa,WAAW;IACd,KAAK,GAAiB,EAAE,CAAC;IACzB,KAAK,CAAuC;IAC5C,MAAM,CAAgC;IAE9C,YAAY,UAA8B,EAAE;QAC1C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAuB;QACjC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;QACxB,IAAI,SAA+B,CAAC;QACpC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,IAAI,GAAe;YACvB,EAAE;YACF,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,QAAQ;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS;YACT,QAAQ,EAAE;gBACR,GAAG,GAAG,CAAC,QAAQ;gBACf,UAAU,EAAG,GAAG,CAAC,QAAQ,EAAE,UAAqB,IAAI,GAAG;gBACvD,UAAU,EAAE,GAAG;aAChB;SACF,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAuB;QACjC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC;QAC3B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CACnC,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAC1D,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAC/B,GAAG,CAAC,SAAS,EACb,GAAG,CAAC,KAAK,EACT,IAAI,EACJ,GAAG,CAAC,OAAO,CACZ,CAAC;YACF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,SAAiB;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CACnD,CAAC;IACJ,CAAC;CACF;AA3DD,kCA2DC"}

package/dist/src/providers/sqlite-store.d.ts

@@ -0,0 +1,21 @@
+/**
+ * SQLite backend: persist MemoryItems; optional vector search via embed.
+ * Requires better-sqlite3.
+ */
+import type { MemoryItem, MemoryProvider, MemoryQueryRequest, MemoryWriteRequest } from "../core/types.js";
+export interface SqliteStoreOptions {
+    dbPath: string;
+    /** Optional: embed for vector storage and similarity ranking */
+    embed?: (text: string) => Promise<number[]>;
+}
+export declare class SqliteStoreProvider implements MemoryProvider {
+    private db;
+    private embed?;
+    constructor(options: SqliteStoreOptions);
+    write(req: MemoryWriteRequest): Promise<MemoryItem>;
+    query(req: MemoryQueryRequest): Promise<MemoryItem[]>;
+    delete(id: string, namespace: string): Promise<void>;
+    getByKey(namespace: string, key: string): Promise<MemoryItem | null>;
+    deleteByKey(namespace: string, key: string): Promise<void>;
+}
+//# sourceMappingURL=sqlite-store.d.ts.map

package/dist/src/providers/sqlite-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../../src/providers/sqlite-store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,UAAU,EAEV,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAiB1B,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC7C;AA6DD,qBAAa,mBAAoB,YAAW,cAAc;IACxD,OAAO,CAAC,EAAE,CAAS;IACnB,OAAO,CAAC,KAAK,CAAC,CAAsC;gBAExC,OAAO,EAAE,kBAAkB;IAMjC,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IA8BnD,KAAK,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAkCrD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAOpE,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjE"}

package/dist/src/providers/sqlite-store.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * SQLite backend: persist MemoryItems; optional vector search via embed.
+ * Requires better-sqlite3.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqliteStoreProvider = void 0;
+const node_crypto_1 = require("node:crypto");
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+function getDatabase(dbPath) {
+    try {
+        const Database = require("better-sqlite3");
+        return new Database(dbPath);
+    }
+    catch {
+        throw new Error("SqliteStoreProvider requires 'better-sqlite3'. Install: pnpm add better-sqlite3");
+    }
+}
+const TABLE = "memory_items";
+function initTable(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS ${TABLE} (
+      id TEXT PRIMARY KEY,
+      namespace TEXT NOT NULL,
+      type TEXT NOT NULL,
+      scope TEXT NOT NULL,
+      content TEXT NOT NULL,
+      embedding_json TEXT,
+      metadata_json TEXT NOT NULL,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      path_key TEXT
+    )
+  `);
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_${TABLE}_namespace ON ${TABLE}(namespace)`);
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_${TABLE}_path ON ${TABLE}(namespace, path_key)`);
+}
+function rowToItem(row) {
+    const metadata = (typeof row.metadata_json === "string"
+        ? JSON.parse(row.metadata_json)
+        : row.metadata_json);
+    const embedding = typeof row.embedding_json === "string" && row.embedding_json
+        ? JSON.parse(row.embedding_json)
+        : undefined;
+    return {
+        id: row.id,
+        type: row.type,
+        namespace: row.namespace,
+        scope: row.scope,
+        content: row.content,
+        embedding,
+        metadata,
+    };
+}
+class SqliteStoreProvider {
+    db;
+    embed;
+    constructor(options) {
+        this.db = getDatabase(options.dbPath);
+        this.embed = options.embed;
+        initTable(this.db);
+    }
+    async write(req) {
+        const now = new Date().toISOString();
+        const id = (0, node_crypto_1.randomUUID)();
+        const metadata = {
+            ...req.metadata,
+            created_at: req.metadata?.created_at ?? now,
+            updated_at: now,
+        };
+        const pathKey = req.metadata?.path ?? null;
+        let embeddingJson = null;
+        if (this.embed) {
+            const vec = await this.embed(req.content);
+            embeddingJson = JSON.stringify(vec);
+        }
+        const metadataJson = JSON.stringify(metadata);
+        const stmt = this.db.prepare(`INSERT INTO ${TABLE} (id, namespace, type, scope, content, embedding_json, metadata_json, created_at, updated_at, path_key) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+        stmt.run(id, req.namespace, req.type, req.scope ?? "global", req.content, embeddingJson, metadataJson, now, now, pathKey);
+        return {
+            id,
+            type: req.type,
+            namespace: req.namespace,
+            scope: req.scope ?? "global",
+            content: req.content,
+            embedding: this.embed ? await this.embed(req.content) : undefined,
+            metadata,
+        };
+    }
+    async query(req) {
+        const topK = req.topK ?? 10;
+        const typesFilter = req.types?.length
+            ? ` AND type IN (${req.types.map(() => "?").join(",")})`
+            : "";
+        const args = [req.namespace];
+        if (req.types?.length)
+            args.push(...req.types);
+        if (this.embed && req.query.trim()) {
+            const queryVec = await this.embed(req.query);
+            const rows = this.db.prepare(`SELECT * FROM ${TABLE} WHERE namespace = ?${typesFilter}`).all(...args);
+            const withScores = rows
+                .map((row) => {
+                const item = rowToItem(row);
+                const vec = typeof row.embedding_json === "string" && row.embedding_json
+                    ? JSON.parse(row.embedding_json)
+                    : null;
+                const score = vec ? cosineSimilarity(queryVec, vec) : 0;
+                return { item, score };
+            })
+                .sort((a, b) => b.score - a.score)
+                .slice(0, topK);
+            return withScores.map((x) => x.item);
+        }
+        const rows = this.db.prepare(`SELECT * FROM ${TABLE} WHERE namespace = ?${typesFilter} ORDER BY updated_at DESC LIMIT ?`).all(...args, topK);
+        return rows.map(rowToItem);
+    }
+    async delete(id, namespace) {
+        this.db.prepare(`DELETE FROM ${TABLE} WHERE id = ? AND namespace = ?`).run(id, namespace);
+    }
+    async getByKey(namespace, key) {
+        const row = this.db.prepare(`SELECT * FROM ${TABLE} WHERE namespace = ? AND path_key = ? LIMIT 1`).get(namespace, key);
+        return row ? rowToItem(row) : null;
+    }
+    async deleteByKey(namespace, key) {
+        this.db.prepare(`DELETE FROM ${TABLE} WHERE namespace = ? AND path_key = ?`).run(namespace, key);
+    }
+}
+exports.SqliteStoreProvider = SqliteStoreProvider;
+//# sourceMappingURL=sqlite-store.js.map

package/dist/src/providers/sqlite-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.js","sourceRoot":"","sources":["../../../src/providers/sqlite-store.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AASH,6CAAyC;AAEzC,SAAS,gBAAgB,CAAC,CAAW,EAAE,CAAW;IAChD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtD,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACvB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACzB,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC;AACvC,CAAC;AAiBD,SAAS,WAAW,CAAC,MAAc;IACjC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAiC,CAAC;QAC3E,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,iFAAiF,CAClF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,KAAK,GAAG,cAAc,CAAC;AAE7B,SAAS,SAAS,CAAC,EAAU;IAC3B,EAAE,CAAC,IAAI,CAAC;iCACuB,KAAK;;;;;;;;;;;;GAYnC,CAAC,CAAC;IACH,EAAE,CAAC,IAAI,CAAC,kCAAkC,KAAK,iBAAiB,KAAK,aAAa,CAAC,CAAC;IACpF,EAAE,CAAC,IAAI,CAAC,kCAAkC,KAAK,YAAY,KAAK,uBAAuB,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,SAAS,CAAC,GAA4B;IAC7C,MAAM,QAAQ,GAAG,CAAC,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ;QACrD,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAuB,CAAC;QACzC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAuB,CAAC;IAC7C,MAAM,SAAS,GAAG,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc;QAC5E,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAwB,CAAc;QACxD,CAAC,CAAC,SAAS,CAAC;IACd,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAY;QACpB,IAAI,EAAE,GAAG,CAAC,IAA0B;QACpC,SAAS,EAAE,GAAG,CAAC,SAAmB;QAClC,KAAK,EAAE,GAAG,CAAC,KAA4B;QACvC,OAAO,EAAE,GAAG,CAAC,OAAiB;QAC9B,SAAS;QACT,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,MAAa,mBAAmB;IACtB,EAAE,CAAS;IACX,KAAK,CAAuC;IAEpD,YAAY,OAA2B;QACrC,IAAI,CAAC,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAuB;QACjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAA,wBAAU,GAAE,CAAC;QACxB,MAAM,QAAQ,GAAuB;YACnC,GAAG,GAAG,CAAC,QAAQ;YACf,UAAU,EAAG,GAAG,CAAC,QAAQ,EAAE,UAAqB,IAAI,GAAG;YACvD,UAAU,EAAE,GAAG;SAChB,CAAC;QACF,MAAM,OAAO,GAAI,GAAG,CAAC,QAAQ,EAAE,IAAe,IAAI,IAAI,CAAC;QACvD,IAAI,aAAa,GAAkB,IAAI,CAAC;QACxC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1C,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,eAAe,KAAK,+IAA+I,CACpK,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,IAAI,QAAQ,EAAE,GAAG,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC1H,OAAO;YACL,EAAE;YACF,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,QAAQ;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;YACjE,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAuB;QACjC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5B,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,EAAE,MAAM;YACnC,CAAC,CAAC,iBAAiB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;YACxD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,IAAI,GAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QAE/C,IAAI,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACnC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,iBAAiB,KAAK,uBAAuB,WAAW,EAAE,CAC3D,CAAC,GAAG,CAAC,GAAG,IAAI,CAA8B,CAAC;YAC5C,MAAM,UAAU,GAAG,IAAI;iBACpB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBACX,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM,GAAG,GACP,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ,IAAI,GAAG,CAAC,cAAc;oBAC1D,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,cAAwB,CAAc;oBACxD,CAAC,CAAC,IAAI,CAAC;gBACX,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACxD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACzB,CAAC,CAAC;iBACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;iBACjC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAClB,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,iBAAiB,KAAK,uBAAuB,WAAW,mCAAmC,CAC5F,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,CAA8B,CAAC;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,SAAiB;QACxC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,eAAe,KAAK,iCAAiC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAiB,EAAE,GAAW;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CACzB,iBAAiB,KAAK,+CAA+C,CACtE,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAwC,CAAC;QAC7D,OAAO,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,SAAiB,EAAE,GAAW;QAC9C,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,eAAe,KAAK,uCAAuC,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACnG,CAAC;CACF;AAxFD,kDAwFC"}

package/dist/test/core/agent-memory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=agent-memory.test.d.ts.map

package/dist/test/core/agent-memory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-memory.test.d.ts","sourceRoot":"","sources":["../../../test/core/agent-memory.test.ts"],"names":[],"mappings":""}

package/dist/test/core/agent-memory.test.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const node_assert_1 = __importDefault(require("node:assert"));
+const agent_memory_js_1 = require("../../src/core/agent-memory.js");
+const observability_js_1 = require("../../src/core/observability.js");
+const router_js_1 = require("../../src/core/router.js");
+const node_crypto_1 = require("node:crypto");
+class TestMemoryProvider {
+    store = new Map();
+    async write(req) {
+        const now = new Date().toISOString();
+        const item = {
+            id: (0, node_crypto_1.randomUUID)(),
+            type: req.type,
+            namespace: req.namespace,
+            scope: req.scope ?? "global",
+            content: req.content,
+            metadata: { ...req.metadata, created_at: now, updated_at: now },
+        };
+        this.store.set(`${req.namespace}:${item.id}`, item);
+        return item;
+    }
+    async query(req) {
+        const items = [...this.store.values()].filter((i) => i.namespace === req.namespace);
+        return items.slice(0, req.topK ?? 10);
+    }
+    async delete(id, namespace) {
+        this.store.delete(`${namespace}:${id}`);
+    }
+}
+(0, node_test_1.describe)("AgentMemory", () => {
+    (0, node_test_1.it)("write and retrieveForPrompt", async () => {
+        const provider = new TestMemoryProvider();
+        const router = new router_js_1.MemoryRouter({
+            providers: new Map([["default", provider]]),
+            defaultProviderId: "default",
+        });
+        const tracer = new observability_js_1.InMemoryTraceRecorder();
+        const memory = new agent_memory_js_1.AgentMemory({
+            router,
+            traceRecorder: tracer,
+        });
+        await memory.write({
+            namespace: "user:1",
+            type: "cross_thread",
+            content: "Use Chinese and summarize at the end.",
+        });
+        const result = await memory.retrieveForPrompt({
+            namespace: "user:1",
+            query: "user preferences and cross-session memory",
+            topK: 5,
+        });
+        node_assert_1.default.strictEqual(result.items.length, 1);
+        node_assert_1.default.strictEqual(result.items[0].content, "Use Chinese and summarize at the end.");
+        node_assert_1.default.ok(result.traceId);
+        node_assert_1.default.ok(result.injectedText.includes("cross_thread"));
+        node_assert_1.default.strictEqual(tracer.getTraces().length, 1);
+    });
+    (0, node_test_1.it)("memorize without type defaults to cross_thread", async () => {
+        const provider = new TestMemoryProvider();
+        const router = new router_js_1.MemoryRouter({
+            providers: new Map([["default", provider]]),
+            defaultProviderId: "default",
+        });
+        const memory = new agent_memory_js_1.AgentMemory({ router });
+        const item = await memory.memorize({
+            namespace: "user:1",
+            content: "I prefer dark mode.",
+        });
+        node_assert_1.default.strictEqual(item.type, "cross_thread");
+        node_assert_1.default.strictEqual(item.content, "I prefer dark mode.");
+    });
+    (0, node_test_1.it)("memorize with classifyMemory uses callback for type", async () => {
+        const provider = new TestMemoryProvider();
+        const router = new router_js_1.MemoryRouter({
+            providers: new Map([["default", provider]]),
+            defaultProviderId: "default",
+        });
+        const memory = new agent_memory_js_1.AgentMemory({
+            router,
+            classifyMemory: async (content) => (content.length > 20 ? "knowledge" : "thread"),
+        });
+        const item1 = await memory.memorize({ namespace: "ns", content: "short" });
+        node_assert_1.default.strictEqual(item1.type, "thread");
+        const item2 = await memory.memorize({ namespace: "ns", content: "this is a longer content piece" });
+        node_assert_1.default.strictEqual(item2.type, "knowledge");
+    });
+    (0, node_test_1.it)("deleteByNamespace", async () => {
+        const provider = new TestMemoryProvider();
+        const router = new router_js_1.MemoryRouter({
+            providers: new Map([["default", provider]]),
+            defaultProviderId: "default",
+        });
+        const memory = new agent_memory_js_1.AgentMemory({ router });
+        await memory.write({
+            namespace: "user:2",
+            type: "cross_thread",
+            content: "Chose option A.",
+        });
+        const before = await memory.retrieveForPrompt({
+            namespace: "user:2",
+            query: "any",
+            topK: 5,
+        });
+        node_assert_1.default.strictEqual(before.items.length, 1);
+        await memory.deleteByNamespace("user:2");
+        const after = await memory.retrieveForPrompt({
+            namespace: "user:2",
+            query: "any",
+            topK: 5,
+        });
+        node_assert_1.default.strictEqual(after.items.length, 0);
+    });
+});
+//# sourceMappingURL=agent-memory.test.js.map