@centerseedwu/naru-agent 0.2.0

package/dist/knowledge/in-memory-store.js

@@ -0,0 +1,54 @@
+import { formatKnowledgeContext } from "./base.js";
+import { cosineSimilarity } from "../utils/math.js";
+/**
+ * In-memory vector knowledge store for development and testing.
+ * Uses cosine similarity for search — no external dependencies.
+ *
+ * @deprecated Use {@link ChromaKnowledgeStore} for production workloads.
+ */
+export class InMemoryKnowledgeStore {
+    docs = [];
+    embedFn;
+    constructor(config) {
+        this.embedFn = config.embedFn;
+    }
+    /**
+     * Ingest a list of text documents. Computes embeddings in batch.
+     */
+    async batchIngest(texts, metadataList) {
+        const embeddings = await this.embedFn(texts);
+        for (let i = 0; i < texts.length; i++) {
+            this.docs.push({
+                text: texts[i],
+                embedding: embeddings[i],
+                metadata: metadataList?.[i] ?? {},
+            });
+        }
+    }
+    /**
+     * Ingest a single document.
+     */
+    async ingest(text, metadata) {
+        await this.batchIngest([text], metadata ? [metadata] : undefined);
+    }
+    async search(query, topK = 3) {
+        if (this.docs.length === 0)
+            return [];
+        const [queryEmbedding] = await this.embedFn([query]);
+        return this.docs
+            .map((doc) => ({
+            text: doc.text,
+            score: cosineSimilarity(queryEmbedding, doc.embedding),
+            metadata: doc.metadata,
+        }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, topK);
+    }
+    formatContext(results, minScore = 0.3) {
+        return formatKnowledgeContext(results, minScore);
+    }
+    get size() {
+        return this.docs.length;
+    }
+}
+//# sourceMappingURL=in-memory-store.js.map

package/dist/knowledge/in-memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../../src/knowledge/in-memory-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AASpD;;;;;GAKG;AACH,MAAM,OAAO,sBAAsB;IACzB,IAAI,GAAgB,EAAE,CAAC;IACvB,OAAO,CAAU;IAEzB,YAAY,MAA4B;QACtC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CACf,KAAe,EACf,YAA6C;QAE7C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBACd,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;gBACxB,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE;aAClC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,QAAkC;QAC3D,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,IAAI,GAAG,CAAC;QAClC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAEtC,MAAM,CAAC,cAAc,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAErD,OAAO,IAAI,CAAC,IAAI;aACb,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACb,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,gBAAgB,CAAC,cAAc,EAAE,GAAG,CAAC,SAAS,CAAC;YACtD,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACvB,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,aAAa,CAAC,OAA0B,EAAE,QAAQ,GAAG,GAAG;QACtD,OAAO,sBAAsB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;CACF"}

package/dist/knowledge/pgvector-store.d.ts

@@ -0,0 +1,27 @@
+import type { BaseKnowledgeStore, KnowledgeResult } from "./base.js";
+import type { EmbedFn } from "../types.js";
+/**
+ * pgvector-backed knowledge store for vector retrieval.
+ */
+export declare class PgVectorKnowledgeStore implements BaseKnowledgeStore {
+    private pool;
+    private embedFn;
+    private tableName;
+    private dimensions;
+    private initialized;
+    constructor(config: {
+        pool: import("pg").Pool;
+        embedFn: EmbedFn;
+        tableName?: string;
+        dimensions?: number;
+    });
+    private ensureTable;
+    search(query: string, topK?: number): Promise<KnowledgeResult[]>;
+    formatContext(results: KnowledgeResult[], minScore?: number): string;
+    ingest(chunks: Array<{
+        id: string;
+        content: string;
+        metadata?: Record<string, unknown>;
+    }>, batchSize?: number): Promise<number>;
+}
+//# sourceMappingURL=pgvector-store.d.ts.map

package/dist/knowledge/pgvector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgvector-store.d.ts","sourceRoot":"","sources":["../../src/knowledge/pgvector-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAErE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG3C;;GAEG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE;QAClB,IAAI,EAAE,OAAO,IAAI,EAAE,IAAI,CAAC;QACxB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;YAOa,WAAW;IAcnB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAkBjE,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,QAAQ,SAAM,GAAG,MAAM;IAI3D,MAAM,CACV,MAAM,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,EAClF,SAAS,SAAK,GACb,OAAO,CAAC,MAAM,CAAC;CAyBnB"}

package/dist/knowledge/pgvector-store.js

@@ -0,0 +1,68 @@
+import { formatKnowledgeContext } from "./base.js";
+import { toVectorLiteral } from "../utils/math.js";
+/**
+ * pgvector-backed knowledge store for vector retrieval.
+ */
+export class PgVectorKnowledgeStore {
+    pool;
+    embedFn;
+    tableName;
+    dimensions;
+    initialized = false;
+    constructor(config) {
+        this.pool = config.pool;
+        this.embedFn = config.embedFn;
+        this.tableName = config.tableName ?? "naru_knowledge";
+        this.dimensions = config.dimensions ?? 1536;
+    }
+    async ensureTable() {
+        if (this.initialized)
+            return;
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS ${this.tableName} (
+        id TEXT PRIMARY KEY,
+        content TEXT NOT NULL,
+        metadata JSONB DEFAULT '{}',
+        embedding vector(${this.dimensions}),
+        created_at TIMESTAMPTZ DEFAULT NOW()
+      )
+    `);
+        this.initialized = true;
+    }
+    async search(query, topK = 3) {
+        await this.ensureTable();
+        const [queryEmbedding] = await this.embedFn([query]);
+        const result = await this.pool.query(`SELECT content, metadata,
+              1 - (embedding <=> $1::vector) AS score
+       FROM ${this.tableName}
+       ORDER BY embedding <=> $1::vector
+       LIMIT $2`, [toVectorLiteral(queryEmbedding), topK]);
+        return result.rows.map((r) => ({
+            text: r.content,
+            score: r.score,
+            metadata: (r.metadata ?? {}),
+        }));
+    }
+    formatContext(results, minScore = 0.3) {
+        return formatKnowledgeContext(results, minScore);
+    }
+    async ingest(chunks, batchSize = 20) {
+        await this.ensureTable();
+        let count = 0;
+        for (let i = 0; i < chunks.length; i += batchSize) {
+            const batch = chunks.slice(i, i + batchSize);
+            const embeddings = await this.embedFn(batch.map((c) => c.content));
+            await Promise.all(batch.map((chunk, j) => this.pool.query(`INSERT INTO ${this.tableName} (id, content, metadata, embedding)
+             VALUES ($1, $2, $3, $4)
+             ON CONFLICT (id) DO UPDATE SET content = $2, metadata = $3, embedding = $4`, [
+                chunk.id,
+                chunk.content,
+                JSON.stringify(chunk.metadata ?? {}),
+                toVectorLiteral(embeddings[j]),
+            ])));
+            count += batch.length;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=pgvector-store.js.map

package/dist/knowledge/pgvector-store.js.map

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

package/dist/memory/base.d.ts

@@ -0,0 +1,21 @@
+export interface MemoryItem {
+    id: string;
+    userId: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    score?: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Format memory items into a context string for LLM injection.
+ */
+export declare function formatMemoryContext(memories: MemoryItem[]): string;
+export interface MemoryStore {
+    add(item: MemoryItem, embedding: number[]): Promise<void>;
+    search(userId: string, embedding: number[], topK?: number): Promise<MemoryItem[]>;
+    update(itemId: string, content: string, embedding: number[]): Promise<void>;
+    delete(itemId: string): Promise<void>;
+    getAll(userId: string): Promise<MemoryItem[]>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/memory/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/memory/base.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAGlE;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAClF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CAC/C"}

package/dist/memory/base.js

@@ -0,0 +1,9 @@
+/**
+ * Format memory items into a context string for LLM injection.
+ */
+export function formatMemoryContext(memories) {
+    if (memories.length === 0)
+        return "";
+    return "User memories:\n" + memories.map((m) => `- ${m.content}`).join("\n");
+}
+//# sourceMappingURL=base.js.map

package/dist/memory/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/memory/base.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAsB;IACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,kBAAkB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/E,CAAC"}

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

@@ -0,0 +1,10 @@
+import type { MemoryItem, MemoryStore } from "./base.js";
+export declare class InMemoryMemoryStore implements MemoryStore {
+    private items;
+    add(item: MemoryItem, embedding: number[]): Promise<void>;
+    search(userId: string, embedding: number[], topK?: number): Promise<MemoryItem[]>;
+    update(itemId: string, content: string, embedding: number[]): Promise<void>;
+    delete(itemId: string): Promise<void>;
+    getAll(userId: string): Promise<MemoryItem[]>;
+}
+//# sourceMappingURL=in-memory-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.d.ts","sourceRoot":"","sources":["../../src/memory/in-memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGzD,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,KAAK,CAAgE;IAEvE,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,MAAM,CACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,EACnB,IAAI,SAAI,GACP,OAAO,CAAC,UAAU,EAAE,CAAC;IAelB,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC;IASV,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAKpD"}

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

@@ -0,0 +1,35 @@
+import { cosineSimilarity } from "../utils/math.js";
+export class InMemoryMemoryStore {
+    items = new Map();
+    async add(item, embedding) {
+        this.items.set(item.id, { item, embedding });
+    }
+    async search(userId, embedding, topK = 5) {
+        const userItems = [...this.items.values()].filter((x) => x.item.userId === userId);
+        return userItems
+            .map((x) => ({
+            item: x.item,
+            score: cosineSimilarity(embedding, x.embedding),
+        }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, topK)
+            .map((x) => ({ ...x.item, score: x.score }));
+    }
+    async update(itemId, content, embedding) {
+        const existing = this.items.get(itemId);
+        if (existing) {
+            existing.item.content = content;
+            existing.item.updatedAt = new Date();
+            existing.embedding = embedding;
+        }
+    }
+    async delete(itemId) {
+        this.items.delete(itemId);
+    }
+    async getAll(userId) {
+        return [...this.items.values()]
+            .filter((x) => x.item.userId === userId)
+            .map((x) => x.item);
+    }
+}
+//# sourceMappingURL=in-memory-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../../src/memory/in-memory-store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,OAAO,mBAAmB;IACtB,KAAK,GAAG,IAAI,GAAG,EAAqD,CAAC;IAE7E,KAAK,CAAC,GAAG,CAAC,IAAgB,EAAE,SAAmB;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CACV,MAAc,EACd,SAAmB,EACnB,IAAI,GAAG,CAAC;QAER,MAAM,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAChC,CAAC;QAEF,OAAO,SAAS;aACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC;SAChD,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;aACd,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,MAAM,CACV,MAAc,EACd,OAAe,EACf,SAAmB;QAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;YACrC,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;QACjC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC;aACvC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;CACF"}

package/dist/memory/manager.d.ts

@@ -0,0 +1,29 @@
+import { type LanguageModel } from "ai";
+import { type MemoryItem, type MemoryStore } from "./base.js";
+import type { EmbedFn } from "../types.js";
+/**
+ * @deprecated Use Mem0MemoryManager for production.
+ */
+export declare class MemoryManager {
+    private model;
+    private store;
+    private embedFn;
+    private reconciliationTopK;
+    constructor(config: {
+        model: LanguageModel;
+        store: MemoryStore;
+        embedFn: EmbedFn;
+        reconciliationTopK?: number;
+    });
+    /**
+     * Extract facts from messages and reconcile with existing memories.
+     */
+    add(userId: string, messages: Array<{
+        role: string;
+        content: string;
+    }>): Promise<MemoryItem[]>;
+    search(userId: string, query: string, topK?: number): Promise<MemoryItem[]>;
+    getContextString(userId: string, query: string, topK?: number): Promise<string>;
+}
+export { MemoryManager as LLMMemoryManager };
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/memory/manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AAGxD,OAAO,EAAuB,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAiB3C;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,MAAM,EAAE;QAClB,KAAK,EAAE,aAAa,CAAC;QACrB,KAAK,EAAE,WAAW,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;KAC7B;IAOD;;OAEG;IACG,GAAG,CACP,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GACjD,OAAO,CAAC,UAAU,EAAE,CAAC;IA6FlB,MAAM,CACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,GACP,OAAO,CAAC,UAAU,EAAE,CAAC;IAKlB,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,GACP,OAAO,CAAC,MAAM,CAAC;CAInB;AAED,OAAO,EAAE,aAAa,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/memory/manager.js

@@ -0,0 +1,121 @@
+import { generateObject } from "ai";
+import { z } from "zod";
+import { v4 as uuidv4 } from "uuid";
+import { formatMemoryContext } from "./base.js";
+const FactExtractionSchema = z.object({
+    facts: z.array(z.string()).describe("Extracted factual statements"),
+});
+const ReconciliationActionSchema = z.object({
+    actions: z.array(z.object({
+        fact: z.string(),
+        action: z.enum(["ADD", "UPDATE", "DELETE", "NONE"]),
+        targetId: z.string().nullable().optional(),
+        updatedText: z.string().nullable().optional(),
+    })),
+});
+/**
+ * @deprecated Use Mem0MemoryManager for production.
+ */
+export class MemoryManager {
+    model;
+    store;
+    embedFn;
+    reconciliationTopK;
+    constructor(config) {
+        this.model = config.model;
+        this.store = config.store;
+        this.embedFn = config.embedFn;
+        this.reconciliationTopK = config.reconciliationTopK ?? 3;
+    }
+    /**
+     * Extract facts from messages and reconcile with existing memories.
+     */
+    async add(userId, messages) {
+        // Step 1: Extract facts
+        const conversationText = messages
+            .map((m) => `${m.role}: ${m.content}`)
+            .join("\n");
+        const { object: extracted } = await generateObject({
+            model: this.model,
+            schema: FactExtractionSchema,
+            prompt: `Extract factual statements about the user from this conversation. Only extract concrete facts, preferences, or personal information.\n\n${conversationText}`,
+        });
+        if (extracted.facts.length === 0)
+            return [];
+        // Step 2: Find similar existing memories for reconciliation (parallel)
+        const factEmbeddings = await this.embedFn(extracted.facts);
+        const searchResults = await Promise.all(factEmbeddings.map((embedding) => this.store.search(userId, embedding, this.reconciliationTopK)));
+        const seenIds = new Set();
+        const existingMemories = [];
+        for (const results of searchResults) {
+            for (const r of results) {
+                if (!seenIds.has(r.id)) {
+                    seenIds.add(r.id);
+                    existingMemories.push(r);
+                }
+            }
+        }
+        // Step 3: Reconcile
+        const existingStr = existingMemories
+            .map((m) => `[${m.id}] ${m.content}`)
+            .join("\n");
+        const { object: reconciliation } = await generateObject({
+            model: this.model,
+            schema: ReconciliationActionSchema,
+            prompt: [
+                "Given new facts and existing memories, decide what to do with each fact.",
+                "Actions: ADD (new fact), UPDATE (modify existing, provide targetId + updatedText), DELETE (remove outdated, provide targetId), NONE (already exists).",
+                "",
+                `New facts:\n${extracted.facts.map((f, i) => `${i + 1}. ${f}`).join("\n")}`,
+                "",
+                existingStr
+                    ? `Existing memories:\n${existingStr}`
+                    : "No existing memories.",
+            ].join("\n"),
+        });
+        // Step 4: Execute actions (parallel)
+        const added = [];
+        await Promise.all(reconciliation.actions.map(async (action) => {
+            switch (action.action) {
+                case "ADD": {
+                    const [embedding] = await this.embedFn([action.fact]);
+                    const item = {
+                        id: uuidv4(),
+                        userId,
+                        content: action.fact,
+                        metadata: {},
+                        createdAt: new Date(),
+                        updatedAt: new Date(),
+                    };
+                    await this.store.add(item, embedding);
+                    added.push(item);
+                    break;
+                }
+                case "UPDATE": {
+                    if (action.targetId && action.updatedText) {
+                        const [embedding] = await this.embedFn([action.updatedText]);
+                        await this.store.update(action.targetId, action.updatedText, embedding);
+                    }
+                    break;
+                }
+                case "DELETE": {
+                    if (action.targetId) {
+                        await this.store.delete(action.targetId);
+                    }
+                    break;
+                }
+            }
+        }));
+        return added;
+    }
+    async search(userId, query, topK = 5) {
+        const [embedding] = await this.embedFn([query]);
+        return this.store.search(userId, embedding, topK);
+    }
+    async getContextString(userId, query, topK = 5) {
+        const memories = await this.search(userId, query, topK);
+        return formatMemoryContext(memories);
+    }
+}
+export { MemoryManager as LLMMemoryManager };
+//# sourceMappingURL=manager.js.map

package/dist/memory/manager.js.map

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

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

@@ -0,0 +1,32 @@
+import { type MemoryItem } from "./base.js";
+interface Mem0Config {
+    apiKey: string;
+    organizationId?: string;
+    projectId?: string;
+}
+/**
+ * Production memory manager backed by Mem0 (mem0ai).
+ * Same public API as MemoryManager but delegates to Mem0's hosted service.
+ * Requires `mem0ai` as a peer dependency.
+ */
+export declare class Mem0MemoryManager {
+    private clientPromise;
+    private apiKey;
+    private organizationId?;
+    private projectId?;
+    constructor(config: Mem0Config);
+    private getClient;
+    private baseParams;
+    /**
+     * Add messages to Mem0. Mem0 handles fact extraction and reconciliation internally.
+     */
+    add(userId: string, messages: Array<{
+        role: string;
+        content: string;
+    }>): Promise<MemoryItem[]>;
+    search(userId: string, query: string, topK?: number): Promise<MemoryItem[]>;
+    getContextString(userId: string, query: string, topK?: number): Promise<string>;
+    private toMemoryItem;
+}
+export {};
+//# sourceMappingURL=mem0-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mem0-manager.d.ts","sourceRoot":"","sources":["../../src/memory/mem0-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAEjE,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,iBAAiB;IAE5B,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,MAAM,EAAE,UAAU;IAO9B,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACG,GAAG,CACP,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GACjD,OAAO,CAAC,UAAU,EAAE,CAAC;IAYlB,MAAM,CACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,GACP,OAAO,CAAC,UAAU,EAAE,CAAC;IAalB,gBAAgB,CACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,GACP,OAAO,CAAC,MAAM,CAAC;IAMlB,OAAO,CAAC,YAAY;CAWrB"}

package/dist/memory/mem0-manager.js

@@ -0,0 +1,77 @@
+import { formatMemoryContext } from "./base.js";
+/**
+ * Production memory manager backed by Mem0 (mem0ai).
+ * Same public API as MemoryManager but delegates to Mem0's hosted service.
+ * Requires `mem0ai` as a peer dependency.
+ */
+export class Mem0MemoryManager {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    clientPromise = null;
+    apiKey;
+    organizationId;
+    projectId;
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.organizationId = config.organizationId;
+        this.projectId = config.projectId;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getClient() {
+        if (!this.clientPromise) {
+            this.clientPromise = (async () => {
+                const mod = await import("mem0ai");
+                const MemoryClient = mod.MemoryClient ?? mod.default;
+                return new MemoryClient({ apiKey: this.apiKey });
+            })();
+        }
+        return this.clientPromise;
+    }
+    baseParams(userId) {
+        return {
+            user_id: userId,
+            ...(this.organizationId && { org_id: this.organizationId }),
+            ...(this.projectId && { project_id: this.projectId }),
+        };
+    }
+    /**
+     * Add messages to Mem0. Mem0 handles fact extraction and reconciliation internally.
+     */
+    async add(userId, messages) {
+        const client = await this.getClient();
+        const result = await client.add(messages, {
+            ...this.baseParams(userId),
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const results = Array.isArray(result) ? result : result?.results ?? [];
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return results.map((r) => this.toMemoryItem(r, userId));
+    }
+    async search(userId, query, topK = 5) {
+        const client = await this.getClient();
+        const result = await client.search(query, {
+            ...this.baseParams(userId),
+            limit: topK,
+        });
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const results = Array.isArray(result) ? result : result?.results ?? [];
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return results.map((r) => this.toMemoryItem(r, userId));
+    }
+    async getContextString(userId, query, topK = 5) {
+        const memories = await this.search(userId, query, topK);
+        return formatMemoryContext(memories);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    toMemoryItem(raw, userId) {
+        return {
+            id: raw.id ?? raw.memory_id ?? "",
+            userId,
+            content: raw.memory ?? raw.text ?? raw.content ?? "",
+            metadata: raw.metadata ?? {},
+            score: raw.score,
+            createdAt: raw.created_at ? new Date(raw.created_at) : new Date(),
+            updatedAt: raw.updated_at ? new Date(raw.updated_at) : new Date(),
+        };
+    }
+}
+//# sourceMappingURL=mem0-manager.js.map

package/dist/memory/mem0-manager.js.map

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

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

@@ -0,0 +1,22 @@
+import type { MemoryItem, MemoryStore } from "./base.js";
+/**
+ * PostgreSQL + pgvector backed memory store. Requires `pg` as optional dependency.
+ */
+export declare class PgVectorMemoryStore implements MemoryStore {
+    private pool;
+    private tableName;
+    private dimensions;
+    private initialized;
+    constructor(config: {
+        pool: import("pg").Pool;
+        tableName?: string;
+        dimensions?: number;
+    });
+    private ensureTable;
+    add(item: MemoryItem, embedding: number[]): Promise<void>;
+    search(userId: string, embedding: number[], topK?: number): Promise<MemoryItem[]>;
+    update(itemId: string, content: string, embedding: number[]): Promise<void>;
+    delete(itemId: string): Promise<void>;
+    getAll(userId: string): Promise<MemoryItem[]>;
+}
+//# sourceMappingURL=pgvector-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pgvector-store.d.ts","sourceRoot":"","sources":["../../src/memory/pgvector-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGzD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,WAAW;IACrD,OAAO,CAAC,IAAI,CAAoB;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE;QAClB,IAAI,EAAE,OAAO,IAAI,EAAE,IAAI,CAAC;QACxB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;YAMa,WAAW;IAoBnB,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBzD,MAAM,CACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,EACnB,IAAI,SAAI,GACP,OAAO,CAAC,UAAU,EAAE,CAAC;IAsBlB,MAAM,CACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC;IAQV,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAgBpD"}