@amaster.ai/pi-memory-mem0 0.1.9 → 0.1.11

package/README.md

@@ -29,21 +29,67 @@ Safety boundaries:
 
 ### 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 |
+Memory behavior has three independent controls. Each control is optional and falls back to the selected `memoryMode` preset when omitted.
+
+#### Independent Behavior Controls
+
+| Setting | Controls |
+|---------|----------|
+| `autoCapture` | Automatically send each user + assistant turn to Mem0 for extraction and storage |
+| `autoRecall` | Automatically search Mem0 and inject matching memories before the agent starts |
+| `toolEnabled` | Register the model-callable `mem0_memory` tool for search, add, list, and delete operations |
+
+`toolEnabled` affects only the model-callable tool. The user-facing `/mem0` command remains available while the provider is active.
+
+`topK` is the shared result limit for automatic recall and `mem0_memory` search. It must be an integer greater than `0`; use `autoRecall: false`, not `topK: 0`, to disable automatic recall.
+
+#### Presets and Overrides
+
+`memoryMode` remains a convenient preset for the three controls:
+
+| `memoryMode` | Auto capture | Auto recall | `mem0_memory` tool | Use Case |
+|--------------|--------------|-------------|--------------------|----------|
+| `hybrid` (default) | ✅ | ✅ | ✅ | Automatic memory plus agent-driven lookup |
+| `active` | ❌ | ❌ | ✅ | No background traffic; the agent decides every read/write |
+| `passive` | ✅ | ✅ | ❌ | Zero tool surface; fully automatic memory |
+
+Explicit controls override the preset independently. Unset controls continue to inherit their preset values, so a partial override does not replace the entire mode.
 
 ```json
 {
   "pi-memory-mem0": {
-    "mode": "embedded",
-    "memoryMode": "hybrid"
+    "memoryMode": "hybrid",
+    "autoRecall": false
+  }
+}
+```
+
+This keeps the `hybrid` defaults for `autoCapture` and `toolEnabled`, while the explicit `autoRecall: false` disables automatic injection. The agent can still search through `mem0_memory` on demand.
+
+The same rule works with any preset. For example, this starts from `passive` and enables only the tool override:
+
+```json
+{
+  "pi-memory-mem0": {
+    "memoryMode": "passive",
+    "toolEnabled": true
   }
 }
 ```
 
+#### Recall Frequency
+
+`recallFrequency` controls how often automatic recall runs when `autoRecall` resolves to `true`:
+
+| Value | Behavior |
+|-------|----------|
+| `"user-input"` (default) | Search once for each user input and inject the matching memories before that agent run |
+| `"session"` | Search only for the first user input in each persistent session |
+
+Session frequency counts the first search attempt even when it returns no matches or times out. The marker is stored in the Pi session, so switching away and resuming the same session does not search again. `/new` and `/fork` create new session IDs and each search once.
+
+When `autoRecall` is `false`, no automatic search is started and `recallFrequency` has no runtime effect. It does not affect manual `mem0_memory` or `/mem0 search` calls.
+
 ## Architecture (Embedded Mode)
 
 ```
@@ -60,10 +106,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
 
@@ -105,6 +148,7 @@ Calls the OSS REST server directly. The server uses `/memories` and `/search`, n
     "baseUrl": "${MEM0_BASE_URL}",
     "apiKey": "${MEM0_API_KEY}",
     "userId": "${PAPERCLIP_COMPANY_ID}",
+    "agentId": "${PAPERCLIP_AGENT_ID}",
     "userIdScope": "exact"
   }
 }
@@ -186,13 +230,18 @@ The configured vector store always owns persistence. To request an intentionally
 | Field | Type | Default | Description |
 |-------|------|---------|-------------|
 | `mode` | `"platform"` \| `"embedded"` \| `"self-hosted"` | `"platform"` | Operating mode |
-| `memoryMode` | `"hybrid"` \| `"active"` \| `"passive"` | `"hybrid"` | Memory behavior: tool + automation, tool only, or automation only |
+| `memoryMode` | `"hybrid"` \| `"active"` \| `"passive"` | `"hybrid"` | Preset for capture, recall, and tool behavior |
+| `autoCapture` | boolean | selected preset | Override automatic conversation capture |
+| `autoRecall` | boolean | selected preset | Override automatic recall injection |
+| `toolEnabled` | boolean | selected preset | Override `mem0_memory` tool registration |
+| `recallFrequency` | `"user-input"` \| `"session"` | `"user-input"` | Recall on each user input or only the first user input per persistent session; ignored when `autoRecall` is false |
 | `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 |
+| `topK` | integer greater than `0` | `5` | Max results for automatic recall and `mem0_memory` search; use `autoRecall: false` to disable automatic recall |
 | `useRegistryKeys` | boolean | `true` | Whether OSS mode resolves keys from pi registry |
 | `oss.llm` | object | OpenAI gpt-4.1-nano | OSS extraction model |
 | `oss.embedder` | object | OpenAI text-embedding-3-small | OSS embedding model |
@@ -201,6 +250,8 @@ 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 |
@@ -246,7 +297,7 @@ If `better-sqlite3` fails to load (for example, because of a Node ABI mismatch),
 
 ## Tools
 
-When `memoryMode` is `hybrid` or `active`, the agent gets one action-dispatched tool:
+When the resolved `toolEnabled` value is true, the agent gets one action-dispatched tool:
 
 ```
 mem0_memory(action="search", query="...")        # Semantic search over memories
@@ -255,9 +306,7 @@ 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`.
+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
 
@@ -266,6 +315,8 @@ needed for `delete`.
 /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
 ```
 
@@ -276,22 +327,22 @@ needed for `delete`.
 - `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, 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.
+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

@@ -7,17 +7,23 @@
  * 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

@@ -9,56 +9,121 @@
  */
 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, ...(signal ? { signal } : {}) });
-    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 (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":"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"}
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../src/dedup.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,6 +11,10 @@
  * - **active**: LLM-callable mem0_memory tool only
  * - **hybrid** (default): both
  *
+ * autoCapture, autoRecall, and toolEnabled independently override the selected
+ * mode's defaults. recallFrequency controls whether automatic recall runs for
+ * every user input or only the first user input in a session.
+ *
  * 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

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAkCpE,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAoP5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAqCpE,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA0X5D"}