@amaster.ai/pi-memory-mem0 0.1.8 → 0.1.10

package/README.md

@@ -2,22 +2,49 @@
 
 ![pi-memory-mem0 preview](https://raw.githubusercontent.com/TGYD-helige/pi/master/packages/pi-memory-mem0/preview.png)
 
-Explicit semantic memory tools powered by [Mem0](https://mem0.ai), with support for both Platform (cloud) and Open-Source (local) modes.
+Semantic memory extension powered by [Mem0](https://mem0.ai), with Platform, embedded, and self-hosted backends and three memory modes (hybrid, active, passive).
 
 ## How It Works
 
-Memories are saved and recalled through explicit tools. They are project-namespaced, and stored text is not injected into the system prompt.
+**Passive side**: after each conversation turn, the user + assistant messages are automatically sent to Mem0 for fact extraction and storage. When you send a prompt, a semantic search is prefetched in the background and relevant memories are recalled before the agent starts — **zero effort required**.
 
-Use `mem0_save` and the search/profile tools when memory should be stored or retrieved.
+**Active side**: the agent gets a `mem0_memory` tool (`search` / `add` / `get_all` / `delete`) so it can look up and manage memories on its own initiative — same idea as the official `@mem0/pi-agent-plugin`, but backed by this package's provider abstraction, so it works with Platform, embedded, **and** self-hosted Mem0.
 
-## Two Modes
+Safety boundaries:
+
+- **Recall channel**: recalled memories are injected as a custom message delivered on the user channel — never into the system prompt. Each entry is wrapped as `[UNTRUSTED MEMORY DATA]` (JSON-quoted), and entries matching prompt-injection patterns are replaced with `[BLOCKED UNTRUSTED MEMORY: ...]`.
+- **Project namespacing**: memories are scoped to `userId:project:<cwd-hash>` by default, so one project's memories are not visible in another. Set `userIdScope: "exact"` when one identity must be shared across projects.
+- **Credential redaction**: private keys, bearer tokens, and `api_key=…`-style values are redacted before anything is stored.
+- **Platform mode disclosure**: in `platform` mode the captured turns leave your machine and are processed by Mem0 Cloud. Use `embedded` or `self-hosted` mode to keep memory traffic off third-party infrastructure.
+
+## Modes
+
+### Backend Modes
 
 | Mode | Vector Store | Persistence | Dependencies | Use Case |
 |------|-------------|-------------|--------------|----------|
 | `platform` | Mem0 Cloud | Cloud-managed | `MEM0_API_KEY` | Quick start, multi-device sync |
-| `open-source` | Mem0 OSS vector store | Vector-store managed | LLM + Embedding API | Data privacy, no Mem0 Cloud |
+| `embedded` | Mem0 OSS vector store | Vector-store managed | LLM + Embedding API | Data privacy, no Mem0 Cloud |
+| `self-hosted` | Mem0 OSS REST server | Server-managed | Server URL, optional API key | Shared infrastructure |
+
+### Memory Modes
+
+| `memoryMode` | Auto capture + recall | `mem0_memory` tool | Use Case |
+|--------------|----------------------|--------------------|----------|
+| `hybrid` (default) | ✅ | ✅ | Best recall: automatic context plus agent-driven lookup |
+| `active` | ❌ | ✅ | No background traffic; the agent decides every read/write |
+| `passive` | ✅ | ❌ | Zero tool surface; fully automatic memory |
+
+```json
+{
+  "pi-memory-mem0": {
+    "mode": "embedded",
+    "memoryMode": "hybrid"
+  }
+}
+```
 
-## Architecture (Open-Source Mode)
+## Architecture (Embedded Mode)
 
 ```
 User ←→ Agent ←→ Mem0 OSS Memory
@@ -33,10 +60,7 @@ User ←→ Agent ←→ Mem0 OSS Memory
 
 ## Quick Start
 
-Store configuration in user/agent settings or in a trusted project's
-`.pi/settings.json`. Project settings are ignored when trust is declined and do
-not expand `${ENV_VAR}`; the environment-backed examples below therefore belong
-in user or agent settings.
+Store configuration in user/agent settings or in a trusted project's `.pi/settings.json`. Project settings are ignored when trust is declined and do not expand `${ENV_VAR}`; the environment-backed examples below therefore belong in user or agent settings.
 
 ### Platform Mode
 
@@ -50,14 +74,14 @@ in user or agent settings.
 }
 ```
 
-### Open-Source Mode (Recommended)
+### Embedded Mode (Recommended)
 
 Reuses API keys and base URLs from pi's configured model providers — **no extra environment variables needed**.
 
 ```json
 {
   "pi-memory-mem0": {
-    "mode": "open-source",
+    "mode": "embedded",
     "userId": "${USER}"
   }
 }
@@ -65,6 +89,25 @@ Reuses API keys and base URLs from pi's configured model providers — **no extr
 
 Defaults to OpenAI `text-embedding-3-small` (embedding) + `gpt-4.1-nano` (extraction). API keys and base URLs are automatically resolved from pi's model registry.
 
+Existing settings with `mode: "open-source"` continue to load as `embedded`, but `open-source` is not part of the supported configuration interface. New settings should use `embedded`.
+
+### Self-Hosted Mode
+
+Calls the OSS REST server directly. The server uses `/memories` and `/search`, not the Mem0 Platform `/v1` paths.
+
+```json
+{
+  "pi-memory-mem0": {
+    "mode": "self-hosted",
+    "baseUrl": "${MEM0_BASE_URL}",
+    "apiKey": "${MEM0_API_KEY}",
+    "userId": "${PAPERCLIP_COMPANY_ID}",
+    "agentId": "${PAPERCLIP_AGENT_ID}",
+    "userIdScope": "exact"
+  }
+}
+```
+
 ### Custom Provider
 
 When your model registry defines a custom provider with `api: "openai-completions"`, you can use it directly:
@@ -72,7 +115,7 @@ When your model registry defines a custom provider with `api: "openai-completion
 ```json
 {
   "pi-memory-mem0": {
-    "mode": "open-source",
+    "mode": "embedded",
     "oss": {
       "llm": {
         "provider": "my-provider",
@@ -97,7 +140,7 @@ The extension automatically:
 ```json
 {
   "pi-memory-mem0": {
-    "mode": "open-source",
+    "mode": "embedded",
     "userId": "${USER}",
     "oss": {
       "llm": {
@@ -121,7 +164,7 @@ For production workloads that need a dedicated vector database:
 ```json
 {
   "pi-memory-mem0": {
-    "mode": "open-source",
+    "mode": "embedded",
     "oss": {
       "vectorStore": {
         "provider": "qdrant",
@@ -140,10 +183,14 @@ The configured vector store always owns persistence. To request an intentionally
 
 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
-| `mode` | `"platform"` \| `"open-source"` | `"platform"` | Operating mode |
-| `apiKey` | string | — | Required for platform mode. Supports `${MEM0_API_KEY}` |
-| `baseUrl` | string | `https://api.mem0.ai` | Custom platform endpoint |
+| `mode` | `"platform"` \| `"embedded"` \| `"self-hosted"` | `"platform"` | Operating mode |
+| `memoryMode` | `"hybrid"` \| `"active"` \| `"passive"` | `"hybrid"` | Memory behavior: tool + automation, tool only, or automation only |
+| `apiKey` | string | — | Platform or self-hosted API key. Supports `${MEM0_API_KEY}` |
+| `baseUrl` | string | `https://api.mem0.ai` | Platform override; required for self-hosted mode |
+| `requestTimeoutMs` | number | `30000` | Self-hosted request timeout |
 | `userId` | string | `$USER` or `"default-user"` | Memory scoping identifier |
+| `agentId` | string | — | Optional agent scope. Supports environment interpolation |
+| `userIdScope` | `"project"` \| `"exact"` | `"project"` | Append the cwd hash or use `userId` verbatim |
 | `topK` | number | `5` | Max recalled memories per turn |
 | `useRegistryKeys` | boolean | `true` | Whether OSS mode resolves keys from pi registry |
 | `oss.llm` | object | OpenAI gpt-4.1-nano | OSS extraction model |
@@ -153,14 +200,17 @@ The configured vector store always owns persistence. To request an intentionally
 | `oss.historyDbPath` | string | `<home>/memories/mem0-history.db` | Shortcut for SQLite history DB path |
 | `oss.disableHistory` | boolean | `false` | Disable mem0 operation history |
 
+Embedded and self-hosted modes read and write the exact `userId` + `agentId` scope; Platform mode reads the user and agent entity scopes with OR because Mem0 Platform stores them as separate records. Existing memories with a null `agent_id` are not backfilled automatically.
+
 ## Data Storage
 
 | Mode | Vector Data | History |
 |------|-------------|---------|
 | Platform | Mem0 Cloud | Cloud-managed |
-| Open-Source (default) | `<home>/memories/mem0-vectors.db` | `<home>/memories/mem0-history.db` |
-| Open-Source (`memory`, `dbPath: ":memory:"`) | Process-local SQLite; lost on restart | `<home>/memories/mem0-history.db` |
-| Open-Source (Qdrant) | Qdrant server | `<home>/memories/mem0-history.db` |
+| Embedded (default paths) | `<home>/memories/mem0-vectors.db` | `<home>/memories/mem0-history.db` |
+| Embedded (`memory`, `dbPath: ":memory:"`) | Process-local SQLite; lost on restart | `<home>/memories/mem0-history.db` |
+| Embedded (Qdrant) | Qdrant server | `<home>/memories/mem0-history.db` |
+| Self-hosted | Remote server | Remote server |
 
 The `home` directory is resolved via `resolveHome()` from `@amaster.ai/pi-shared/settings` (defaults to `~/.pi/agent`).
 
@@ -179,7 +229,7 @@ This happens transparently — just configure the provider name as it appears in
 
 ## Installation Notes
 
-The default Open-Source mode depends on `better-sqlite3` (native addon, transitive dependency of `mem0ai`) for both the vector store and history. This remains true for `dbPath: ":memory:"`: it changes where SQLite stores pages, not which vector-store implementation is used.
+The default Embedded configuration depends on `better-sqlite3` (native addon, transitive dependency of `mem0ai`) for both the vector store and history. This remains true for `dbPath: ":memory:"`: it changes where SQLite stores pages, not which vector-store implementation is used.
 
 **For pi-agent users**: pi-agent's `package.json` includes `better-sqlite3` in `pnpm.onlyBuiltDependencies` — it compiles automatically during `pnpm install`. No extra steps needed.
 
@@ -197,11 +247,16 @@ If `better-sqlite3` fails to load (for example, because of a Node ABI mismatch),
 
 ## Tools
 
-| Tool | Description |
-|------|-------------|
-| `mem0_search` | Semantic search over long-term memories |
-| `mem0_profile` | List all stored memories |
-| `mem0_save` | Store a fact verbatim (bypasses LLM extraction) |
+When `memoryMode` is `hybrid` or `active`, the agent gets one action-dispatched tool:
+
+```
+mem0_memory(action="search", query="...")        # Semantic search over memories
+mem0_memory(action="add", content="...")         # Store a durable fact
+mem0_memory(action="get_all")                    # List every stored memory
+mem0_memory(action="delete", memory_id="...")    # Remove a memory by id
+```
+
+Stored content is credential-redacted first; results are returned with the same `[UNTRUSTED MEMORY DATA]` wrapping as passive recall, including the memory ids needed for `delete`.
 
 ## Commands
 
@@ -209,31 +264,35 @@ If `better-sqlite3` fails to load (for example, because of a Node ABI mismatch),
 /mem0 status          # Show current status
 /mem0 search <query>  # Semantic search
 /mem0 profile         # List all memories
+/mem0 add <text>      # Store a memory manually
+/mem0 dedup           # Preview exact duplicates in the current scope
+/mem0 dedup --apply   # Confirm and remove exact duplicates
+/mem0 delete <id>     # Remove a memory by id
 ```
 
 ## Relationship with pi-memory
 
 `pi-memory-mem0` and `pi-memory` run **independently in parallel** as separate extensions:
 
-- `pi-memory`: Active memory — agent explicitly manages via tools, local `.md` files, hard char limits
-- `pi-memory-mem0`: Explicit semantic memory tools backed by Mem0
+- `pi-memory`: Curated memory — the agent explicitly manages memories via the `memory_add` / `memory_replace` / `memory_remove` / `memory_read` tools, local `.md` files, hard char limits
+- `pi-memory-mem0`: Semantic memory — automatic extraction/storage and semantic recall (passive), plus the `mem0_memory` tool for agent-driven semantic lookup (active); no capacity limits
 
-They do not interfere with each other. `pi-memory-mem0` does not inject recalled
-text into the system prompt; the agent retrieves it through the search and
-profile tools.
+They do not interfere with each other, and their tool names do not collide. `pi-memory-mem0` injects recalled text as a custom user-channel message (never the system prompt); `pi-memory` injects its own context separately.
 
 ## Dedup API
 
-The package exports a standalone deduplication function used by pi-memory's dreaming job:
+Normal Mem0 writes use inference, so Mem0's own duplicate and conflict handling remains the primary protection. The package also exports a standalone maintenance function for previewing or removing legacy exact duplicates:
 
 ```ts
 import { dedupMemories } from "@amaster.ai/pi-memory-mem0/dedup";
 
 const result = await dedupMemories({
   userId: "my-user",
+  agentId: "my-agent",
   config: { mode: "platform", apiKey: "..." },
+  dryRun: true,
 });
-// result: { total: 42, duplicatesRemoved: 3 }
+// result: { total: 42, duplicatesFound: 3, duplicatesRemoved: 0, deleteFailures: 0 }
 ```
 
-Normalizes entries (case-insensitive, whitespace-collapsed), identifies exact duplicates, and deletes the older ones through the configured provider. In OSS mode those deletes go directly to the vector store.
+Dedup normalizes entries using Unicode NFC, case-insensitive comparison, and collapsed whitespace, then keeps the newest exact match. Platform user and agent entity scopes are processed independently; embedded and self-hosted modes use the exact `userId` + `agentId` scope. Platform and embedded scopes are limited to 10,000 memories; self-hosted dedup requests the server maximum of 1,000 and fails closed when that limit is reached, so it only applies to scopes proven to contain at most 999 memories. Invalid or repeated IDs, empty memory content, missing, invalid, or tied timestamps, incomplete pagination, inconsistent Platform counts, and cancellation all fail closed; individual deletion failures are reported, and no automatic background cleanup is installed.

package/dist/dedup.d.ts

@@ -4,20 +4,26 @@
  * Normalizes content, identifies exact duplicates (case-insensitive, whitespace-collapsed),
  * deletes the older entries, and keeps only the most recently updated.
  *
- * Both Platform and OSS modes use the provider API. In OSS mode the configured
+ * All modes use the provider interface. In embedded mode the configured
  * vector store is the source of truth and its IDs remain stable across restarts.
  */
-import { type ProviderResolver } from './provider.js';
+import { type Mem0Provider, type ProviderResolver } from './provider.js';
 import type { Mem0ExtensionConfig } from './types.js';
 export interface DedupOptions {
     userId: string;
+    agentId?: string;
     config: Mem0ExtensionConfig;
     resolveProvider?: ProviderResolver;
     signal?: AbortSignal;
+    dryRun?: boolean;
+    approve?: (preview: DedupResult) => boolean | Promise<boolean>;
 }
 export interface DedupResult {
     total: number;
+    duplicatesFound: number;
     duplicatesRemoved: number;
+    deleteFailures: number;
 }
 export declare function dedupMemories(opts: DedupOptions): Promise<DedupResult>;
+export declare function dedupProviderMemories(provider: Mem0Provider, opts: Pick<DedupOptions, 'userId' | 'agentId' | 'signal' | 'dryRun' | 'approve'>): Promise<DedupResult>;
 //# sourceMappingURL=dedup.d.ts.map

package/dist/dedup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../src/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,KAAK,EAAE,mBAAmB,EAAc,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CA2B5E"}
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../src/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAsB,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAc,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAQ5E;AAED,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC,GAC/E,OAAO,CAAC,WAAW,CAAC,CA6DtB"}

package/dist/dedup.js

@@ -4,61 +4,126 @@
  * Normalizes content, identifies exact duplicates (case-insensitive, whitespace-collapsed),
  * deletes the older entries, and keeps only the most recently updated.
  *
- * Both Platform and OSS modes use the provider API. In OSS mode the configured
+ * All modes use the provider interface. In embedded mode the configured
  * vector store is the source of truth and its IDs remain stable across restarts.
  */
 import { createMem0Provider } from './provider.js';
 export async function dedupMemories(opts) {
-    const { userId, config, resolveProvider, signal } = opts;
+    const { config, resolveProvider } = opts;
     const provider = await createMem0Provider({
         config,
         ...(resolveProvider ? { resolveProvider } : {}),
     });
-    const allMemories = await provider.getAll({ userId });
-    if (allMemories.length === 0) {
-        return { total: 0, duplicatesRemoved: 0 };
+    return dedupProviderMemories(provider, opts);
+}
+export async function dedupProviderMemories(provider, opts) {
+    const { userId, agentId, signal, dryRun = false, approve } = opts;
+    const scope = {
+        userId,
+        ...(agentId ? { agentId } : {}),
+        ...(signal ? { signal } : {}),
+    };
+    if (!provider.getDedupGroups) {
+        throw new Error('The configured Mem0 provider does not support safe deduplication.');
+    }
+    signal?.throwIfAborted();
+    const groups = await provider.getDedupGroups(scope);
+    signal?.throwIfAborted();
+    const memoryIds = new Set();
+    for (const item of groups.flat()) {
+        signal?.throwIfAborted();
+        const { id } = item;
+        if (!id || /\s/.test(id) || memoryIds.has(id)) {
+            throw new Error('Mem0 dedup received an invalid or duplicate memory ID.');
+        }
+        memoryIds.add(id);
+        if (!item.memory.trim()) {
+            throw new Error('Mem0 dedup received empty memory content.');
+        }
+    }
+    const total = groups.reduce((count, group) => count + group.length, 0);
+    const duplicateIds = new Set(groups.flatMap((group) => findDuplicateIds(group, signal)));
+    const preview = {
+        total,
+        duplicatesFound: duplicateIds.size,
+        duplicatesRemoved: 0,
+        deleteFailures: 0,
+    };
+    if (dryRun)
+        return preview;
+    if (approve) {
+        const approved = await approve(preview);
+        signal?.throwIfAborted();
+        if (!approved)
+            return preview;
     }
-    const duplicateIds = findDuplicateIds(allMemories, signal);
     let removed = 0;
+    let failures = 0;
     for (const id of duplicateIds) {
-        if (signal?.aborted)
-            break;
+        signal?.throwIfAborted();
         try {
-            await provider.delete(id);
+            await (signal ? provider.delete(id, { signal }) : provider.delete(id));
+            signal?.throwIfAborted();
             removed++;
         }
         catch {
-            // best-effort
+            signal?.throwIfAborted();
+            failures++;
         }
     }
-    return { total: allMemories.length, duplicatesRemoved: removed };
+    return {
+        total,
+        duplicatesFound: duplicateIds.size,
+        duplicatesRemoved: removed,
+        deleteFailures: failures,
+    };
 }
 /**
  * Shared: find IDs of duplicate entries to remove (keeps the newest).
  */
 function findDuplicateIds(allMemories, signal) {
-    const seen = new Map();
-    const duplicateIds = [];
+    const groups = new Map();
     for (const item of allMemories) {
-        if (signal?.aborted)
-            break;
+        signal?.throwIfAborted();
         const normalized = item.memory.normalize('NFC').replace(/\s+/g, ' ').trim().toLowerCase();
-        const existing = seen.get(normalized);
-        if (existing) {
-            const existingTime = existing.updated_at ? new Date(existing.updated_at).getTime() : 0;
-            const currentTime = item.updated_at ? new Date(item.updated_at).getTime() : 0;
-            if (currentTime > existingTime) {
-                duplicateIds.push(existing.id);
-                seen.set(normalized, item);
+        const group = groups.get(normalized);
+        if (group)
+            group.push(item);
+        else
+            groups.set(normalized, [item]);
+    }
+    const duplicateIds = [];
+    for (const group of groups.values()) {
+        if (group.length < 2)
+            continue;
+        const [first, ...rest] = group;
+        if (!first)
+            continue;
+        let newest = first;
+        let newestTime = memoryTime(first);
+        const times = new Set([newestTime]);
+        for (const item of rest) {
+            signal?.throwIfAborted();
+            const time = memoryTime(item);
+            if (times.has(time)) {
+                throw new Error('Mem0 dedup cannot determine the newest duplicate.');
             }
-            else {
-                duplicateIds.push(item.id);
+            times.add(time);
+            if (time > newestTime) {
+                newest = item;
+                newestTime = time;
             }
         }
-        else {
-            seen.set(normalized, item);
-        }
+        duplicateIds.push(...group.filter((item) => item !== newest).map((item) => item.id));
     }
     return duplicateIds;
 }
+function memoryTime(item) {
+    const timestamp = item.updated_at ?? item.created_at;
+    const time = timestamp ? new Date(timestamp).getTime() : Number.NaN;
+    if (!Number.isFinite(time)) {
+        throw new Error('Mem0 dedup cannot determine the newest duplicate.');
+    }
+    return time;
+}
 //# sourceMappingURL=dedup.js.map

package/dist/dedup.js.map

@@ -1 +1 @@
-{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../src/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,kBAAkB,EAAyB,MAAM,eAAe,CAAC;AAe1E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAkB;IACpD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAEzD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;QACxC,MAAM;QACN,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAEtD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,YAAY,GAAG,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAE3D,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,EAAE,IAAI,YAAY,EAAE,CAAC;QAC9B,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM;QAC3B,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1B,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC;AACnE,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,WAAyB,EAAE,MAAoB;IACvE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC3C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,MAAM,EAAE,OAAO;YAAE,MAAM;QAE3B,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1F,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEtC,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACvF,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,IAAI,WAAW,GAAG,YAAY,EAAE,CAAC;gBAC/B,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBAC/B,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../src/dedup.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,9 +1,23 @@
 /**
- * pi-memory-mem0 — Explicit semantic memory extension powered by Mem0.
+ * pi-memory-mem0 — Semantic memory extension powered by Mem0.
  *
- * Two modes:
+ * Backend modes:
  * - **platform**: Uses Mem0 Cloud API (needs MEM0_API_KEY)
- * - **open-source**: Runs locally with SQLite vector store (needs OPENAI_API_KEY or Ollama)
+ * - **embedded**: Runs Mem0 OSS in-process
+ * - **self-hosted**: Calls a remote Mem0 OSS REST server
+ *
+ * Memory modes (config "memoryMode"):
+ * - **passive**: automatic capture + recall injection only
+ * - **active**: LLM-callable mem0_memory tool only
+ * - **hybrid** (default): both
+ *
+ * Passive side: after each conversation turn, user + assistant messages are
+ * sent to Mem0 for fact extraction and storage (credentials are redacted
+ * first). Recalled memories are injected as a custom message (delivered to
+ * the model on the user channel, never the system prompt) and wrapped as
+ * untrusted data. Active side: the mem0_memory tool lets the agent search,
+ * add, list, and delete memories on its own initiative, under the same
+ * redaction and untrusted-data boundaries.
  *
  * Configuration via settings.json key "pi-memory-mem0".
  * Supports ${ENV_VAR:-fallback} in user and agent settings.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AA2BpE,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA6G5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAmCpE,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAgU5D"}