@amaster.ai/pi-memory-mem0 0.1.2-beta.23

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,171 @@
+# @amaster.ai/pi-memory-mem0
+
+Mem0 被动语义记忆扩展 — 支持 Platform (云端) 和 Open-Source (本地 SQLite) 双模式。
+
+## 工作原理
+
+每轮对话结束后，自动将 user + assistant 消息对发送给 Mem0 进行事实提取和向量化存储。下一轮开始前，自动用语义搜索召回相关记忆并注入 system prompt。
+
+**你不需要做任何事** — 记忆的存储和召回完全自动。
+
+## 两种模式
+
+| 模式 | 存储位置 | 依赖 | 适用场景 |
+|------|---------|------|---------|
+| `platform` | Mem0 Cloud | MEM0_API_KEY | 快速上手，多设备同步 |
+| `open-source` | 本地 SQLite (`~/.mem0/vector_store.db`) | LLM + Embedding API | 数据私有，零外部服务 |
+
+## 快速开始
+
+### Platform 模式
+
+```json
+{
+  "pi-memory-mem0": {
+    "mode": "platform",
+    "apiKey": "${MEM0_API_KEY}",
+    "userId": "${USER}"
+  }
+}
+```
+
+### Open-Source 模式 (推荐)
+
+默认复用 pi 已配置的 model provider API key，**不需要额外设置环境变量**。
+
+```json
+{
+  "pi-memory-mem0": {
+    "mode": "open-source",
+    "userId": "${USER}"
+  }
+}
+```
+
+默认使用 OpenAI `text-embedding-3-small` (embedding) + `gpt-4.1-nano` (提取)。API key 自动从 pi model registry 获取。
+
+### 自定义 LLM / Embedding
+
+```json
+{
+  "pi-memory-mem0": {
+    "mode": "open-source",
+    "userId": "${USER}",
+    "oss": {
+      "llm": {
+        "provider": "deepseek",
+        "config": { "model": "deepseek-chat" }
+      },
+      "embedder": {
+        "provider": "openai",
+        "config": { "model": "text-embedding-3-small" }
+      }
+    }
+  }
+}
+```
+
+### 纯本地 (Ollama)
+
+```json
+{
+  "pi-memory-mem0": {
+    "mode": "open-source",
+    "userId": "${USER}",
+    "oss": {
+      "llm": {
+        "provider": "ollama",
+        "config": { "model": "llama3", "url": "http://localhost:11434" }
+      },
+      "embedder": {
+        "provider": "ollama",
+        "config": { "model": "nomic-embed-text", "url": "http://localhost:11434" }
+      }
+    },
+    "useRegistryKeys": false
+  }
+}
+```
+
+## 配置参考
+
+| 字段 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `mode` | `"platform"` \| `"open-source"` | `"platform"` | 运行模式 |
+| `apiKey` | string | — | Platform 模式必须。支持 `${MEM0_API_KEY}` |
+| `baseUrl` | string | `https://api.mem0.ai` | Platform 自定义端点 |
+| `userId` | string | `$USER` 或 `"default-user"` | 记忆作用域 |
+| `topK` | number | `5` | 每轮最多召回条数 |
+| `useRegistryKeys` | boolean | `true` | OSS 模式是否从 pi registry 取 API key |
+| `oss.llm` | object | OpenAI gpt-4.1-nano | OSS 提取模型 |
+| `oss.embedder` | object | OpenAI text-embedding-3-small | OSS embedding 模型 |
+| `oss.vectorStore` | object | SQLite (默认) | 自定义向量存储 |
+| `oss.disableHistory` | boolean | `false` | 禁用操作历史记录 |
+
+## 数据存储位置
+
+| 模式 | 位置 |
+|------|------|
+| Platform | Mem0 Cloud (api.mem0.ai) |
+| Open-Source | `~/.pi/agent/memories/mem0.db` (SQLite，和 pi-memory 的 MEMORY.md/USER.md 同目录) |
+
+可通过 `oss.vectorStore.config.dbPath` 自定义路径。`PI_AGENT_HOME` 环境变量会改变默认目录。
+
+## API Key 解析顺序 (OSS 模式)
+
+LLM 和 Embedder 的 API key **各自独立解析**，按以下顺序：
+
+1. settings.json 的 `oss.llm.config.apiKey` / `oss.embedder.config.apiKey` (显式配置)
+2. pi model registry 的对应 provider key (`useRegistryKeys: true` 时)
+3. 环境变量 (`OPENAI_API_KEY`, `DEEPSEEK_API_KEY` 等，mem0 SDK 内部读取)
+
+例如配置 `"llm": { "provider": "deepseek" }` + `"embedder": { "provider": "openai" }`，会分别从 pi registry 拿 deepseek 的 key 给 LLM，拿 openai 的 key 给 embedder。
+
+### 通过代理 API 调用 (如 amaster)
+
+如果你的 embedding/LLM 走统一代理（如 amaster credits），可以配 `baseUrl` 转发：
+
+```json
+{
+  "pi-memory-mem0": {
+    "mode": "open-source",
+    "oss": {
+      "llm": {
+        "provider": "openai",
+        "config": { "model": "deepseek-v4", "baseUrl": "https://credits.amaster.ai/v1" }
+      },
+      "embedder": {
+        "provider": "openai",
+        "config": { "model": "text-embedding-3-small", "baseUrl": "https://credits.amaster.ai/v1" }
+      }
+    }
+  }
+}
+```
+
+这样 key 从 pi registry 的 `openai` provider 解析，但实际请求发到 amaster 的端点。
+
+## 提供的工具
+
+| 工具 | 说明 |
+|------|------|
+| `mem0_search` | 语义搜索长期记忆 |
+| `mem0_profile` | 列出用户所有记忆 |
+| `mem0_save` | 手动存储一条事实（不经过 LLM 提取） |
+
+## 命令
+
+```
+/mem0 status          # 查看状态
+/mem0 search <query>  # 语义搜索
+/mem0 profile         # 列出所有记忆
+```
+
+## 与 pi-memory 的关系
+
+`pi-memory-mem0` 和 `pi-memory` 是**独立并行运行**的两个扩展：
+
+- `pi-memory`：主动记忆，agent 通过工具显式管理，本地 `.md` 文件，有 char limit
+- `pi-memory-mem0`：被动记忆，自动提取存储，语义检索，无容量限制
+
+两者互不干扰，各自注入 system prompt。

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * pi-memory-mem0 — Passive semantic memory extension powered by Mem0.
+ *
+ * Two modes:
+ * - **platform**: Uses Mem0 Cloud API (needs MEM0_API_KEY)
+ * - **open-source**: Runs locally with SQLite vector store (needs OPENAI_API_KEY or Ollama)
+ *
+ * Configuration via settings.json key "pi-memory-mem0".
+ * Supports ${ENV_VAR:-fallback} in all string values.
+ */
+import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export default function mem0Extension(pi: ExtensionAPI): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AA4BpE,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAkI5D"}

package/dist/index.js

@@ -0,0 +1,165 @@
+/**
+ * pi-memory-mem0 — Passive semantic memory extension powered by Mem0.
+ *
+ * Two modes:
+ * - **platform**: Uses Mem0 Cloud API (needs MEM0_API_KEY)
+ * - **open-source**: Runs locally with SQLite vector store (needs OPENAI_API_KEY or Ollama)
+ *
+ * Configuration via settings.json key "pi-memory-mem0".
+ * Supports ${ENV_VAR:-fallback} in all string values.
+ */
+import { loadPiSettings, resolveAgentDir } from '@amaster.ai/pi-shared/settings';
+import { Prefetch } from './prefetch.js';
+import { createMem0Provider } from './provider.js';
+import { TurnSync } from './sync.js';
+import { createMem0Tools } from './tools.js';
+const SETTINGS_KEY = 'pi-memory-mem0';
+const STATUS_KEY = 'mem0';
+function loadConfig(cwd) {
+    try {
+        return loadPiSettings(SETTINGS_KEY, {
+            cwd,
+            agentDir: resolveAgentDir(),
+        });
+    }
+    catch {
+        return {};
+    }
+}
+function resolveUserId(configUserId) {
+    if (configUserId?.trim())
+        return configUserId.trim();
+    if (process.env.USER)
+        return process.env.USER;
+    if (process.env.USERNAME)
+        return process.env.USERNAME;
+    return 'default-user';
+}
+export default function mem0Extension(pi) {
+    let provider;
+    let sync;
+    let prefetch;
+    pi.on('session_start', async (_event, ctx) => {
+        const config = loadConfig(ctx.cwd);
+        const mode = config.mode ?? 'platform';
+        // Platform mode requires apiKey; OSS mode requires an LLM provider (env key)
+        if (mode === 'platform' && !config.apiKey?.trim()) {
+            ctx.ui.setStatus(STATUS_KEY, 'mem0: disabled (no API key)');
+            return;
+        }
+        try {
+            provider = await createMem0Provider({
+                config,
+                resolveKey: async (providerName) => {
+                    const registry = ctx.modelRegistry;
+                    if (registry.getApiKeyForProvider) {
+                        return registry.getApiKeyForProvider(providerName);
+                    }
+                    return undefined;
+                },
+            });
+        }
+        catch (err) {
+            ctx.ui.setStatus(STATUS_KEY, 'mem0: init failed');
+            ctx.ui.notify(`Mem0 init failed: ${err instanceof Error ? err.message : String(err)}`, 'error');
+            return;
+        }
+        const userId = resolveUserId(config.userId);
+        sync = new TurnSync(provider, userId);
+        prefetch = new Prefetch(provider, userId, {
+            topK: config.topK ?? 5,
+        });
+        ctx.ui.setStatus(STATUS_KEY, `mem0: ${mode}`);
+        for (const tool of createMem0Tools(provider, userId)) {
+            pi.registerTool(tool);
+        }
+    });
+    pi.on('turn_end', async (event) => {
+        if (!sync || !prefetch)
+            return;
+        const msg = event.message;
+        const text = extractText(msg);
+        if (!text)
+            return;
+        if (msg.role === 'user') {
+            prefetch.queue(text);
+        }
+        // Buffer messages for paired sync
+        sync.onMessage(msg.role ?? '', text);
+    });
+    pi.on('before_agent_start', async (event) => {
+        if (!prefetch)
+            return;
+        const recalled = await prefetch.consume();
+        if (!recalled)
+            return;
+        return {
+            systemPrompt: event.systemPrompt ? `${event.systemPrompt}\n\n${recalled}` : recalled,
+        };
+    });
+    pi.on('session_shutdown', async () => {
+        provider = undefined;
+        sync = undefined;
+        prefetch = undefined;
+    });
+    pi.registerCommand('mem0', {
+        description: 'Mem0 memory commands. Subcommands: status, search <query>, profile.',
+        handler: async (args, ctx) => {
+            if (!provider) {
+                ctx.ui.notify('Mem0 is not active.', 'warning');
+                return;
+            }
+            const config = loadConfig(ctx.cwd);
+            const userId = resolveUserId(config.userId);
+            const parts = args.trim().split(/\s+/).filter(Boolean);
+            const subcommand = parts[0]?.toLowerCase() ?? 'status';
+            const rest = parts.slice(1).join(' ').trim();
+            switch (subcommand) {
+                case 'status': {
+                    ctx.ui.notify(`Mem0: active (mode: ${config.mode ?? 'platform'})`, 'info');
+                    break;
+                }
+                case 'search': {
+                    if (!rest) {
+                        ctx.ui.notify('Usage: /mem0 search <query>', 'warning');
+                        break;
+                    }
+                    const results = await provider.search(rest, { userId, topK: 10 });
+                    if (results.length === 0) {
+                        ctx.ui.notify('No relevant memories found.', 'info');
+                    }
+                    else {
+                        const lines = results.map((r, i) => `${i + 1}. ${r.memory}`);
+                        ctx.ui.notify(`Mem0 search results:\n${lines.join('\n')}`, 'info');
+                    }
+                    break;
+                }
+                case 'profile': {
+                    const all = await provider.getAll({ userId });
+                    if (all.length === 0) {
+                        ctx.ui.notify('No memories stored yet.', 'info');
+                    }
+                    else {
+                        const lines = all.map((m, i) => `${i + 1}. ${m.memory}`);
+                        ctx.ui.notify(`Mem0 memories (${all.length}):\n${lines.join('\n')}`, 'info');
+                    }
+                    break;
+                }
+                default:
+                    ctx.ui.notify('Unknown subcommand. Available: status, search, profile.', 'warning');
+            }
+        },
+    });
+}
+function extractText(msg) {
+    if (typeof msg.content === 'string')
+        return msg.content;
+    if (Array.isArray(msg.content)) {
+        return msg.content
+            .filter((c) => c.type === 'text' && c.text)
+            .map((c) => c.text)
+            .join('\n');
+    }
+    return '';
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/prefetch.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Two-phase semantic prefetch — kicks off a background search on turn_end,
+ * consumes the result on before_agent_start with a timeout.
+ */
+import type { Mem0Provider } from './provider.js';
+export declare class Prefetch {
+    private readonly provider;
+    private readonly userId;
+    private readonly topK;
+    private pending;
+    constructor(provider: Mem0Provider, userId: string, opts: {
+        topK: number;
+    });
+    /** Phase 1: kick off a background search (called on turn_end with user message). */
+    queue(query: string): void;
+    /** Phase 2: consume the result with a timeout (called on before_agent_start). */
+    consume(timeoutMs?: number): Promise<string>;
+}
+//# sourceMappingURL=prefetch.d.ts.map

package/dist/prefetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.d.ts","sourceRoot":"","sources":["../src/prefetch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAGlD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAsC;gBAEzC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAM1E,oFAAoF;IACpF,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B,iFAAiF;IAC3E,OAAO,CAAC,SAAS,SAAO,GAAG,OAAO,CAAC,MAAM,CAAC;CAqBjD"}

package/dist/prefetch.js

@@ -0,0 +1,42 @@
+/**
+ * Two-phase semantic prefetch — kicks off a background search on turn_end,
+ * consumes the result on before_agent_start with a timeout.
+ */
+export class Prefetch {
+    provider;
+    userId;
+    topK;
+    pending = null;
+    constructor(provider, userId, opts) {
+        this.provider = provider;
+        this.userId = userId;
+        this.topK = opts.topK;
+    }
+    /** Phase 1: kick off a background search (called on turn_end with user message). */
+    queue(query) {
+        if (!query.trim())
+            return;
+        this.pending = this.provider.search(query, { userId: this.userId, topK: this.topK });
+    }
+    /** Phase 2: consume the result with a timeout (called on before_agent_start). */
+    async consume(timeoutMs = 3000) {
+        if (!this.pending)
+            return '';
+        const promise = this.pending;
+        this.pending = null;
+        try {
+            const memories = await Promise.race([
+                promise,
+                new Promise((resolve) => setTimeout(() => resolve([]), timeoutMs)),
+            ]);
+            if (memories.length === 0)
+                return '';
+            const lines = memories.filter((m) => m.memory?.trim()).map((m) => `- ${m.memory.trim()}`);
+            return lines.length > 0 ? `## Recalled Memories (Mem0)\n${lines.join('\n')}` : '';
+        }
+        catch {
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=prefetch.js.map

package/dist/prefetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch.js","sourceRoot":"","sources":["../src/prefetch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,OAAO,QAAQ;IACF,QAAQ,CAAe;IACvB,MAAM,CAAS;IACf,IAAI,CAAS;IACtB,OAAO,GAAiC,IAAI,CAAC;IAErD,YAAY,QAAsB,EAAE,MAAc,EAAE,IAAsB;QACxE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACxB,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,OAAO;QAC1B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,iFAAiF;IACjF,KAAK,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI;QAC5B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;gBAClC,OAAO;gBACP,IAAI,OAAO,CAAe,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;aACjF,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAErC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAE1F,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gCAAgC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/provider.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Mem0 provider abstraction — supports both Platform (cloud) and OSS (local SQLite) modes.
+ *
+ * Uses the `mem0ai` npm SDK which handles:
+ * - Platform mode: REST API calls to api.mem0.ai
+ * - OSS mode: local SQLite vector store + LLM extraction via configured provider
+ */
+import type { AddResult, Mem0ExtensionConfig, MemoryItem } from './types.js';
+export interface Mem0Provider {
+    add(messages: Array<{
+        role: string;
+        content: string;
+    }>, opts: {
+        userId: string;
+        infer?: boolean;
+    }): Promise<AddResult | null>;
+    search(query: string, opts: {
+        userId: string;
+        topK?: number;
+    }): Promise<MemoryItem[]>;
+    getAll(opts: {
+        userId: string;
+    }): Promise<MemoryItem[]>;
+}
+/** Optional key resolver — pulls API keys from pi's model registry. */
+export type KeyResolver = (provider: string) => Promise<string | undefined>;
+export interface CreateProviderOptions {
+    config: Mem0ExtensionConfig;
+    /** Resolve API key from pi model registry by provider name. */
+    resolveKey?: KeyResolver;
+}
+export declare function createMem0Provider(opts: CreateProviderOptions): Promise<Mem0Provider>;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7E,MAAM,WAAW,YAAY;IAC3B,GAAG,CACD,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAClD,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACxC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAEtF,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CACzD;AA8FD,uEAAuE;AACvE,MAAM,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AA8G5E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,YAAY,CAAC,CAe3F"}

package/dist/provider.js

@@ -0,0 +1,195 @@
+/**
+ * Mem0 provider abstraction — supports both Platform (cloud) and OSS (local SQLite) modes.
+ *
+ * Uses the `mem0ai` npm SDK which handles:
+ * - Platform mode: REST API calls to api.mem0.ai
+ * - OSS mode: local SQLite vector store + LLM extraction via configured provider
+ */
+import { join } from 'node:path';
+import { resolveAgentDir } from '@amaster.ai/pi-shared/settings';
+// ---------------------------------------------------------------------------
+// Normalizers
+// ---------------------------------------------------------------------------
+function normalizeMemoryItem(raw) {
+    return {
+        id: String(raw.id ?? raw.memory_id ?? ''),
+        memory: String(raw.memory ?? raw.text ?? raw.content ?? ''),
+        score: typeof raw.score === 'number' ? raw.score : undefined,
+        user_id: raw.user_id,
+        created_at: (raw.created_at ?? raw.createdAt),
+        updated_at: (raw.updated_at ?? raw.updatedAt),
+    };
+}
+function normalizeResults(raw) {
+    if (Array.isArray(raw))
+        return raw.map((item) => normalizeMemoryItem(item));
+    if (raw &&
+        typeof raw === 'object' &&
+        'results' in raw &&
+        Array.isArray(raw.results)) {
+        return raw.results.map((item) => normalizeMemoryItem(item));
+    }
+    return [];
+}
+// ---------------------------------------------------------------------------
+// Platform Provider
+// ---------------------------------------------------------------------------
+class PlatformProvider {
+    apiKey;
+    baseUrl;
+    client;
+    initPromise = null;
+    constructor(apiKey, baseUrl) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+    }
+    async ensureClient() {
+        if (this.client)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this._init();
+        return this.initPromise;
+    }
+    async _init() {
+        const { MemoryClient } = await import('mem0ai');
+        const opts = { apiKey: this.apiKey };
+        if (this.baseUrl)
+            opts.host = this.baseUrl;
+        this.client = new MemoryClient(opts);
+    }
+    async add(messages, opts) {
+        await this.ensureClient();
+        const addOpts = { userId: opts.userId };
+        if (opts.infer === false)
+            addOpts.infer = false;
+        const result = await this.client.add(messages, addOpts);
+        return result;
+    }
+    async search(query, opts) {
+        await this.ensureClient();
+        const searchOpts = {
+            filters: { user_id: opts.userId },
+        };
+        if (opts.topK)
+            searchOpts.topK = opts.topK;
+        const results = await this.client.search(query, searchOpts);
+        return normalizeResults(results);
+    }
+    async getAll(opts) {
+        await this.ensureClient();
+        const results = await this.client.getAll({
+            filters: { user_id: opts.userId },
+        });
+        return normalizeResults(results);
+    }
+}
+class OSSProvider {
+    ossConfig;
+    resolveKey;
+    memory;
+    initPromise = null;
+    constructor(ossConfig, resolveKey) {
+        this.ossConfig = ossConfig;
+        this.resolveKey = resolveKey;
+    }
+    async ensureMemory() {
+        if (this.memory)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this._init();
+        return this.initPromise;
+    }
+    async _buildConfig() {
+        const config = {};
+        const defaultEmbedder = { provider: 'openai', config: { model: 'text-embedding-3-small' } };
+        const defaultLlm = { provider: 'openai', config: { model: 'gpt-4.1-nano' } };
+        const embedderProvider = this.ossConfig?.embedder?.provider || defaultEmbedder.provider;
+        const embedderCfg = {
+            ...defaultEmbedder.config,
+            ...(this.ossConfig?.embedder?.config ?? {}),
+        };
+        const llmProvider = this.ossConfig?.llm?.provider || defaultLlm.provider;
+        const llmCfg = {
+            ...defaultLlm.config,
+            ...(this.ossConfig?.llm?.config ?? {}),
+        };
+        // Resolve API keys from pi model registry if not explicitly set
+        if (this.resolveKey) {
+            if (!embedderCfg.apiKey && !embedderCfg.api_key) {
+                const key = await this.resolveKey(embedderProvider);
+                if (key)
+                    embedderCfg.apiKey = key;
+            }
+            if (!llmCfg.apiKey && !llmCfg.api_key) {
+                const key = await this.resolveKey(llmProvider);
+                if (key)
+                    llmCfg.apiKey = key;
+            }
+        }
+        config.embedder = { provider: embedderProvider, config: embedderCfg };
+        config.llm = { provider: llmProvider, config: llmCfg };
+        if (this.ossConfig?.vectorStore) {
+            config.vectorStore = this.ossConfig.vectorStore;
+        }
+        else {
+            // Default: SQLite in <PI_AGENT_HOME>/memories/mem0.db (alongside pi-memory's files)
+            config.vectorStore = {
+                provider: 'sqlite',
+                config: { dbPath: join(resolveAgentDir(), 'memories', 'mem0.db') },
+            };
+        }
+        if (this.ossConfig?.disableHistory) {
+            config.disableHistory = true;
+        }
+        return config;
+    }
+    async _init() {
+        const mod = await import('mem0ai/oss');
+        const Memory = mod.Memory ?? mod.default;
+        const builtConfig = await this._buildConfig();
+        this.memory = new Memory(builtConfig);
+        await this.memory.getAll({ filters: { user_id: '__warmup__' } });
+    }
+    async add(messages, opts) {
+        await this.ensureMemory();
+        const addOpts = { userId: opts.userId };
+        if (opts.infer === false)
+            addOpts.infer = false;
+        const result = await this.memory.add(messages, addOpts);
+        return result;
+    }
+    async search(query, opts) {
+        await this.ensureMemory();
+        const searchOpts = {
+            filters: { user_id: opts.userId },
+        };
+        if (opts.topK)
+            searchOpts.topK = opts.topK;
+        const results = await this.memory.search(query, searchOpts);
+        return normalizeResults(results);
+    }
+    async getAll(opts) {
+        await this.ensureMemory();
+        const results = await this.memory.getAll({
+            filters: { user_id: opts.userId },
+        });
+        return normalizeResults(results);
+    }
+}
+export async function createMem0Provider(opts) {
+    const { config, resolveKey } = opts;
+    const mode = config.mode ?? 'platform';
+    if (mode === 'open-source') {
+        const useRegistry = config.useRegistryKeys !== false;
+        const provider = new OSSProvider(config.oss, useRegistry ? resolveKey : undefined);
+        await provider.ensureMemory();
+        return provider;
+    }
+    if (!config.apiKey?.trim()) {
+        throw new Error('Platform mode requires apiKey.');
+    }
+    return new PlatformProvider(config.apiKey.trim(), config.baseUrl?.trim());
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

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

package/dist/sync.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Passive turn sync — sends conversation pairs to Mem0 for server-side extraction.
+ * Buffers user and assistant messages, syncs as pairs.
+ */
+import type { Mem0Provider } from './provider.js';
+export declare class TurnSync {
+    private readonly provider;
+    private readonly userId;
+    private inflight;
+    private lastUserText;
+    constructor(provider: Mem0Provider, userId: string);
+    /** Buffer a message. When we have a user+assistant pair, sync it. */
+    onMessage(role: string, text: string): void;
+    private sync;
+}
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAM;gBAEd,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM;IAKlD,qEAAqE;IACrE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAY3C,OAAO,CAAC,IAAI;CAiBb"}

package/dist/sync.js

@@ -0,0 +1,40 @@
+/**
+ * Passive turn sync — sends conversation pairs to Mem0 for server-side extraction.
+ * Buffers user and assistant messages, syncs as pairs.
+ */
+export class TurnSync {
+    provider;
+    userId;
+    inflight = false;
+    lastUserText = '';
+    constructor(provider, userId) {
+        this.provider = provider;
+        this.userId = userId;
+    }
+    /** Buffer a message. When we have a user+assistant pair, sync it. */
+    onMessage(role, text) {
+        if (role === 'user') {
+            this.lastUserText = text;
+            return;
+        }
+        if (role === 'assistant' && text && this.lastUserText) {
+            this.sync(this.lastUserText, text);
+            this.lastUserText = '';
+        }
+    }
+    sync(userContent, assistantContent) {
+        if (this.inflight)
+            return;
+        this.inflight = true;
+        this.provider
+            .add([
+            { role: 'user', content: userContent },
+            { role: 'assistant', content: assistantContent },
+        ], { userId: this.userId })
+            .catch(() => { })
+            .finally(() => {
+            this.inflight = false;
+        });
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,OAAO,QAAQ;IACF,QAAQ,CAAe;IACvB,MAAM,CAAS;IACxB,QAAQ,GAAG,KAAK,CAAC;IACjB,YAAY,GAAG,EAAE,CAAC;IAE1B,YAAY,QAAsB,EAAE,MAAc;QAChD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,qEAAqE;IACrE,SAAS,CAAC,IAAY,EAAE,IAAY;QAClC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YACnC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAEO,IAAI,CAAC,WAAmB,EAAE,gBAAwB;QACxD,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ;aACV,GAAG,CACF;YACE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE;YACtC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,EAAE;SACjD,EACD,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACxB;aACA,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC;aACf,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC,CAAC,CAAC;IACP,CAAC;CACF"}

package/dist/tools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * LLM-callable tools for Mem0: search, profile (get all), and save (verbatim store).
+ */
+import type { AgentToolResult } from '@earendil-works/pi-coding-agent';
+import type { Mem0Provider } from './provider.js';
+export interface ToolDefinition {
+    name: string;
+    label: string;
+    description: string;
+    promptSnippet?: string;
+    parameters: unknown;
+    execute(toolCallId: string, params: Record<string, unknown>, signal?: AbortSignal, onUpdate?: unknown, ctx?: unknown): Promise<AgentToolResult<unknown>>;
+}
+export declare function createMem0Tools(provider: Mem0Provider, userId: string): ToolDefinition[];
+//# sourceMappingURL=tools.d.ts.map

package/dist/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,OAAO,EAClB,GAAG,CAAC,EAAE,OAAO,GACZ,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;CACtC;AAMD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,CA8FxF"}

package/dist/tools.js

@@ -0,0 +1,90 @@
+/**
+ * LLM-callable tools for Mem0: search, profile (get all), and save (verbatim store).
+ */
+import { Type } from 'typebox';
+function textResult(text) {
+    return { content: [{ type: 'text', text }], details: undefined };
+}
+export function createMem0Tools(provider, userId) {
+    const searchTool = {
+        name: 'mem0_search',
+        label: 'Mem0',
+        description: 'Search long-term memories by meaning. Returns relevant facts ranked by similarity.',
+        promptSnippet: 'Semantic search over long-term user memories.',
+        parameters: Type.Object({
+            query: Type.String({ description: 'What to search for.' }),
+            top_k: Type.Optional(Type.Number({ description: 'Max results (default: 10, max: 50).' })),
+        }),
+        async execute(_toolCallId, params) {
+            const query = String(params.query ?? '');
+            const topK = Math.min(Number(params.top_k) || 10, 50);
+            if (!query)
+                return textResult(JSON.stringify({ error: 'Query cannot be empty.' }));
+            try {
+                const results = await provider.search(query, { userId, topK });
+                if (results.length === 0) {
+                    return textResult(JSON.stringify({ result: 'No relevant memories found.' }));
+                }
+                return textResult(JSON.stringify({
+                    results: results.map((r) => ({ memory: r.memory, score: r.score })),
+                    count: results.length,
+                }));
+            }
+            catch (err) {
+                return textResult(JSON.stringify({
+                    error: `Search failed: ${err instanceof Error ? err.message : String(err)}`,
+                }));
+            }
+        },
+    };
+    const profileTool = {
+        name: 'mem0_profile',
+        label: 'Mem0',
+        description: 'Retrieve all stored long-term memories about the user.',
+        promptSnippet: 'Full dump of all stored user memories.',
+        parameters: Type.Object({}),
+        async execute() {
+            try {
+                const memories = await provider.getAll({ userId });
+                if (memories.length === 0) {
+                    return textResult(JSON.stringify({ result: 'No memories stored yet.' }));
+                }
+                const lines = memories.map((m) => m.memory).filter(Boolean);
+                return textResult(JSON.stringify({ result: lines.join('\n'), count: lines.length }));
+            }
+            catch (err) {
+                return textResult(JSON.stringify({
+                    error: `Profile failed: ${err instanceof Error ? err.message : String(err)}`,
+                }));
+            }
+        },
+    };
+    const saveTool = {
+        name: 'mem0_save',
+        label: 'Mem0',
+        description: 'Store a durable fact about the user verbatim (no LLM extraction). Use for explicit preferences or corrections.',
+        promptSnippet: 'Save a fact to long-term memory verbatim.',
+        parameters: Type.Object({
+            fact: Type.String({ description: 'The fact to store.' }),
+        }),
+        async execute(_toolCallId, params) {
+            const fact = String(params.fact ?? '').trim();
+            if (!fact)
+                return textResult(JSON.stringify({ error: 'Fact cannot be empty.' }));
+            try {
+                const result = await provider.add([{ role: 'user', content: fact }], {
+                    userId,
+                    infer: false,
+                });
+                return textResult(JSON.stringify(result ? { result: 'Fact stored.' } : { error: 'Failed to store.' }));
+            }
+            catch (err) {
+                return textResult(JSON.stringify({
+                    error: `Save failed: ${err instanceof Error ? err.message : String(err)}`,
+                }));
+            }
+        },
+    };
+    return [searchTool, profileTool, saveTool];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Configuration types for pi-memory-mem0.
+ */
+export type Mem0Mode = 'platform' | 'open-source';
+export interface Mem0ExtensionConfig {
+    /** "platform" (Mem0 Cloud) or "open-source" (local SQLite). Default: "platform". */
+    mode?: Mem0Mode;
+    /** Mem0 Platform API key. Supports ${MEM0_API_KEY}. */
+    apiKey?: string;
+    /** Custom API base URL. Default: https://api.mem0.ai */
+    baseUrl?: string;
+    oss?: {
+        embedder?: {
+            provider: string;
+            config?: Record<string, unknown>;
+        };
+        llm?: {
+            provider: string;
+            config?: Record<string, unknown>;
+        };
+        vectorStore?: {
+            provider: string;
+            config?: Record<string, unknown>;
+        };
+        disableHistory?: boolean;
+    };
+    /** User identifier for memory scoping. Supports ${USER}. */
+    userId?: string;
+    /** Max recalled memories per turn. Default: 5 */
+    topK?: number;
+    /**
+     * When true (default), OSS mode will attempt to resolve API keys from
+     * pi's model registry instead of requiring separate env vars.
+     * Falls back to OPENAI_API_KEY / DEEPSEEK_API_KEY env vars if registry lookup fails.
+     */
+    useRegistryKeys?: boolean;
+}
+export interface MemoryItem {
+    id: string;
+    memory: string;
+    score?: number | undefined;
+    user_id?: string | undefined;
+    created_at?: string | undefined;
+    updated_at?: string | undefined;
+}
+export interface AddResult {
+    results?: Array<{
+        id: string;
+        memory: string;
+        event: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,oFAAoF;IACpF,IAAI,CAAC,EAAE,QAAQ,CAAC;IAGhB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,GAAG,CAAC,EAAE;QACJ,QAAQ,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC;QAClE,GAAG,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC;QAC7D,WAAW,CAAC,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC;QACrE,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;IAGF,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Configuration types for pi-memory-mem0.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@amaster.ai/pi-memory-mem0",
+  "version": "0.1.2-beta.23",
+  "description": "Mem0 passive memory extension for pi — dual-mode: Platform (cloud) or Open-Source (local SQLite).",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "extension",
+    "memory",
+    "mem0",
+    "semantic-search",
+    "sqlite"
+  ],
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./provider": {
+      "types": "./dist/provider.d.ts",
+      "default": "./dist/provider.js"
+    },
+    "./package.json": {
+      "default": "./package.json"
+    }
+  },
+  "pi": {
+    "extensions": [
+      "./dist/index.js"
+    ]
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TGYD-helige/pi.git",
+    "directory": "packages/pi-memory-mem0"
+  },
+  "dependencies": {
+    "mem0ai": "^3.0.6",
+    "@amaster.ai/pi-shared": "0.1.2-beta.23"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": ">=0.74.0",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "0.74.0",
+    "typebox": "*",
+    "vitest": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --pretty false",
+    "test": "vitest run src"
+  }
+}