@easynet/agent-memory 0.0.2 → 1.0.1

package/dist/test/core/router.test.js

@@ -0,0 +1,118 @@
+"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 router_js_1 = require("../../src/core/router.js");
+const node_crypto_1 = require("node:crypto");
+function makeProvider(id) {
+    const store = new Map();
+    return {
+        async write(req) {
+            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: new Date().toISOString(), updated_at: new Date().toISOString() },
+            };
+            store.set(item.id, item);
+            return item;
+        },
+        async query(req) {
+            return [...store.values()].filter((i) => i.namespace === req.namespace).slice(0, req.topK ?? 10);
+        },
+        async delete(id, namespace) {
+            for (const [k, v] of store) {
+                if (v.id === id && v.namespace === namespace)
+                    store.delete(k);
+            }
+        },
+    };
+}
+(0, node_test_1.describe)("MemoryRouter", () => {
+    (0, node_test_1.it)("routeWrite uses defaultProvider when no rules match", () => {
+        const defaultP = makeProvider("default");
+        const router = new router_js_1.MemoryRouter({
+            providers: new Map([["default", defaultP]]),
+            defaultProviderId: "default",
+            rules: [],
+        });
+        const ids = router.routeWrite({
+            namespace: "user:1",
+            type: "knowledge",
+            content: "x",
+        });
+        node_assert_1.default.deepStrictEqual(ids, ["default"]);
+    });
+    (0, node_test_1.it)("routeWrite matches rule by type and routes to provider", () => {
+        const defaultP = makeProvider("default");
+        const ragP = makeProvider("rag");
+        const router = new router_js_1.MemoryRouter({
+            providers: new Map([
+                ["default", defaultP],
+                ["rag", ragP],
+            ]),
+            defaultProviderId: "default",
+            rules: [
+                { types: ["knowledge"], providerId: "rag" },
+                { types: ["cross_thread"], providerId: "mem0" },
+            ],
+        });
+        const idsKnowledge = router.routeWrite({
+            namespace: "ns",
+            type: "knowledge",
+            content: "doc",
+        });
+        node_assert_1.default.deepStrictEqual(idsKnowledge, ["rag"]);
+        const idsCrossThread = router.routeWrite({
+            namespace: "ns",
+            type: "cross_thread",
+            content: "pref",
+        });
+        node_assert_1.default.deepStrictEqual(idsCrossThread, ["mem0"]);
+    });
+    (0, node_test_1.it)("routeQuery matches rule by req.types", () => {
+        const defaultP = makeProvider("default");
+        const ragP = makeProvider("rag");
+        const router = new router_js_1.MemoryRouter({
+            providers: new Map([
+                ["default", defaultP],
+                ["rag", ragP],
+            ]),
+            defaultProviderId: "default",
+            rules: [{ types: ["knowledge"], providerId: "rag" }],
+        });
+        const ids = router.routeQuery({
+            namespace: "ns",
+            query: "q",
+            types: ["knowledge"],
+        });
+        node_assert_1.default.deepStrictEqual(ids, ["rag"]);
+    });
+    (0, node_test_1.it)("write and query flow", async () => {
+        const defaultP = makeProvider("default");
+        const router = new router_js_1.MemoryRouter({
+            providers: new Map([["default", defaultP]]),
+            defaultProviderId: "default",
+        });
+        const item = await router.write({
+            namespace: "user:1",
+            type: "cross_thread",
+            content: "hello",
+        });
+        node_assert_1.default.ok(item.id);
+        node_assert_1.default.strictEqual(item.content, "hello");
+        const items = await router.query({
+            namespace: "user:1",
+            query: "any",
+            topK: 5,
+        });
+        node_assert_1.default.strictEqual(items.length, 1);
+        node_assert_1.default.strictEqual(items[0].content, "hello");
+    });
+});
+//# sourceMappingURL=router.test.js.map

package/dist/test/core/router.test.js.map

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

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

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

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

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

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

@@ -0,0 +1,122 @@
+"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 node_path_1 = require("node:path");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_crypto_1 = require("node:crypto");
+const create_agent_memory_js_1 = require("../src/create-agent-memory.js");
+(0, node_test_1.describe)("createAgentMemory", () => {
+    (0, node_test_1.it)("memorize with content and type delegates to core memory", async () => {
+        const memory = await (0, create_agent_memory_js_1.createAgentMemory)({
+            config: {
+                providers: [{ id: "default", type: "in_memory" }],
+                router: { defaultProvider: "default", rules: [] },
+            },
+        });
+        const item = await memory.memorize({
+            namespace: "user:1",
+            type: "cross_thread",
+            content: "User likes cats.",
+        });
+        node_assert_1.default.ok(item.id);
+        node_assert_1.default.strictEqual(item.content, "User likes cats.");
+        node_assert_1.default.strictEqual(item.type, "cross_thread");
+        const result = await memory.recall({
+            namespace: "user:1",
+            query: "cats",
+            topK: 5,
+        });
+        node_assert_1.default.strictEqual(result.items.length, 1);
+    });
+    (0, node_test_1.it)("memorize with url ingests file and stores chunks", async () => {
+        const dir = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `ingest-wrapper-${(0, node_crypto_1.randomUUID)()}`);
+        await (0, promises_1.mkdir)(dir, { recursive: true });
+        const filePath = (0, node_path_1.join)(dir, "note.txt");
+        await (0, promises_1.writeFile)(filePath, "Chunk one.\n\nChunk two.", "utf-8");
+        const memory = await (0, create_agent_memory_js_1.createAgentMemory)({
+            config: {
+                providers: [{ id: "default", type: "in_memory" }],
+                router: { defaultProvider: "default", rules: [] },
+            },
+        });
+        try {
+            const item = await memory.memorize({
+                namespace: "test",
+                url: filePath,
+            });
+            node_assert_1.default.ok(item.id);
+            node_assert_1.default.strictEqual(item.type, "knowledge");
+            const result = await memory.recall({
+                namespace: "test",
+                query: "Chunk",
+                topK: 10,
+            });
+            node_assert_1.default.ok(result.items.length >= 1);
+        }
+        finally {
+            await (0, promises_1.rm)(dir, { recursive: true, force: true }).catch(() => { });
+        }
+    });
+    (0, node_test_1.it)("memorize without url and without content throws", async () => {
+        const memory = await (0, create_agent_memory_js_1.createAgentMemory)({
+            config: {
+                providers: [{ id: "default", type: "in_memory" }],
+                router: { defaultProvider: "default", rules: [] },
+            },
+        });
+        await node_assert_1.default.rejects(() => memory.memorize({ namespace: "test" }), /memorize requires url or content/);
+    });
+    (0, node_test_1.it)("write (deprecated) delegates to extended memorize", async () => {
+        const memory = await (0, create_agent_memory_js_1.createAgentMemory)({
+            config: {
+                providers: [{ id: "default", type: "in_memory" }],
+                router: { defaultProvider: "default", rules: [] },
+            },
+        });
+        const item = await memory.write({
+            namespace: "user:1",
+            type: "cross_thread",
+            content: "Written via write.",
+        });
+        node_assert_1.default.ok(item.id);
+        node_assert_1.default.strictEqual(item.content, "Written via write.");
+        const result = await memory.retrieveForPrompt({
+            namespace: "user:1",
+            query: "any",
+            topK: 5,
+        });
+        node_assert_1.default.strictEqual(result.items.length, 1);
+    });
+    (0, node_test_1.it)("recall and retrieveForPrompt delegate to underlying memory", async () => {
+        const memory = await (0, create_agent_memory_js_1.createAgentMemory)({
+            config: {
+                providers: [{ id: "default", type: "in_memory" }],
+                router: { defaultProvider: "default", rules: [] },
+            },
+        });
+        await memory.memorize({
+            namespace: "ns",
+            type: "knowledge",
+            content: "Delegation test.",
+        });
+        const recallResult = await memory.recall({
+            namespace: "ns",
+            query: "Delegation",
+            topK: 5,
+        });
+        node_assert_1.default.strictEqual(recallResult.items.length, 1);
+        const promptResult = await memory.retrieveForPrompt({
+            namespace: "ns",
+            query: "test",
+            topK: 5,
+        });
+        node_assert_1.default.strictEqual(promptResult.items.length, 1);
+        node_assert_1.default.ok(promptResult.traceId);
+    });
+});
+//# sourceMappingURL=create-agent-memory.test.js.map

package/dist/test/create-agent-memory.test.js.map

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

package/dist/test/ingest/url-ingest.test.d.ts

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

package/dist/test/ingest/url-ingest.test.d.ts.map

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

package/dist/test/ingest/url-ingest.test.js

@@ -0,0 +1,142 @@
+"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 node_path_1 = require("node:path");
+const promises_1 = require("node:fs/promises");
+const node_os_1 = require("node:os");
+const node_crypto_1 = require("node:crypto");
+const agent_memory_js_1 = require("../../src/core/agent-memory.js");
+const router_js_1 = require("../../src/core/router.js");
+const in_memory_store_js_1 = require("../../src/providers/in-memory-store.js");
+const url_ingest_js_1 = require("../../src/ingest/url-ingest.js");
+function makeTestMemory() {
+    const provider = new in_memory_store_js_1.InMemoryStoreProvider();
+    const router = new router_js_1.MemoryRouter({
+        providers: new Map([["default", provider]]),
+        defaultProviderId: "default",
+    });
+    return new agent_memory_js_1.AgentMemory({ router });
+}
+(0, node_test_1.describe)("ingestUrlToMemory", () => {
+    (0, node_test_1.it)("ingests local txt file and memorizes chunks", async () => {
+        const dir = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `agent-memory-ingest-${(0, node_crypto_1.randomUUID)()}`);
+        await (0, promises_1.mkdir)(dir, { recursive: true });
+        const filePath = (0, node_path_1.join)(dir, "doc.txt");
+        const content = "First paragraph.\n\nSecond paragraph.\n\nThird.";
+        await (0, promises_1.writeFile)(filePath, content, "utf-8");
+        const memory = makeTestMemory();
+        try {
+            const { count, firstItem } = await (0, url_ingest_js_1.ingestUrlToMemory)(memory, {
+                url: filePath,
+                namespace: "test",
+                chunkSize: 50,
+            });
+            node_assert_1.default.ok(count >= 1);
+            node_assert_1.default.ok(firstItem?.id);
+            node_assert_1.default.strictEqual(firstItem?.type, "knowledge");
+            const result = await memory.recall({
+                namespace: "test",
+                query: "paragraph",
+                topK: 10,
+            });
+            node_assert_1.default.ok(result.items.length >= 1);
+        }
+        finally {
+            await (0, promises_1.rm)(dir, { recursive: true, force: true }).catch(() => { });
+        }
+    });
+    (0, node_test_1.it)("ingests HTML and strips tags", async () => {
+        const dir = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `agent-memory-html-${(0, node_crypto_1.randomUUID)()}`);
+        await (0, promises_1.mkdir)(dir, { recursive: true });
+        const filePath = (0, node_path_1.join)(dir, "page.html");
+        await (0, promises_1.writeFile)(filePath, "<html><body><script>ignore</script><p>Visible text</p></body></html>", "utf-8");
+        const memory = makeTestMemory();
+        try {
+            const { count, firstItem } = await (0, url_ingest_js_1.ingestUrlToMemory)(memory, {
+                url: filePath,
+                namespace: "test",
+                chunkSize: 500,
+            });
+            node_assert_1.default.ok(count >= 1);
+            node_assert_1.default.ok(firstItem);
+            const result = await memory.recall({
+                namespace: "test",
+                query: "Visible",
+                topK: 5,
+            });
+            node_assert_1.default.strictEqual(result.items.length, 1);
+            node_assert_1.default.ok(result.items[0].content.includes("Visible text"));
+            node_assert_1.default.ok(!result.items[0].content.includes("<script>"));
+        }
+        finally {
+            await (0, promises_1.rm)(dir, { recursive: true, force: true }).catch(() => { });
+        }
+    });
+    (0, node_test_1.it)("uses captionFn for image when provided", async () => {
+        const dir = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `agent-memory-img-${(0, node_crypto_1.randomUUID)()}`);
+        await (0, promises_1.mkdir)(dir, { recursive: true });
+        const filePath = (0, node_path_1.join)(dir, "fake.png");
+        await (0, promises_1.writeFile)(filePath, "not a real png", "utf-8");
+        const memory = makeTestMemory();
+        const captionFn = async (_buffer) => "Caption for image";
+        try {
+            const { count, firstItem } = await (0, url_ingest_js_1.ingestUrlToMemory)(memory, {
+                url: filePath,
+                namespace: "test",
+                captionFn,
+                chunkSize: 500,
+            });
+            node_assert_1.default.ok(count >= 1);
+            node_assert_1.default.strictEqual(firstItem?.content, "Caption for image");
+        }
+        finally {
+            await (0, promises_1.rm)(dir, { recursive: true, force: true }).catch(() => { });
+        }
+    });
+    (0, node_test_1.it)("uses placeholder when image and no captionFn", async () => {
+        const dir = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `agent-memory-img2-${(0, node_crypto_1.randomUUID)()}`);
+        await (0, promises_1.mkdir)(dir, { recursive: true });
+        const filePath = (0, node_path_1.join)(dir, "x.png");
+        await (0, promises_1.writeFile)(filePath, "x", "utf-8");
+        const memory = makeTestMemory();
+        try {
+            const { count, firstItem } = await (0, url_ingest_js_1.ingestUrlToMemory)(memory, {
+                url: filePath,
+                namespace: "test",
+                chunkSize: 500,
+            });
+            node_assert_1.default.ok(count >= 1);
+            node_assert_1.default.ok(firstItem?.content.startsWith("(image:"));
+        }
+        finally {
+            await (0, promises_1.rm)(dir, { recursive: true, force: true }).catch(() => { });
+        }
+    });
+    (0, node_test_1.it)("detects image by magic bytes when path has no extension (e.g. upload temp file)", async () => {
+        const dir = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `agent-memory-img3-${(0, node_crypto_1.randomUUID)()}`);
+        await (0, promises_1.mkdir)(dir, { recursive: true });
+        const minimalPng = Buffer.from("iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==", "base64");
+        const filePath = (0, node_path_1.join)(dir, "upload-temp-no-ext");
+        await (0, promises_1.writeFile)(filePath, minimalPng);
+        const captionFn = async (_buffer) => "Caption for image";
+        const memory = makeTestMemory();
+        try {
+            const { count, firstItem } = await (0, url_ingest_js_1.ingestUrlToMemory)(memory, {
+                url: filePath,
+                namespace: "test",
+                chunkSize: 500,
+                captionFn,
+            });
+            node_assert_1.default.strictEqual(count, 1, "image should produce exactly one caption, not many chunks");
+            node_assert_1.default.strictEqual(firstItem?.content, "Caption for image");
+        }
+        finally {
+            await (0, promises_1.rm)(dir, { recursive: true, force: true }).catch(() => { });
+        }
+    });
+});
+//# sourceMappingURL=url-ingest.test.js.map

package/dist/test/ingest/url-ingest.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-ingest.test.js","sourceRoot":"","sources":["../../../test/ingest/url-ingest.test.ts"],"names":[],"mappings":";;;;;AAAA,yCAAyC;AACzC,8DAAiC;AACjC,yCAAiC;AACjC,+CAAwD;AACxD,qCAAiC;AACjC,6CAAyC;AACzC,oEAA6D;AAC7D,wDAAwD;AAExD,+EAA+E;AAC/E,kEAAmE;AAEnE,SAAS,cAAc;IACrB,MAAM,QAAQ,GAAmB,IAAI,0CAAqB,EAAE,CAAC;IAC7D,MAAM,MAAM,GAAG,IAAI,wBAAY,CAAC;QAC9B,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3C,iBAAiB,EAAE,SAAS;KAC7B,CAAC,CAAC;IACH,OAAO,IAAI,6BAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,IAAA,oBAAQ,EAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,IAAA,cAAE,EAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;QAC3D,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,uBAAuB,IAAA,wBAAU,GAAE,EAAE,CAAC,CAAC;QAClE,MAAM,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,iDAAiD,CAAC;QAClE,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,IAAA,iCAAiB,EAAC,MAAM,EAAE;gBAC3D,GAAG,EAAE,QAAQ;gBACb,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,EAAE;aACd,CAAC,CAAC;YACH,qBAAM,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACtB,qBAAM,CAAC,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACzB,qBAAM,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;gBACjC,SAAS,EAAE,MAAM;gBACjB,KAAK,EAAE,WAAW;gBAClB,IAAI,EAAE,EAAE;aACT,CAAC,CAAC;YACH,qBAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;QACtC,CAAC;gBAAS,CAAC;YACT,MAAM,IAAA,aAAE,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,cAAE,EAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,qBAAqB,IAAA,wBAAU,GAAE,EAAE,CAAC,CAAC;QAChE,MAAM,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACxC,MAAM,IAAA,oBAAS,EACb,QAAQ,EACR,sEAAsE,EACtE,OAAO,CACR,CAAC;QACF,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,IAAA,iCAAiB,EAAC,MAAM,EAAE;gBAC3D,GAAG,EAAE,QAAQ;gBACb,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YACH,qBAAM,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACtB,qBAAM,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YACrB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;gBACjC,SAAS,EAAE,MAAM;gBACjB,KAAK,EAAE,SAAS;gBAChB,IAAI,EAAE,CAAC;aACR,CAAC,CAAC;YACH,qBAAM,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAC3C,qBAAM,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;YAC5D,qBAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;QAC3D,CAAC;gBAAS,CAAC;YACT,MAAM,IAAA,aAAE,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,cAAE,EAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,oBAAoB,IAAA,wBAAU,GAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACvC,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,KAAK,EAAE,OAAe,EAAmB,EAAE,CAAC,mBAAmB,CAAC;QAClF,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,IAAA,iCAAiB,EAAC,MAAM,EAAE;gBAC3D,GAAG,EAAE,QAAQ;gBACb,SAAS,EAAE,MAAM;gBACjB,SAAS;gBACT,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YACH,qBAAM,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACtB,qBAAM,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC9D,CAAC;gBAAS,CAAC;YACT,MAAM,IAAA,aAAE,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,cAAE,EAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,qBAAqB,IAAA,wBAAU,GAAE,EAAE,CAAC,CAAC;QAChE,MAAM,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpC,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,IAAA,iCAAiB,EAAC,MAAM,EAAE;gBAC3D,GAAG,EAAE,QAAQ;gBACb,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,GAAG;aACf,CAAC,CAAC;YACH,qBAAM,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;YACtB,qBAAM,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QACtD,CAAC;gBAAS,CAAC;YACT,MAAM,IAAA,aAAE,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,IAAA,cAAE,EAAC,iFAAiF,EAAE,KAAK,IAAI,EAAE;QAC/F,MAAM,GAAG,GAAG,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,qBAAqB,IAAA,wBAAU,GAAE,EAAE,CAAC,CAAC;QAChE,MAAM,IAAA,gBAAK,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAC5B,kGAAkG,EAClG,QAAQ,CACT,CAAC;QACF,MAAM,QAAQ,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,oBAAoB,CAAC,CAAC;QACjD,MAAM,IAAA,oBAAS,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QACtC,MAAM,SAAS,GAAG,KAAK,EAAE,OAAe,EAAmB,EAAE,CAAC,mBAAmB,CAAC;QAClF,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,IAAA,iCAAiB,EAAC,MAAM,EAAE;gBAC3D,GAAG,EAAE,QAAQ;gBACb,SAAS,EAAE,MAAM;gBACjB,SAAS,EAAE,GAAG;gBACd,SAAS;aACV,CAAC,CAAC;YACH,qBAAM,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,2DAA2D,CAAC,CAAC;YAC1F,qBAAM,CAAC,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC9D,CAAC;gBAAS,CAAC;YACT,MAAM,IAAA,aAAE,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/test/integration/agent-memory-flow.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Integration tests: full createAgentMemory → memorize → recall flow.
+ */
+export {};
+//# sourceMappingURL=agent-memory-flow.test.d.ts.map

package/dist/test/integration/agent-memory-flow.test.d.ts.map

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

package/dist/test/integration/agent-memory-flow.test.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Integration tests: full createAgentMemory → memorize → recall flow.
+ */
+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 create_agent_memory_js_1 = require("../../src/create-agent-memory.js");
+(0, node_test_1.describe)("createAgentMemory integration", () => {
+    (0, node_test_1.it)("createAgentMemory with config: memorize and recall", async () => {
+        const memory = await (0, create_agent_memory_js_1.createAgentMemory)({
+            config: {
+                providers: [{ id: "default", type: "in_memory" }],
+                router: { defaultProvider: "default", rules: [] },
+            },
+        });
+        const item = await memory.memorize({
+            namespace: "user:1",
+            type: "cross_thread",
+            content: "User prefers dark mode.",
+        });
+        node_assert_1.default.ok(item.id);
+        node_assert_1.default.strictEqual(item.content, "User prefers dark mode.");
+        node_assert_1.default.strictEqual(item.type, "cross_thread");
+        const result = await memory.recall({
+            namespace: "user:1",
+            query: "user preferences",
+            topK: 5,
+        });
+        node_assert_1.default.strictEqual(result.items.length, 1);
+        node_assert_1.default.strictEqual(result.items[0].content, "User prefers dark mode.");
+    });
+    (0, node_test_1.it)("retrieveForPrompt returns formatted items", async () => {
+        const memory = await (0, create_agent_memory_js_1.createAgentMemory)({
+            config: {
+                providers: [{ id: "default", type: "in_memory" }],
+                router: { defaultProvider: "default", rules: [] },
+            },
+        });
+        await memory.memorize({
+            namespace: "user:1",
+            type: "knowledge",
+            content: "API docs: GET /users returns list.",
+        });
+        const result = await memory.retrieveForPrompt({
+            namespace: "user:1",
+            query: "API",
+            topK: 5,
+        });
+        node_assert_1.default.ok(result.traceId);
+        node_assert_1.default.ok(result.injectedText.includes("knowledge"));
+        node_assert_1.default.strictEqual(result.items.length, 1);
+        node_assert_1.default.strictEqual(result.items[0].content, "API docs: GET /users returns list.");
+    });
+    (0, node_test_1.it)("write (deprecated) and recall", async () => {
+        const memory = await (0, create_agent_memory_js_1.createAgentMemory)({
+            config: {
+                providers: [{ id: "default", type: "in_memory" }],
+                router: { defaultProvider: "default", rules: [] },
+            },
+        });
+        const item = await memory.write({
+            namespace: "user:1",
+            type: "cross_thread",
+            content: "Legacy write.",
+        });
+        node_assert_1.default.ok(item.id);
+        const result = await memory.recall({
+            namespace: "user:1",
+            query: "any",
+            topK: 5,
+        });
+        node_assert_1.default.strictEqual(result.items.length, 1);
+        node_assert_1.default.strictEqual(result.items[0].content, "Legacy write.");
+    });
+});
+//# sourceMappingURL=agent-memory-flow.test.js.map

package/dist/test/integration/agent-memory-flow.test.js.map

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

package/dist/test/integration/helpers/ollama-live.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Helpers for live integration tests: call real Ollama VLM (caption) and LLM (classify).
+ * Used only when RUN_LIVE_INTEGRATION=1; no use-case hardcoding.
+ */
+import type { MemoryType } from "../../../src/core/types.js";
+/**
+ * Create a captionFn that calls the given Ollama VLM with the image buffer.
+ * Uses /api/chat with images (recommended for vision models like qwen3-vl).
+ */
+export declare function createOllamaCaptionFn(vlmBaseUrl: string, model: string, prompt?: string): (buffer: Buffer) => Promise<string>;
+/**
+ * Create a classifyMemory callback that calls the given Ollama LLM to infer
+ * memory type (thread / cross_thread / knowledge). Returns one of the allowed types.
+ */
+export declare function createOllamaClassifyMemoryFn(llmBaseUrl: string, model: string): (content: string, _metadata?: Record<string, unknown>) => Promise<MemoryType>;
+//# sourceMappingURL=ollama-live.d.ts.map

package/dist/test/integration/helpers/ollama-live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-live.d.ts","sourceRoot":"","sources":["../../../../test/integration/helpers/ollama-live.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAyF7D;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAqD,GAC5D,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAQrC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,UAAU,CAAC,CAgB/E"}

package/dist/test/integration/helpers/ollama-live.js

@@ -0,0 +1,101 @@
+"use strict";
+/**
+ * Helpers for live integration tests: call real Ollama VLM (caption) and LLM (classify).
+ * Used only when RUN_LIVE_INTEGRATION=1; no use-case hardcoding.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOllamaCaptionFn = createOllamaCaptionFn;
+exports.createOllamaClassifyMemoryFn = createOllamaClassifyMemoryFn;
+const MEMORY_TYPES = ["thread", "cross_thread", "knowledge"];
+/** Normalize base URL (no trailing slash) for fetch. */
+function baseUrl(url) {
+    return url.replace(/\/+$/, "") || url;
+}
+/**
+ * Call Ollama /api/generate with optional images; return full response text.
+ * Uses stream: false so we get a single JSON with "response".
+ */
+async function ollamaGenerate(baseUrlStr, model, prompt, options = {}) {
+    const url = `${baseUrl(baseUrlStr)}/api/generate`;
+    const body = {
+        model,
+        prompt,
+        stream: false,
+    };
+    if (options.images?.length)
+        body.images = options.images;
+    if (options.system)
+        body.system = options.system;
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Ollama generate failed ${res.status}: ${text}`);
+    }
+    const data = (await res.json());
+    const text = data.response ?? "";
+    return text.trim();
+}
+/**
+ * Call Ollama /api/chat with images (vision); return assistant message content.
+ * Some VLMs work more reliably with chat than generate.
+ */
+async function ollamaChatWithImage(baseUrlStr, model, userPrompt, imagesBase64) {
+    const url = `${baseUrl(baseUrlStr)}/api/chat`;
+    const body = {
+        model,
+        stream: false,
+        messages: [{ role: "user", content: userPrompt }],
+        images: imagesBase64,
+    };
+    const res = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Ollama chat failed ${res.status}: ${text}`);
+    }
+    const data = (await res.json());
+    const text = data.message?.content ?? "";
+    return text.trim();
+}
+/**
+ * Create a captionFn that calls the given Ollama VLM with the image buffer.
+ * Uses /api/chat with images (recommended for vision models like qwen3-vl).
+ */
+function createOllamaCaptionFn(vlmBaseUrl, model, prompt = "Describe this image in one short sentence.") {
+    return async (buffer) => {
+        const base64 = buffer.toString("base64");
+        const caption = await ollamaChatWithImage(vlmBaseUrl, model, prompt, [
+            base64,
+        ]);
+        return caption || "(no caption)";
+    };
+}
+/**
+ * Create a classifyMemory callback that calls the given Ollama LLM to infer
+ * memory type (thread / cross_thread / knowledge). Returns one of the allowed types.
+ */
+function createOllamaClassifyMemoryFn(llmBaseUrl, model) {
+    const systemPrompt = `You classify memory content into exactly one word: thread, cross_thread, or knowledge.
+- thread: session-specific, ephemeral.
+- cross_thread: user preferences, facts, cross-session.
+- knowledge: documentation, APIs, long-lived reference.
+Reply with only that one word, nothing else.`;
+    return async (content) => {
+        const prompt = `Classify this memory:\n\n${content.slice(0, 500)}`;
+        const raw = await ollamaGenerate(llmBaseUrl, model, prompt, {
+            system: systemPrompt,
+        });
+        const word = raw.toLowerCase().replace(/\s+/g, " ").trim().split(/\s/)[0];
+        if (MEMORY_TYPES.includes(word))
+            return word;
+        return "cross_thread";
+    };
+}
+//# sourceMappingURL=ollama-live.js.map