From df70d7833f102c4d2cc550a7858fb0d220feb22e Mon Sep 17 00:00:00 2001 From: Saket Aryan Date: Tue, 15 Sep 2026 00:14:11 +0530 Subject: [PATCH 01/55] fix(plugins): stamp surface identity at record time, not send time MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Six defects in 0.3.x plugin telemetry. Defects 1, 2 and 6 were not three bugs: they were one spool protocol getting three properties wrong. Identity was decided by the wrong process. `harness` was stamped in record(), correctly, but `source` was read from a module global in flush() — so whichever process drained the spool named every event in it. Two processes never call init(): mcp_server.py, and the detached `python3 telemetry.py` sender that spawn_flush() starts. record() now stamps source beside harness, and the build generates core/_harness_id.py per host so identity resolves with no init() call at all. That also unifies two defaults that disagreed (`_plugin` vs `MEM0__PLUGIN`), which could yield three source values for one plugin. Ownership was inferred, not held. Path.replace is os.rename, which preserves mtime, so a claim made after a quiet minute inherited the spool's age and was stealable the instant it existed. Claims are touched on creation and the per-batch rewrite doubles as a lease heartbeat. Progress was not durable. flush() returned on the first failed batch without truncating, so the retry re-posted from index 0 — 150 events delivered 250 times. It now rewrites the claim with the unsent remainder after every batch, bounding a crash to one repeated batch, and each event carries a uuid. Parked batches starved. They were only reachable when no spool existed, and because sessions keep recording there usually was one, so a batch parked by a failed send waited until the 7-day expiry deleted it unsent — despite its own presence being what starts the sender. flush() drains them in the same run, and expiry now applies only after a genuine retry has failed. code.install counted upgrades and repeat sessions. is_first_run() read the identity file, which only a successful flush writes, so an offline user recorded an install every session forever. A dedicated install-state.json is claimed atomically at record time; a non-empty data directory reads as an upgrade. The docs called this anonymous. Every event carries the account email, and the hashes were unsalted SHA-256 over a git remote URL or an absolute path containing the username. READMEs, the module docstring and a new docs section now say what the code does, and repo/session digests are salted per install. A cached email outlived an API key change. It is now re-resolved when the key's fingerprint differs, and $identify aliases anonymous->email only — aliasing one account to another merges person profiles irreversibly. All six shipped green because the shared core's only tests lived under one host, behind a conftest that calls init() at import. Core behaviour was never exercised uninitialised. Adds agent-plugin-core/tests with no init, including subprocess tests and coverage for the portable plugin, which has no flush worker and would pass a native-only test vacuously. Also puts the three surface headers on the SDKs, CLIs and integrations, and corrects a README claiming ZAPIER/STRANDS were already in the platform allowlist. Verified: 59 core tests, 203 claude-code, 11 cursor, 5 codex, 2 kimi, 6 antigravity. ruff and compileall clean. --check clean for all six hosts. TypeScript changes are not typechecked locally (deps not installed). Claude-Session: https://claude.ai/code/session_01C7tEmH86HAr7GoAAKCEHZb --- cli/node/src/backend/platform.ts | 3 +- cli/python/src/mem0_cli/backend/platform.py | 3 +- docs/integrations/claude-code.mdx | 25 ++ integrations/AGENTS.md | 24 ++ integrations/agent-plugin-core/build/build.py | 28 ++ .../agent-plugin-core/python/hook_runner.py | 13 +- .../agent-plugin-core/python/memory_core.py | 38 +- .../agent-plugin-core/python/telemetry.py | 375 ++++++++++++++++-- .../tests/test_spool_delivery.py | 164 ++++++++ .../tests/test_uninitialised_identity.py | 179 +++++++++ .../antigravity-plugin/core/_harness_id.py | 9 + .../antigravity-plugin/core/hook_runner.py | 13 +- .../antigravity-plugin/core/memory_core.py | 38 +- .../antigravity-plugin/core/telemetry.py | 375 ++++++++++++++++-- integrations/claude-code-plugin/README.md | 10 +- .../claude-code-plugin/core/_harness_id.py | 9 + .../claude-code-plugin/core/hook_runner.py | 13 +- .../claude-code-plugin/core/memory_core.py | 38 +- .../claude-code-plugin/core/telemetry.py | 375 ++++++++++++++++-- .../tests/test_telemetry.py | 56 ++- integrations/codex-plugin/core/_harness_id.py | 9 + integrations/codex-plugin/core/hook_runner.py | 13 +- integrations/codex-plugin/core/memory_core.py | 38 +- integrations/codex-plugin/core/telemetry.py | 375 ++++++++++++++++-- .../cursor-plugin/core/_harness_id.py | 9 + .../cursor-plugin/core/hook_runner.py | 13 +- .../cursor-plugin/core/memory_core.py | 38 +- integrations/cursor-plugin/core/telemetry.py | 375 ++++++++++++++++-- integrations/deepseek-plugin/README.md | 4 +- integrations/deepseek-plugin/src/index.ts | 6 +- integrations/kimi-plugin/core/_harness_id.py | 9 + integrations/kimi-plugin/core/hook_runner.py | 13 +- integrations/kimi-plugin/core/memory_core.py | 38 +- integrations/kimi-plugin/core/telemetry.py | 375 ++++++++++++++++-- .../mem0-agent-plugin/core/_harness_id.py | 9 + .../mem0-agent-plugin/core/memory_core.py | 38 +- .../mem0-agent-plugin/core/telemetry.py | 375 ++++++++++++++++-- integrations/mem0-strands/README.md | 8 +- integrations/pi-agent-plugin/src/commands.ts | 9 +- integrations/vercel-ai-sdk/src/mem0-utils.ts | 14 +- mem0-ts/src/client/mem0.ts | 33 ++ mem0/client/main.py | 66 ++- 42 files changed, 3327 insertions(+), 328 deletions(-) create mode 100644 integrations/agent-plugin-core/tests/test_spool_delivery.py create mode 100644 integrations/agent-plugin-core/tests/test_uninitialised_identity.py create mode 100644 integrations/antigravity-plugin/core/_harness_id.py create mode 100644 integrations/claude-code-plugin/core/_harness_id.py create mode 100644 integrations/codex-plugin/core/_harness_id.py create mode 100644 integrations/cursor-plugin/core/_harness_id.py create mode 100644 integrations/kimi-plugin/core/_harness_id.py create mode 100644 integrations/mem0-agent-plugin/core/_harness_id.py diff --git a/cli/node/src/backend/platform.ts b/cli/node/src/backend/platform.ts index 705a3d470..65a4b6228 100644 --- a/cli/node/src/backend/platform.ts +++ b/cli/node/src/backend/platform.ts @@ -31,7 +31,8 @@ export class PlatformBackend implements Backend { this.headers = { Authorization: `Token ${config.apiKey}`, "Content-Type": "application/json", - "X-Mem0-Source": "cli", + "X-Mem0-Source": "CLI", + "X-Mem0-Client": `mem0-cli-node/${CLI_VERSION}`, "X-Mem0-Client-Language": "node", "X-Mem0-Client-Version": CLI_VERSION, }; diff --git a/cli/python/src/mem0_cli/backend/platform.py b/cli/python/src/mem0_cli/backend/platform.py index 1d153da9c..a9ce60df1 100644 --- a/cli/python/src/mem0_cli/backend/platform.py +++ b/cli/python/src/mem0_cli/backend/platform.py @@ -27,7 +27,8 @@ class PlatformBackend(Backend): headers={ "Authorization": f"Token {config.api_key}", "Content-Type": "application/json", - "X-Mem0-Source": "cli", + "X-Mem0-Source": "CLI", + "X-Mem0-Client": f"mem0-cli-python/{__version__}", "X-Mem0-Client-Language": "python", "X-Mem0-Client-Version": __version__, }, diff --git a/docs/integrations/claude-code.mdx b/docs/integrations/claude-code.mdx index 0b8e5a328..c4b5a2c35 100644 --- a/docs/integrations/claude-code.mdx +++ b/docs/integrations/claude-code.mdx @@ -172,6 +172,31 @@ claude plugin update mem0@mem0-plugins --scope user | Sidekick won't start | Must be in a Git repo. Check that your Claude Code version supports plugin agents and worktrees. | | Remove the plugin | `claude plugin uninstall mem0@mem0-plugins` | +## Telemetry + +The plugin sends usage events (which hook ran, timing, result counts, failure +types) so Mem0 can see what's used and what's breaking. + +These events are **not anonymous**. When an API key is configured, which +installing the plugin requires, they are sent under your Mem0 account email, +the same way the Python SDK and the CLI attribute theirs. Without a key they +are sent under a random per-machine id. + +Each event carries the event name, the plugin version, the harness it ran in, +your OS and Python version, timings, counts, and a coarse failure label. +Repository and session identifiers are hashed with a random salt generated on +your machine and never sent, so they cannot be linked back to a repository name +or path. + +Prompts, memory text, queries, file paths, repository names, and API keys are +never sent. + +Turn it off: + +```bash +export MEM0_TELEMETRY=false +``` + Detailed MCP configuration for all clients diff --git a/integrations/AGENTS.md b/integrations/AGENTS.md index c129dd48b..75b60009e 100644 --- a/integrations/AGENTS.md +++ b/integrations/AGENTS.md @@ -49,6 +49,29 @@ Run the type check after every TypeScript change: `pnpm run typecheck` or `tsc - - **`zapier-mem0/`** is a Zapier Platform CLI app: add, search, get, delete. It deploys to Zapier, not npm, so it is **not** in the release router. Deploy it with `gh workflow run zapier-mem0-cd.yml --ref main` (needs the `ZAPIER_DEPLOY_KEY` secret). - **`mem0-strands/`** is a native Strands `MemoryStore` (Python, published to PyPI as `mem0-strands`). It plugs into the Strands `MemoryManager` for automatic recall and server-side extraction, over the hosted Mem0 platform or self-hosted Mem0 OSS. The package lives under `mem0-strands/python/`. +## Surface attribution + +Every integration tells the Mem0 platform which surface it is. Three headers, +and the rules on them are what keep one layer from erasing another: + +| Header | Carries | Rule | +|--------|---------|------| +| `X-Mem0-Source` | one canonical source value | **set-once** — write only if absent | +| `X-Application` | the host app it runs inside | **set-once** — write only if absent | +| `X-Mem0-Client` | `name/version`, outermost first | **append-only** — add yourself, never replace | + +Set-once means `setdefault`, never assignment. An integration that wraps the +SDK is the outermost layer and sets the source; the SDK underneath must defer to +it. Assignment is exactly how every agent plugin came to be indistinguishable +from every other one at the platform. + +Append-only means a plugin calling the Python SDK produces +`mem0-plugin/0.3.1, mem0-python/2.0.19`, so neither layer can erase the other. + +The backend recognizes a fixed list of source values and buckets everything else +into `OTHERS`. A new value has to land in the platform's `EventSource` enum, so +do not invent one without that change going in too. + ## Adding an integration 1. For a native coding-agent host, add `integrations/-plugin/` with `plugin-build.json`, its manifest, and a thin adapter, then generate its shared runtime. Portable clients use the single `mem0-agent-plugin/` package. Independent TypeScript integrations stay self-contained and import shared lifecycle behavior from `agent-plugin-core/typescript/`. @@ -59,3 +82,4 @@ Run the type check after every TypeScript change: `pnpm run typecheck` or `tsc - 5. If it is a Claude Code or editor marketplace plugin, register the generated native bundle path in the applicable marketplace files. Preserve the existing public plugin name. 6. Document it under `docs/integrations/` and add the page to `docs/docs.json` and `docs/llms.txt`. 7. Add rows to the table above and to the CI/CD tables in [`../.github/AGENTS.md`](../.github/AGENTS.md). +8. Send the three headers in [Surface attribution](#surface-attribution), and land the matching `EventSource` value on the platform in the same week. Until it exists, your traffic reports as `OTHERS`. diff --git a/integrations/agent-plugin-core/build/build.py b/integrations/agent-plugin-core/build/build.py index 7a72e5c51..e675efb02 100644 --- a/integrations/agent-plugin-core/build/build.py +++ b/integrations/agent-plugin-core/build/build.py @@ -81,6 +81,28 @@ def replace_output(staged: Path, output: Path) -> Path: return output +def _render_harness_id(host: str) -> str: + """Emit core/_harness_id.py for one host. + + Carries both vocabularies from a single definition: the PostHog `source` tag + and the platform's X-Mem0-Source / X-Application pair. Keeping them together + is what stops the two from drifting into separate vocabularies for the same + thing. + """ + tag = host.upper().replace("-", "_") + "_PLUGIN" + return ( + '"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit."""\n' + "\n" + f'HARNESS_ID = "{host}"\n' + f'SOURCE_TAG = "{tag}"\n' + "\n" + "# Platform-side vocabulary (mem0_event.source + X-Application). The whole\n" + "# plugin family is one source; which editor it runs in is the application.\n" + 'PLATFORM_SOURCE = "MEM0_PLUGIN"\n' + f'PLATFORM_APPLICATION = "{host}"\n' + ) + + def _bundle_python( staged: Path, host: str, @@ -96,6 +118,12 @@ def _bundle_python( continue shutil.copy2(source, core / source.name) + # Generated per host so identity does not depend on an entrypoint remembering + # to call telemetry.init(). mcp_server.py and the detached telemetry.py sender + # never did, which is how MCP searches reported harness=generic and every + # batch they drained was labelled MEM0_PLUGIN regardless of the real host. + (core / "_harness_id.py").write_text(_render_harness_id(host), encoding="utf-8") + values = { "PLUGIN_ROOT": plugin_root, "PLUGIN_DATA": "${PLUGIN_DATA}", diff --git a/integrations/agent-plugin-core/python/hook_runner.py b/integrations/agent-plugin-core/python/hook_runner.py index 2a2adb557..559702102 100644 --- a/integrations/agent-plugin-core/python/hook_runner.py +++ b/integrations/agent-plugin-core/python/hook_runner.py @@ -305,8 +305,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install() + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/agent-plugin-core/python/memory_core.py b/integrations/agent-plugin-core/python/memory_core.py index 77d7a2b80..31a08ec37 100644 --- a/integrations/agent-plugin-core/python/memory_core.py +++ b/integrations/agent-plugin-core/python/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,10 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body, + # query string or X-Mem0-Source header, never from metadata. The + # harness tag stays in metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2555,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/agent-plugin-core/python/telemetry.py b/integrations/agent-plugin-core/python/telemetry.py index 249595475..d7933bfbc 100644 --- a/integrations/agent-plugin-core/python/telemetry.py +++ b/integrations/agent-plugin-core/python/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,8 +34,23 @@ from typing import Any import memory_core -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -56,10 +76,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -70,6 +99,11 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 def is_enabled() -> bool: @@ -83,9 +117,36 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _install_salt() -> str: + """Random per-install salt, created on first use and kept in the identity file.""" + identity = _read_identity() + salt = identity.get("salt") + if not salt: + salt = uuid.uuid4().hex + identity["salt"] = salt + _write_identity(identity) + return salt + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + """ + if not value: + return "" + return hashlib.sha256(f"{_install_salt()}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -145,9 +206,92 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def claim_install() -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + """ + path = _install_state_path() + # A fresh install has an empty data directory. Anything already there — + # a 0.2.x venv, an evidence db, a spool — means this is an upgrade. Read + # before the marker is created, since creating it would itself be content. + upgrading = _data_dir_has_content() + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except (OSError, json.JSONDecodeError): + return None + if not isinstance(state, dict): + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + return None + return previous def record( @@ -168,19 +312,25 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), ) if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + properties["repo_hash"] = _scoped_digest(getattr(repo, "identity", "")) if session_id: - properties["session_hash"] = _digest(session_id) + properties["session_hash"] = _scoped_digest(session_id) line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -239,38 +389,139 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape.""" + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + tail = stem.rsplit("-", 1)[-1] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age > CLAIM_EXPIRY_SECONDS and _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS: try: orphan.unlink() except OSError: pass continue if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + temporary.write_text( + "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining), + encoding="utf-8", + ) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + released = time.time() - CLAIM_STALE_SECONDS - 1 + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -300,34 +551,76 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and identity.get("key_fingerprint", "") == fingerprint and fingerprint: + return email, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + _write_identity(identity) return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: - return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + resolved = _resolve_email(key) + if not resolved: + return (email, "") if email else (anonymous_id(identity), "") + + # Alias only when going anonymous -> email for the first time. + previous = "" if email else identity.get("anonymous_id", "") + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() except OSError: - return 0 + return 0, True events = [] for line in lines: try: @@ -341,7 +634,7 @@ def flush() -> int: claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -360,12 +653,17 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, @@ -373,16 +671,19 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. + _rewrite_claim(claim, events[start + len(chunk) :]) + return sent, True def main() -> int: diff --git a/integrations/agent-plugin-core/tests/test_spool_delivery.py b/integrations/agent-plugin-core/tests/test_spool_delivery.py new file mode 100644 index 000000000..754307454 --- /dev/null +++ b/integrations/agent-plugin-core/tests/test_spool_delivery.py @@ -0,0 +1,164 @@ +"""Delivery semantics of the telemetry spool: no duplicates, no starvation. + +These run against a built host's core in-process (not a subprocess) because they +need to inject failures into ``_post``. The identity tests next door cover the +uninitialised-process case that needs a real interpreter. +""" + +from __future__ import annotations + +import importlib +import json +import os +import sys +import time +from pathlib import Path + +import pytest + +CORE_ROOT = Path(__file__).resolve().parents[1] +REPOSITORY_ROOT = CORE_ROOT.parents[1] +HOST_CORE = REPOSITORY_ROOT / "integrations" / "claude-code-plugin" / "core" + +pytestmark = pytest.mark.skipif(not HOST_CORE.exists(), reason="claude-code-plugin is not built") + + +@pytest.fixture() +def telemetry(tmp_path, monkeypatch): + monkeypatch.setenv("MEM0_CODE_DATA_DIR", str(tmp_path / "data")) + monkeypatch.syspath_prepend(str(HOST_CORE)) + for name in ("telemetry", "memory_core", "_harness_id"): + sys.modules.pop(name, None) + module = importlib.import_module("telemetry") + monkeypatch.setattr(module, "resolve_distinct_id", lambda: ("tester@example.com", "")) + yield module + for name in ("telemetry", "memory_core", "_harness_id"): + sys.modules.pop(name, None) + + +def _delivered(payloads): + return [event for payload in payloads if "batch" in payload for event in payload["batch"]] + + +def test_a_partial_failure_does_not_redeliver_what_already_arrived(telemetry): + """Defect 2a: flush kept the whole claim on failure and retried from the top. + + 150 events across two batches, the second failing, previously delivered 250. + """ + for index in range(150): + telemetry.record("search", index=index) + + sent: list[dict] = [] + calls = {"n": 0} + + def flaky(payload, url): + calls["n"] += 1 + if calls["n"] == 2: # second batch fails + return False + sent.append(payload) + return True + + telemetry._post = flaky + telemetry.flush() + + telemetry._post = lambda payload, url: sent.append(payload) or True + telemetry.flush() + + events = _delivered(sent) + assert len(events) == 150 + assert len({event["uuid"] for event in events}) == 150 + + +def test_a_fresh_claim_is_not_immediately_stealable(telemetry): + """Defect 2b: rename preserves mtime, so a claim inherited the spool's age. + + With the last write older than the stale threshold, a claim made now looked + abandoned the instant it existed and a second sender took it over. + """ + telemetry.record("search") + spool = telemetry._spool_path() + old = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(spool, (old, old)) + + first = telemetry._claim_spool() + assert first is not None + + # A second sender starting right now must find nothing to take. + assert telemetry._claim_parked(first.parent) is None + + +def test_a_parked_batch_is_drained_behind_the_live_spool(telemetry): + """Defect 6: parked claims were only reachable when no spool existed. + + Because sessions keep recording there usually was one, so a batch parked by + a failed send waited until the 7-day expiry deleted it unsent — even though + its own presence is what starts the sender. + """ + telemetry.record("parked") + telemetry._post = lambda payload, url: False + telemetry.flush() + + parked = list(telemetry.memory_core.data_dir().glob("telemetry-*.sending")) + assert len(parked) == 1 + old = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(parked[0], (old, old)) + + telemetry.record("fresh") + sent: list[dict] = [] + telemetry._post = lambda payload, url: sent.append(payload) or True + telemetry.flush() + + names = {event["event"] for event in _delivered(sent)} + assert names == {"code.parked", "code.fresh"} + + +def test_an_untried_batch_is_not_expired_by_age_alone(telemetry): + """Expiry should discard what failed, not what never got a turn.""" + telemetry.record("parked") + telemetry._post = lambda payload, url: False + telemetry.flush() + + parked = list(telemetry.memory_core.data_dir().glob("telemetry-*.sending")) + assert len(parked) == 1 + ancient = time.time() - (telemetry.CLAIM_EXPIRY_SECONDS + 60) + os.utime(parked[0], (ancient, ancient)) + + sent: list[dict] = [] + telemetry._post = lambda payload, url: sent.append(payload) or True + telemetry.flush() + + assert [event["event"] for event in _delivered(sent)] == ["code.parked"] + + +def test_progress_is_recorded_after_every_batch(telemetry): + """A crash repeats at most one batch, not the whole file.""" + for index in range(250): + telemetry.record("search", index=index) + + calls = {"n": 0} + + def die_after_two(payload, url): + calls["n"] += 1 + if calls["n"] > 2: + return False + return True + + telemetry._post = die_after_two + telemetry.flush() + + parked = list(telemetry.memory_core.data_dir().glob("telemetry-*.sending")) + assert len(parked) == 1 + remaining = parked[0].read_text(encoding="utf-8").strip().splitlines() + # Two batches of 100 landed; only the last 50 should still be pending. + assert len(remaining) == 50 + assert json.loads(remaining[0])["properties"]["index"] == 200 + + +def test_the_heartbeat_stays_well_inside_the_lease(telemetry): + """The claim rewrite doubles as the lease heartbeat. + + _post makes a single attempt with SEND_TIMEOUT and no retry, so a heartbeat + lands at least that often. If a retry loop is ever added to _post, this is + the assertion that catches a sender losing its claim mid-flight. + """ + assert telemetry.SEND_TIMEOUT * 4 < telemetry.CLAIM_STALE_SECONDS diff --git a/integrations/agent-plugin-core/tests/test_uninitialised_identity.py b/integrations/agent-plugin-core/tests/test_uninitialised_identity.py new file mode 100644 index 000000000..14f911bee --- /dev/null +++ b/integrations/agent-plugin-core/tests/test_uninitialised_identity.py @@ -0,0 +1,179 @@ +"""Core telemetry behaviour with NO telemetry.init(), in a real subprocess. + +Why this file exists +-------------------- +``telemetry.py`` lives in ``agent-plugin-core/python/`` but its only tests lived +under ``claude-code-plugin/tests/``, behind a ``conftest.py`` that calls +``configure_harness()`` and ``telemetry.init()`` at import. Core behaviour was +therefore only ever exercised inside an already-configured module. + +Two processes in the real pipeline never call ``init()``: + +- ``mcp_server.py``, which records every manual search; +- the detached ``python3 telemetry.py`` sender that ``spawn_flush()`` starts at + session start, after every skill command, and when the MCP server exits. + +Both fell back to module defaults, so MCP searches reported ``harness=generic`` +and everything that sender delivered was labelled ``MEM0_PLUGIN`` regardless of +which of the six plugins produced it. The suite stayed green throughout. + +These tests run in a fresh interpreter with no conftest, against a built host +bundle, which is the only arrangement that can catch that class of bug. +""" + +from __future__ import annotations + +import json +import subprocess +import sys +import tempfile +from pathlib import Path + +import pytest + +CORE_ROOT = Path(__file__).resolve().parents[1] +REPOSITORY_ROOT = CORE_ROOT.parents[1] +HOSTS = { + "claude-code": ("claude-code-plugin", "CLAUDE_CODE_PLUGIN"), + "cursor": ("cursor-plugin", "CURSOR_PLUGIN"), + "codex": ("codex-plugin", "CODEX_PLUGIN"), + "kimi": ("kimi-plugin", "KIMI_PLUGIN"), + "antigravity": ("antigravity-plugin", "ANTIGRAVITY_PLUGIN"), + # Portable: no flush_worker and no hook_runner, so its ONLY sender is the + # uninitialised telemetry.py. A native-only test passes here vacuously. + "coding-agent": ("mem0-agent-plugin", "CODING_AGENT_PLUGIN"), +} + + +def _core_dir(directory: str) -> Path: + return REPOSITORY_ROOT / "integrations" / directory / "core" + + +def _run(core: Path, data_dir: Path, body: str) -> str: + """Execute `body` in a fresh interpreter with only the host's core on sys.path.""" + script = f"import sys; sys.path.insert(0, {str(core)!r})\n{body}" + result = subprocess.run( + [sys.executable, "-c", script], + capture_output=True, + text=True, + env={ + "MEM0_CODE_DATA_DIR": str(data_dir), + "PATH": "/usr/bin:/bin", + "HOME": str(data_dir), + }, + ) + assert result.returncode == 0, result.stderr + return result.stdout.strip() + + +@pytest.mark.parametrize("harness,spec", sorted(HOSTS.items())) +def test_identity_resolves_without_init(harness, spec): + """Every built host knows what it is with no configuration call at all.""" + directory, source_tag = spec + core = _core_dir(directory) + if not core.exists(): + pytest.skip(f"{directory} is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + out = _run( + core, + Path(tmp), + "import telemetry; print(telemetry._harness, telemetry._source_tag)", + ) + assert out == f"{harness} {source_tag}" + + +def test_mcp_server_records_the_real_harness(): + """mcp_server imports telemetry and never initialises it (server.py has no init). + + Its recorded events used to carry harness=generic for every plugin. + """ + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + data_dir = Path(tmp) + _run( + core, + data_dir, + "import mcp_server, telemetry; telemetry.record('search', trigger='mcp-search')", + ) + spooled = (data_dir / "telemetry.jsonl").read_text(encoding="utf-8").strip() + + event = json.loads(spooled) + assert event["properties"]["harness"] == "claude-code" + assert event["properties"]["source"] == "CLAUDE_CODE_PLUGIN" + + +def test_the_detached_sender_does_not_relabel_events(): + """`python3 telemetry.py` is the sender spawn_flush() starts, and never inits. + + source is stamped at record time now, so which process sends is irrelevant. + """ + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + data_dir = Path(tmp) + _run(core, data_dir, "import telemetry; telemetry.record('search')") + + captured = data_dir / "captured.json" + # Drain with a fresh, unconfigured interpreter, capturing the payload + # instead of posting it. + _run( + core, + data_dir, + "import json, telemetry\n" + "sent = []\n" + "telemetry._post = lambda payload, url: sent.append(payload) or True\n" + "telemetry.flush()\n" + f"open({str(captured)!r}, 'w').write(json.dumps(sent))", + ) + payloads = json.loads(captured.read_text(encoding="utf-8")) + + batches = [p for p in payloads if "batch" in p] + assert batches, "nothing was sent" + properties = batches[0]["batch"][0]["properties"] + assert properties["source"] == "CLAUDE_CODE_PLUGIN" + assert properties["harness"] == "claude-code" + + +def test_every_event_carries_a_uuid_for_dedupe(): + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + data_dir = Path(tmp) + _run(core, data_dir, "import telemetry; telemetry.record('search'); telemetry.record('flush')") + lines = (data_dir / "telemetry.jsonl").read_text(encoding="utf-8").strip().splitlines() + + ids = [json.loads(line)["uuid"] for line in lines] + assert len(ids) == 2 + assert len(set(ids)) == 2 + + +def test_source_tag_defaults_agree_between_the_two_modules(): + """configure_harness and telemetry.init must derive the same tag. + + They disagreed: `_plugin` in one and `MEM0__PLUGIN` in the other, + so one plugin could emit three different source values depending on which + process sent the batch. + """ + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + out = _run( + core, + Path(tmp), + "import memory_core, telemetry\n" + "memory_core.configure_harness('kimi')\n" + "telemetry.init(harness='kimi')\n" + "print(memory_core.harness_config()['source_tag'].upper(), telemetry._source_tag)", + ) + left, right = out.split() + assert left == right == "KIMI_PLUGIN" diff --git a/integrations/antigravity-plugin/core/_harness_id.py b/integrations/antigravity-plugin/core/_harness_id.py new file mode 100644 index 000000000..2c8a515f4 --- /dev/null +++ b/integrations/antigravity-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "antigravity" +SOURCE_TAG = "ANTIGRAVITY_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "antigravity" diff --git a/integrations/antigravity-plugin/core/hook_runner.py b/integrations/antigravity-plugin/core/hook_runner.py index 2a2adb557..559702102 100644 --- a/integrations/antigravity-plugin/core/hook_runner.py +++ b/integrations/antigravity-plugin/core/hook_runner.py @@ -305,8 +305,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install() + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/antigravity-plugin/core/memory_core.py b/integrations/antigravity-plugin/core/memory_core.py index 77d7a2b80..31a08ec37 100644 --- a/integrations/antigravity-plugin/core/memory_core.py +++ b/integrations/antigravity-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,10 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body, + # query string or X-Mem0-Source header, never from metadata. The + # harness tag stays in metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2555,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/antigravity-plugin/core/telemetry.py b/integrations/antigravity-plugin/core/telemetry.py index 249595475..d7933bfbc 100644 --- a/integrations/antigravity-plugin/core/telemetry.py +++ b/integrations/antigravity-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,8 +34,23 @@ from typing import Any import memory_core -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -56,10 +76,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -70,6 +99,11 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 def is_enabled() -> bool: @@ -83,9 +117,36 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _install_salt() -> str: + """Random per-install salt, created on first use and kept in the identity file.""" + identity = _read_identity() + salt = identity.get("salt") + if not salt: + salt = uuid.uuid4().hex + identity["salt"] = salt + _write_identity(identity) + return salt + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + """ + if not value: + return "" + return hashlib.sha256(f"{_install_salt()}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -145,9 +206,92 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def claim_install() -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + """ + path = _install_state_path() + # A fresh install has an empty data directory. Anything already there — + # a 0.2.x venv, an evidence db, a spool — means this is an upgrade. Read + # before the marker is created, since creating it would itself be content. + upgrading = _data_dir_has_content() + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except (OSError, json.JSONDecodeError): + return None + if not isinstance(state, dict): + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + return None + return previous def record( @@ -168,19 +312,25 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), ) if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + properties["repo_hash"] = _scoped_digest(getattr(repo, "identity", "")) if session_id: - properties["session_hash"] = _digest(session_id) + properties["session_hash"] = _scoped_digest(session_id) line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -239,38 +389,139 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape.""" + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + tail = stem.rsplit("-", 1)[-1] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age > CLAIM_EXPIRY_SECONDS and _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS: try: orphan.unlink() except OSError: pass continue if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + temporary.write_text( + "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining), + encoding="utf-8", + ) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + released = time.time() - CLAIM_STALE_SECONDS - 1 + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -300,34 +551,76 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and identity.get("key_fingerprint", "") == fingerprint and fingerprint: + return email, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + _write_identity(identity) return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: - return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + resolved = _resolve_email(key) + if not resolved: + return (email, "") if email else (anonymous_id(identity), "") + + # Alias only when going anonymous -> email for the first time. + previous = "" if email else identity.get("anonymous_id", "") + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() except OSError: - return 0 + return 0, True events = [] for line in lines: try: @@ -341,7 +634,7 @@ def flush() -> int: claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -360,12 +653,17 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, @@ -373,16 +671,19 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. + _rewrite_claim(claim, events[start + len(chunk) :]) + return sent, True def main() -> int: diff --git a/integrations/claude-code-plugin/README.md b/integrations/claude-code-plugin/README.md index 130460b17..872071abe 100644 --- a/integrations/claude-code-plugin/README.md +++ b/integrations/claude-code-plugin/README.md @@ -136,13 +136,19 @@ Local data lives in `${CLAUDE_PLUGIN_DATA}`: - `pending/`: sessions waiting to be sent to Mem0 (retried after interruption) - `flush-worker.log`: whether memory creation succeeded - `plugin-errors.log`: hook errors (no credentials) -- `telemetry.jsonl` / `telemetry-identity.json`: anonymous usage events +- `telemetry.jsonl` / `telemetry-identity.json`: usage events and the id they are sent under Mem0 receives captured user messages, Claude's answers, sidekick assignments and completed responses, and changed file paths. When a failed command is recorded, extraction can also include bounded command details and results. Complete files and general tool output stay on your machine. Values that look like credentials are redacted before anything is sent. ## Telemetry -Anonymous usage events (which hook ran, timing, result counts, failure types) so Mem0 can identify what's used and what's breaking. Repo and session IDs are hashed before leaving your machine. Prompts, memory text, file paths, tool output, and API keys are never sent. +Usage events (which hook ran, timing, result counts, failure types) so Mem0 can identify what's used and what's breaking. + +**These events are not anonymous.** When an API key is configured — which installing the plugin requires — events are sent under your Mem0 account email, the same way the Python SDK and the CLI attribute theirs. Without a key they are sent under a random per-machine id. + +What each event carries: the event name, the plugin version, the harness it ran in, your OS and Python version, timings, counts, and a coarse failure label. Repository and session identifiers are hashed with a random salt generated on your machine and never sent, so they cannot be linked back to a repository name or path. + +Prompts, memory text, queries, file paths, repository names, and API keys are never sent. Turn it off: diff --git a/integrations/claude-code-plugin/core/_harness_id.py b/integrations/claude-code-plugin/core/_harness_id.py new file mode 100644 index 000000000..6c3e1ce15 --- /dev/null +++ b/integrations/claude-code-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "claude-code" +SOURCE_TAG = "CLAUDE_CODE_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "claude-code" diff --git a/integrations/claude-code-plugin/core/hook_runner.py b/integrations/claude-code-plugin/core/hook_runner.py index 2a2adb557..559702102 100644 --- a/integrations/claude-code-plugin/core/hook_runner.py +++ b/integrations/claude-code-plugin/core/hook_runner.py @@ -305,8 +305,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install() + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/claude-code-plugin/core/memory_core.py b/integrations/claude-code-plugin/core/memory_core.py index 77d7a2b80..31a08ec37 100644 --- a/integrations/claude-code-plugin/core/memory_core.py +++ b/integrations/claude-code-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,10 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body, + # query string or X-Mem0-Source header, never from metadata. The + # harness tag stays in metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2555,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/claude-code-plugin/core/telemetry.py b/integrations/claude-code-plugin/core/telemetry.py index 249595475..d7933bfbc 100644 --- a/integrations/claude-code-plugin/core/telemetry.py +++ b/integrations/claude-code-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,8 +34,23 @@ from typing import Any import memory_core -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -56,10 +76,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -70,6 +99,11 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 def is_enabled() -> bool: @@ -83,9 +117,36 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _install_salt() -> str: + """Random per-install salt, created on first use and kept in the identity file.""" + identity = _read_identity() + salt = identity.get("salt") + if not salt: + salt = uuid.uuid4().hex + identity["salt"] = salt + _write_identity(identity) + return salt + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + """ + if not value: + return "" + return hashlib.sha256(f"{_install_salt()}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -145,9 +206,92 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def claim_install() -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + """ + path = _install_state_path() + # A fresh install has an empty data directory. Anything already there — + # a 0.2.x venv, an evidence db, a spool — means this is an upgrade. Read + # before the marker is created, since creating it would itself be content. + upgrading = _data_dir_has_content() + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except (OSError, json.JSONDecodeError): + return None + if not isinstance(state, dict): + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + return None + return previous def record( @@ -168,19 +312,25 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), ) if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + properties["repo_hash"] = _scoped_digest(getattr(repo, "identity", "")) if session_id: - properties["session_hash"] = _digest(session_id) + properties["session_hash"] = _scoped_digest(session_id) line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -239,38 +389,139 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape.""" + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + tail = stem.rsplit("-", 1)[-1] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age > CLAIM_EXPIRY_SECONDS and _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS: try: orphan.unlink() except OSError: pass continue if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + temporary.write_text( + "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining), + encoding="utf-8", + ) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + released = time.time() - CLAIM_STALE_SECONDS - 1 + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -300,34 +551,76 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and identity.get("key_fingerprint", "") == fingerprint and fingerprint: + return email, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + _write_identity(identity) return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: - return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + resolved = _resolve_email(key) + if not resolved: + return (email, "") if email else (anonymous_id(identity), "") + + # Alias only when going anonymous -> email for the first time. + previous = "" if email else identity.get("anonymous_id", "") + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() except OSError: - return 0 + return 0, True events = [] for line in lines: try: @@ -341,7 +634,7 @@ def flush() -> int: claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -360,12 +653,17 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, @@ -373,16 +671,19 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. + _rewrite_claim(claim, events[start + len(chunk) :]) + return sent, True def main() -> int: diff --git a/integrations/claude-code-plugin/tests/test_telemetry.py b/integrations/claude-code-plugin/tests/test_telemetry.py index 0ae280b19..4476a9dd3 100644 --- a/integrations/claude-code-plugin/tests/test_telemetry.py +++ b/integrations/claude-code-plugin/tests/test_telemetry.py @@ -1,6 +1,7 @@ from __future__ import annotations import json +import os import sys from pathlib import Path from unittest.mock import patch @@ -198,9 +199,11 @@ def test_a_stale_claim_is_reclaimed(isolated_env, monkeypatch): telemetry.record("search") orphan = telemetry._claim_spool() assert orphan is not None - monkeypatch.setattr( - telemetry.time, "time", lambda: orphan.stat().st_mtime + telemetry.CLAIM_STALE_SECONDS + 1 - ) + # Frozen rather than re-stat'd per call: flush() drains the live spool and + # then looks for parked claims in the same run, so by the second look this + # file no longer exists. + stale_now = orphan.stat().st_mtime + telemetry.CLAIM_STALE_SECONDS + 1 + monkeypatch.setattr(telemetry.time, "time", lambda: stale_now) with patch.object(telemetry, "_post", lambda payload, url: True): assert telemetry.flush() == 1 @@ -210,9 +213,13 @@ def test_an_expired_claim_is_dropped(isolated_env, monkeypatch): telemetry.record("search") orphan = telemetry._claim_spool() assert orphan is not None - monkeypatch.setattr( - telemetry.time, "time", lambda: orphan.stat().st_mtime + telemetry.CLAIM_EXPIRY_SECONDS + 1 - ) + expired_now = orphan.stat().st_mtime + telemetry.CLAIM_EXPIRY_SECONDS + 1 + monkeypatch.setattr(telemetry.time, "time", lambda: expired_now) + # Expiry now only discards a batch that was genuinely retried and failed, + # so age alone is not enough — age it past the attempt budget too. + retried = orphan.parent / orphan.name.replace("-a0.", f"-a{telemetry.MAX_CLAIM_ATTEMPTS}.") + orphan.replace(retried) + os.utime(retried, (expired_now, expired_now - telemetry.CLAIM_EXPIRY_SECONDS - 1)) assert telemetry._claim_spool() is None assert not list(memory_core.data_dir().glob("telemetry-*.sending")) @@ -258,12 +265,47 @@ def test_an_unresolvable_key_falls_back_to_the_anonymous_id(isolated_env, monkey assert telemetry.resolve_distinct_id()[0].startswith("code-anon-") -def test_is_first_run_flips_after_the_first_identity_write(isolated_env): +def test_first_run_is_not_flipped_by_writing_the_identity_file(isolated_env): + """The identity file is written by a successful flush, not by recording. + + Keying first-run off it meant an offline user recorded code.install on every + session forever, and every 0.2.x user recorded one on their first 0.3.x run. + """ assert telemetry.is_first_run() telemetry.anonymous_id() + assert telemetry.is_first_run() + + +def test_claiming_install_ends_first_run(isolated_env): + assert telemetry.claim_install() == "install" assert not telemetry.is_first_run() +def test_install_can_only_be_claimed_once(isolated_env): + """Two sessions starting together must not both record an install.""" + assert telemetry.claim_install() == "install" + assert telemetry.claim_install() is None + + +def test_a_populated_data_dir_reads_as_an_upgrade(isolated_env): + """A fresh install has an empty data directory; anything else predates it.""" + data_dir = memory_core.data_dir() + data_dir.mkdir(parents=True, exist_ok=True) + (data_dir / "requirements.txt").write_text("mem0ai\n", encoding="utf-8") + assert telemetry.claim_install() == "upgrade" + + +def test_a_version_change_is_claimed_once(isolated_env): + telemetry.claim_install() + state_path = memory_core.data_dir() / "install-state.json" + state = json.loads(state_path.read_text()) + state["plugin_version"] = "0.0.1-old" + state_path.write_text(json.dumps(state), encoding="utf-8") + + assert telemetry.claim_version_change() == "0.0.1-old" + assert telemetry.claim_version_change() is None + + def test_spawn_flush_does_nothing_without_a_spool(isolated_env): with patch.object(telemetry.subprocess, "Popen") as popen: assert telemetry.spawn_flush() is False diff --git a/integrations/codex-plugin/core/_harness_id.py b/integrations/codex-plugin/core/_harness_id.py new file mode 100644 index 000000000..152313a21 --- /dev/null +++ b/integrations/codex-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "codex" +SOURCE_TAG = "CODEX_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "codex" diff --git a/integrations/codex-plugin/core/hook_runner.py b/integrations/codex-plugin/core/hook_runner.py index 2a2adb557..559702102 100644 --- a/integrations/codex-plugin/core/hook_runner.py +++ b/integrations/codex-plugin/core/hook_runner.py @@ -305,8 +305,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install() + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/codex-plugin/core/memory_core.py b/integrations/codex-plugin/core/memory_core.py index 77d7a2b80..31a08ec37 100644 --- a/integrations/codex-plugin/core/memory_core.py +++ b/integrations/codex-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,10 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body, + # query string or X-Mem0-Source header, never from metadata. The + # harness tag stays in metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2555,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/codex-plugin/core/telemetry.py b/integrations/codex-plugin/core/telemetry.py index 249595475..d7933bfbc 100644 --- a/integrations/codex-plugin/core/telemetry.py +++ b/integrations/codex-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,8 +34,23 @@ from typing import Any import memory_core -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -56,10 +76,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -70,6 +99,11 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 def is_enabled() -> bool: @@ -83,9 +117,36 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _install_salt() -> str: + """Random per-install salt, created on first use and kept in the identity file.""" + identity = _read_identity() + salt = identity.get("salt") + if not salt: + salt = uuid.uuid4().hex + identity["salt"] = salt + _write_identity(identity) + return salt + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + """ + if not value: + return "" + return hashlib.sha256(f"{_install_salt()}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -145,9 +206,92 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def claim_install() -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + """ + path = _install_state_path() + # A fresh install has an empty data directory. Anything already there — + # a 0.2.x venv, an evidence db, a spool — means this is an upgrade. Read + # before the marker is created, since creating it would itself be content. + upgrading = _data_dir_has_content() + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except (OSError, json.JSONDecodeError): + return None + if not isinstance(state, dict): + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + return None + return previous def record( @@ -168,19 +312,25 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), ) if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + properties["repo_hash"] = _scoped_digest(getattr(repo, "identity", "")) if session_id: - properties["session_hash"] = _digest(session_id) + properties["session_hash"] = _scoped_digest(session_id) line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -239,38 +389,139 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape.""" + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + tail = stem.rsplit("-", 1)[-1] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age > CLAIM_EXPIRY_SECONDS and _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS: try: orphan.unlink() except OSError: pass continue if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + temporary.write_text( + "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining), + encoding="utf-8", + ) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + released = time.time() - CLAIM_STALE_SECONDS - 1 + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -300,34 +551,76 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and identity.get("key_fingerprint", "") == fingerprint and fingerprint: + return email, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + _write_identity(identity) return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: - return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + resolved = _resolve_email(key) + if not resolved: + return (email, "") if email else (anonymous_id(identity), "") + + # Alias only when going anonymous -> email for the first time. + previous = "" if email else identity.get("anonymous_id", "") + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() except OSError: - return 0 + return 0, True events = [] for line in lines: try: @@ -341,7 +634,7 @@ def flush() -> int: claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -360,12 +653,17 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, @@ -373,16 +671,19 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. + _rewrite_claim(claim, events[start + len(chunk) :]) + return sent, True def main() -> int: diff --git a/integrations/cursor-plugin/core/_harness_id.py b/integrations/cursor-plugin/core/_harness_id.py new file mode 100644 index 000000000..40241a7f4 --- /dev/null +++ b/integrations/cursor-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "cursor" +SOURCE_TAG = "CURSOR_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "cursor" diff --git a/integrations/cursor-plugin/core/hook_runner.py b/integrations/cursor-plugin/core/hook_runner.py index 2a2adb557..559702102 100644 --- a/integrations/cursor-plugin/core/hook_runner.py +++ b/integrations/cursor-plugin/core/hook_runner.py @@ -305,8 +305,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install() + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/cursor-plugin/core/memory_core.py b/integrations/cursor-plugin/core/memory_core.py index 77d7a2b80..31a08ec37 100644 --- a/integrations/cursor-plugin/core/memory_core.py +++ b/integrations/cursor-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,10 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body, + # query string or X-Mem0-Source header, never from metadata. The + # harness tag stays in metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2555,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/cursor-plugin/core/telemetry.py b/integrations/cursor-plugin/core/telemetry.py index 249595475..d7933bfbc 100644 --- a/integrations/cursor-plugin/core/telemetry.py +++ b/integrations/cursor-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,8 +34,23 @@ from typing import Any import memory_core -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -56,10 +76,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -70,6 +99,11 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 def is_enabled() -> bool: @@ -83,9 +117,36 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _install_salt() -> str: + """Random per-install salt, created on first use and kept in the identity file.""" + identity = _read_identity() + salt = identity.get("salt") + if not salt: + salt = uuid.uuid4().hex + identity["salt"] = salt + _write_identity(identity) + return salt + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + """ + if not value: + return "" + return hashlib.sha256(f"{_install_salt()}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -145,9 +206,92 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def claim_install() -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + """ + path = _install_state_path() + # A fresh install has an empty data directory. Anything already there — + # a 0.2.x venv, an evidence db, a spool — means this is an upgrade. Read + # before the marker is created, since creating it would itself be content. + upgrading = _data_dir_has_content() + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except (OSError, json.JSONDecodeError): + return None + if not isinstance(state, dict): + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + return None + return previous def record( @@ -168,19 +312,25 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), ) if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + properties["repo_hash"] = _scoped_digest(getattr(repo, "identity", "")) if session_id: - properties["session_hash"] = _digest(session_id) + properties["session_hash"] = _scoped_digest(session_id) line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -239,38 +389,139 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape.""" + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + tail = stem.rsplit("-", 1)[-1] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age > CLAIM_EXPIRY_SECONDS and _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS: try: orphan.unlink() except OSError: pass continue if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + temporary.write_text( + "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining), + encoding="utf-8", + ) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + released = time.time() - CLAIM_STALE_SECONDS - 1 + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -300,34 +551,76 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and identity.get("key_fingerprint", "") == fingerprint and fingerprint: + return email, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + _write_identity(identity) return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: - return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + resolved = _resolve_email(key) + if not resolved: + return (email, "") if email else (anonymous_id(identity), "") + + # Alias only when going anonymous -> email for the first time. + previous = "" if email else identity.get("anonymous_id", "") + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() except OSError: - return 0 + return 0, True events = [] for line in lines: try: @@ -341,7 +634,7 @@ def flush() -> int: claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -360,12 +653,17 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, @@ -373,16 +671,19 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. + _rewrite_claim(claim, events[start + len(chunk) :]) + return sent, True def main() -> int: diff --git a/integrations/deepseek-plugin/README.md b/integrations/deepseek-plugin/README.md index 93e5f563f..bcd333311 100644 --- a/integrations/deepseek-plugin/README.md +++ b/integrations/deepseek-plugin/README.md @@ -86,9 +86,9 @@ Per-call `userId` overrides are rejected unless the operator enables `allowUserO ## Telemetry -Writes are tagged `source="DEEPSEEK_HARNESS"` so Mem0's backend can attribute usage to this integration. For it to surface by name (rather than bucketing into `OTHERS`), `DEEPSEEK_HARNESS` must be present in the backend's `KNOWN_EVENT_SOURCES` allowlist, a one-line platform change matching the existing `ZAPIER` / `STRANDS` sources. +Writes are tagged `source="DEEPSEEK_HARNESS"`, which the Mem0 backend recognizes so usage surfaces by name rather than bucketing into `OTHERS`. -The plugin also sends anonymous usage events (which tool ran, duration, result counts, coarse failure kind) so Mem0 can tell how the plugin is used and where it breaks. Queries, memory text, and entity ids are never sent. Turn it off with `MEM0_TELEMETRY=false`. +The plugin also sends usage events (which tool ran, duration, result counts, coarse failure kind) so Mem0 can tell how the plugin is used and where it breaks. These are **not anonymous**: when an API key is configured they are sent under your Mem0 account email, the same way the SDK attributes its own. Queries, memory text, and entity ids are never sent. Turn it off with `MEM0_TELEMETRY=false`. ## Status diff --git a/integrations/deepseek-plugin/src/index.ts b/integrations/deepseek-plugin/src/index.ts index bea70c02c..2d24b498a 100644 --- a/integrations/deepseek-plugin/src/index.ts +++ b/integrations/deepseek-plugin/src/index.ts @@ -26,10 +26,8 @@ export const name = "mem0"; export const inject = ["tools", "systemPrompt"]; // Tags writes so Mem0's backend attributes them to this integration in -// telemetry. The backend keeps recognized values via its KNOWN_EVENT_SOURCES -// allowlist; unknown values bucket into "OTHERS", so "DEEPSEEK_HARNESS" must be -// added to that allowlist for usage to surface by name (a one-line backend PR, -// same pattern as the ZAPIER / STRANDS sources). +// telemetry. The backend's KNOWN_EVENT_SOURCES allowlist recognizes this value; +// anything outside it buckets into "OTHERS". const SOURCE = "DEEPSEEK_HARNESS"; const DEFAULT_SEARCH_LIMIT = 10; diff --git a/integrations/kimi-plugin/core/_harness_id.py b/integrations/kimi-plugin/core/_harness_id.py new file mode 100644 index 000000000..aa17750b1 --- /dev/null +++ b/integrations/kimi-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "kimi" +SOURCE_TAG = "KIMI_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "kimi" diff --git a/integrations/kimi-plugin/core/hook_runner.py b/integrations/kimi-plugin/core/hook_runner.py index 2a2adb557..559702102 100644 --- a/integrations/kimi-plugin/core/hook_runner.py +++ b/integrations/kimi-plugin/core/hook_runner.py @@ -305,8 +305,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install() + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/kimi-plugin/core/memory_core.py b/integrations/kimi-plugin/core/memory_core.py index 77d7a2b80..31a08ec37 100644 --- a/integrations/kimi-plugin/core/memory_core.py +++ b/integrations/kimi-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,10 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body, + # query string or X-Mem0-Source header, never from metadata. The + # harness tag stays in metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2555,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/kimi-plugin/core/telemetry.py b/integrations/kimi-plugin/core/telemetry.py index 249595475..d7933bfbc 100644 --- a/integrations/kimi-plugin/core/telemetry.py +++ b/integrations/kimi-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,8 +34,23 @@ from typing import Any import memory_core -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -56,10 +76,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -70,6 +99,11 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 def is_enabled() -> bool: @@ -83,9 +117,36 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _install_salt() -> str: + """Random per-install salt, created on first use and kept in the identity file.""" + identity = _read_identity() + salt = identity.get("salt") + if not salt: + salt = uuid.uuid4().hex + identity["salt"] = salt + _write_identity(identity) + return salt + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + """ + if not value: + return "" + return hashlib.sha256(f"{_install_salt()}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -145,9 +206,92 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def claim_install() -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + """ + path = _install_state_path() + # A fresh install has an empty data directory. Anything already there — + # a 0.2.x venv, an evidence db, a spool — means this is an upgrade. Read + # before the marker is created, since creating it would itself be content. + upgrading = _data_dir_has_content() + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except (OSError, json.JSONDecodeError): + return None + if not isinstance(state, dict): + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + return None + return previous def record( @@ -168,19 +312,25 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), ) if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + properties["repo_hash"] = _scoped_digest(getattr(repo, "identity", "")) if session_id: - properties["session_hash"] = _digest(session_id) + properties["session_hash"] = _scoped_digest(session_id) line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -239,38 +389,139 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape.""" + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + tail = stem.rsplit("-", 1)[-1] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age > CLAIM_EXPIRY_SECONDS and _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS: try: orphan.unlink() except OSError: pass continue if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + temporary.write_text( + "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining), + encoding="utf-8", + ) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + released = time.time() - CLAIM_STALE_SECONDS - 1 + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -300,34 +551,76 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and identity.get("key_fingerprint", "") == fingerprint and fingerprint: + return email, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + _write_identity(identity) return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: - return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + resolved = _resolve_email(key) + if not resolved: + return (email, "") if email else (anonymous_id(identity), "") + + # Alias only when going anonymous -> email for the first time. + previous = "" if email else identity.get("anonymous_id", "") + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() except OSError: - return 0 + return 0, True events = [] for line in lines: try: @@ -341,7 +634,7 @@ def flush() -> int: claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -360,12 +653,17 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, @@ -373,16 +671,19 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. + _rewrite_claim(claim, events[start + len(chunk) :]) + return sent, True def main() -> int: diff --git a/integrations/mem0-agent-plugin/core/_harness_id.py b/integrations/mem0-agent-plugin/core/_harness_id.py new file mode 100644 index 000000000..b0836d6de --- /dev/null +++ b/integrations/mem0-agent-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "coding-agent" +SOURCE_TAG = "CODING_AGENT_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "coding-agent" diff --git a/integrations/mem0-agent-plugin/core/memory_core.py b/integrations/mem0-agent-plugin/core/memory_core.py index 77d7a2b80..31a08ec37 100644 --- a/integrations/mem0-agent-plugin/core/memory_core.py +++ b/integrations/mem0-agent-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,10 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body, + # query string or X-Mem0-Source header, never from metadata. The + # harness tag stays in metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2555,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/mem0-agent-plugin/core/telemetry.py b/integrations/mem0-agent-plugin/core/telemetry.py index 249595475..d7933bfbc 100644 --- a/integrations/mem0-agent-plugin/core/telemetry.py +++ b/integrations/mem0-agent-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,8 +34,23 @@ from typing import Any import memory_core -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -56,10 +76,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -70,6 +99,11 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 def is_enabled() -> bool: @@ -83,9 +117,36 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _install_salt() -> str: + """Random per-install salt, created on first use and kept in the identity file.""" + identity = _read_identity() + salt = identity.get("salt") + if not salt: + salt = uuid.uuid4().hex + identity["salt"] = salt + _write_identity(identity) + return salt + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + """ + if not value: + return "" + return hashlib.sha256(f"{_install_salt()}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -145,9 +206,92 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def claim_install() -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + """ + path = _install_state_path() + # A fresh install has an empty data directory. Anything already there — + # a 0.2.x venv, an evidence db, a spool — means this is an upgrade. Read + # before the marker is created, since creating it would itself be content. + upgrading = _data_dir_has_content() + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except (OSError, json.JSONDecodeError): + return None + if not isinstance(state, dict): + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + return None + return previous def record( @@ -168,19 +312,25 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), ) if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + properties["repo_hash"] = _scoped_digest(getattr(repo, "identity", "")) if session_id: - properties["session_hash"] = _digest(session_id) + properties["session_hash"] = _scoped_digest(session_id) line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -239,38 +389,139 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape.""" + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + tail = stem.rsplit("-", 1)[-1] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age > CLAIM_EXPIRY_SECONDS and _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS: try: orphan.unlink() except OSError: pass continue if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + temporary.write_text( + "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining), + encoding="utf-8", + ) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + released = time.time() - CLAIM_STALE_SECONDS - 1 + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -300,34 +551,76 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and identity.get("key_fingerprint", "") == fingerprint and fingerprint: + return email, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + _write_identity(identity) return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: - return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + resolved = _resolve_email(key) + if not resolved: + return (email, "") if email else (anonymous_id(identity), "") + + # Alias only when going anonymous -> email for the first time. + previous = "" if email else identity.get("anonymous_id", "") + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() except OSError: - return 0 + return 0, True events = [] for line in lines: try: @@ -341,7 +634,7 @@ def flush() -> int: claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -360,12 +653,17 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, @@ -373,16 +671,19 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. + _rewrite_claim(claim, events[start + len(chunk) :]) + return sent, True def main() -> int: diff --git a/integrations/mem0-strands/README.md b/integrations/mem0-strands/README.md index f45d98e44..8ea4ecacc 100644 --- a/integrations/mem0-strands/README.md +++ b/integrations/mem0-strands/README.md @@ -79,9 +79,11 @@ the tool share one Mem0 backend and namespace. ## Telemetry -The store sends anonymous usage events (store configuration, operation, duration, -result counts, coarse failure kind) over the Mem0 SDK's existing telemetry client, -tagged `source="STRANDS"`. Queries, memory text, message content, entity ids, and +The store sends usage events (store configuration, operation, duration, result +counts, coarse failure kind) over the Mem0 SDK's existing telemetry client, +tagged `source="STRANDS"`. These are **not anonymous**: when an API key is +configured they are sent under your Mem0 account email, the same way the SDK +attributes its own. Queries, memory text, message content, entity ids, and metadata are never sent. Turn it off with `MEM0_TELEMETRY=false`. ## Development diff --git a/integrations/pi-agent-plugin/src/commands.ts b/integrations/pi-agent-plugin/src/commands.ts index 9379bed9a..e90f8833b 100644 --- a/integrations/pi-agent-plugin/src/commands.ts +++ b/integrations/pi-agent-plugin/src/commands.ts @@ -22,6 +22,10 @@ export function registerCommands( const pluralize = (n: number, one: string, many: string): string => `${n} ${n === 1 ? one : many}`; +// Surface attribution on the wire. This was previously only a PostHog property, +// so the platform saw these calls as generic SDK traffic. +const PLATFORM_SOURCE = "PI_AGENT"; + const searchMemories = async (query: string, scope: Scope) => { const filters = resolveSearchFilters(scope, getScopeCtx()); const result = await mem0.search(query, { @@ -29,7 +33,8 @@ export function registerCommands( threshold: config.searchThreshold, topK: SEARCH_TOP_K, rerank: true, - }); + source: PLATFORM_SOURCE, + } as never); return result.results ?? []; }; @@ -45,7 +50,7 @@ export function registerCommands( const addParams = resolveAddParams(config.defaultScope, getScopeCtx()); const result = await mem0.add( [{ role: "user", content: text }], - { ...addParams, customCategories: DEFAULT_CUSTOM_CATEGORIES, infer: false }, + { ...addParams, customCategories: DEFAULT_CUSTOM_CATEGORIES, infer: false, source: PLATFORM_SOURCE } as never, ); captureCommandEvent("mem0-remember", {}, telemetryCtx); diff --git a/integrations/vercel-ai-sdk/src/mem0-utils.ts b/integrations/vercel-ai-sdk/src/mem0-utils.ts index 55d485cbc..8fa20440c 100644 --- a/integrations/vercel-ai-sdk/src/mem0-utils.ts +++ b/integrations/vercel-ai-sdk/src/mem0-utils.ts @@ -1,3 +1,5 @@ +const PROVIDER_VERSION = "3.0.2"; + import { LanguageModelV3Prompt } from '@ai-sdk/provider'; import { Mem0ConfigSettings } from './mem0-types'; import { loadApiKey } from '@ai-sdk/provider-utils'; @@ -277,7 +279,11 @@ const searchInternalMemories = async (query: string, config?: Mem0ConfigSettings method: 'POST', headers: { Authorization: `Token ${apiKey}`, - 'Content-Type': 'application/json' + 'Content-Type': 'application/json', + // Surface attribution. Set-once by contract: this wrapper is the + // outermost layer on these raw fetch calls. + 'X-Mem0-Source': 'VERCEL_AI_SDK', + 'X-Mem0-Client': `mem0-vercel-ai-provider/${PROVIDER_VERSION}` }, body: JSON.stringify(body), }; @@ -331,7 +337,11 @@ const updateMemories = async (messages: Array, config?: Mem0ConfigSetti method: 'POST', headers: { Authorization: `Token ${apiKey}`, - 'Content-Type': 'application/json' + 'Content-Type': 'application/json', + // Surface attribution. Set-once by contract: this wrapper is the + // outermost layer on these raw fetch calls. + 'X-Mem0-Source': 'VERCEL_AI_SDK', + 'X-Mem0-Client': `mem0-vercel-ai-provider/${PROVIDER_VERSION}` }, body: JSON.stringify(body), }; diff --git a/mem0-ts/src/client/mem0.ts b/mem0-ts/src/client/mem0.ts index ff259f2fe..6327acffa 100644 --- a/mem0-ts/src/client/mem0.ts +++ b/mem0-ts/src/client/mem0.ts @@ -95,6 +95,38 @@ interface ClientIdentity { const IDENTITY_CACHE_MAX_DEFAULT = 50; const identityByCredentials = new Map>(); +const SDK_VERSION = "3.1.8"; + +/** + * Surface-identity headers. + * + * X-Mem0-Source and X-Application are SET-ONCE by contract: whichever layer is + * outermost sets them and nothing below overwrites, so a plugin wrapping this + * SDK keeps its own identity. X-Mem0-Client is APPEND-ONLY - every layer adds + * itself, so the platform sees the whole stack and not just the last speaker. + */ +function surfaceHeaders(): Record { + const env: Record = + typeof process !== "undefined" && process.env ? process.env : {}; + const existing = (env.MEM0_CLIENT_STACK ?? "").trim(); + const entries = existing + ? existing + .split(",") + .map((part) => part.trim()) + .filter(Boolean) + : []; + entries.push(`mem0-js/${SDK_VERSION}`); + + const headers: Record = { + "X-Mem0-Client": entries.slice(0, 4).join(", ").slice(0, 200), + }; + const source = (env.MEM0_SOURCE ?? "").trim(); + if (source) headers["X-Mem0-Source"] = source; + const application = (env.MEM0_APPLICATION ?? "").trim(); + if (application) headers["X-Application"] = application; + return headers; +} + export default class MemoryClient { apiKey: string; host: string; @@ -129,6 +161,7 @@ export default class MemoryClient { this.headers = { Authorization: `Token ${this.apiKey}`, "Content-Type": "application/json", + ...surfaceHeaders(), }; this.client = axios.create({ diff --git a/mem0/client/main.py b/mem0/client/main.py index a52986dcd..d118bc340 100644 --- a/mem0/client/main.py +++ b/mem0/client/main.py @@ -79,6 +79,50 @@ def _maybe_alias_anon_to_email(user_email): logger.debug("Failed to alias anon telemetry to %r: %s", user_email, e) +def _sdk_version() -> str: + """Resolved here rather than imported from the package root, which would cycle.""" + try: + import importlib.metadata + + return importlib.metadata.version("mem0ai") + except Exception: + return "unknown" + + +def _client_headers(api_key: str, user_id: str) -> Dict[str, str]: + """Auth plus surface-identity headers. + + X-Mem0-Source and X-Application are SET-ONCE by contract: whichever layer is + outermost sets them, and nothing below overwrites. A plugin or harness that + wraps this SDK therefore keeps its own identity — it declares via MEM0_SOURCE + / MEM0_APPLICATION and the SDK defers. + + X-Mem0-Client is APPEND-ONLY: every layer adds itself, so the platform sees + the whole stack rather than only whoever spoke last. + """ + headers = { + "Authorization": f"Token {api_key}", + "Mem0-User-ID": user_id, + "X-Mem0-Client": _client_stack(), + } + source = os.getenv("MEM0_SOURCE", "").strip() + if source: + headers["X-Mem0-Source"] = source + application = os.getenv("MEM0_APPLICATION", "").strip() + if application: + headers["X-Application"] = application + return headers + + +def _client_stack() -> str: + """This SDK appended to any stack an outer layer already declared.""" + existing = os.getenv("MEM0_CLIENT_STACK", "").strip() + mine = f"mem0-python/{_sdk_version()}" + entries = [part.strip() for part in existing.split(",") if part.strip()] if existing else [] + entries.append(mine) + return ", ".join(entries[:4])[:200] + + class MemoryClient: """Client for interacting with the Mem0 API. @@ -129,19 +173,11 @@ class MemoryClient: self.client = client # Ensure the client has the correct base_url and headers self.client.base_url = httpx.URL(self.host) - self.client.headers.update( - { - "Authorization": f"Token {self.api_key}", - "Mem0-User-ID": self.user_id, - } - ) + self.client.headers.update(_client_headers(self.api_key, self.user_id)) else: self.client = httpx.Client( base_url=self.host, - headers={ - "Authorization": f"Token {self.api_key}", - "Mem0-User-ID": self.user_id, - }, + headers=_client_headers(self.api_key, self.user_id), timeout=300, ) self.user_email = self._validate_api_key() @@ -1027,10 +1063,7 @@ class AsyncMemoryClient: else: self.async_client = httpx.AsyncClient( base_url=self.host, - headers={ - "Authorization": f"Token {self.api_key}", - "Mem0-User-ID": self.user_id, - }, + headers=_client_headers(self.api_key, self.user_id), timeout=300, ) @@ -1053,10 +1086,7 @@ class AsyncMemoryClient: params = self._prepare_params() response = requests.get( f"{self.host}/v1/ping/", - headers={ - "Authorization": f"Token {self.api_key}", - "Mem0-User-ID": self.user_id, - }, + headers=_client_headers(self.api_key, self.user_id), params=params, ) response.raise_for_status() From dc7f88363fd0abd5c448f466bfed57a78fcf411a Mon Sep 17 00:00:00 2001 From: jianyx1 <166109249+jianyx1@users.noreply.github.com> Date: Tue, 15 Sep 2026 21:53:17 +0800 Subject: [PATCH 02/55] docs: fix Hermes integration page to match the current plugin (#7244) --- docs/integrations/hermes.mdx | 87 +++++++++++++++++++++++++----------- 1 file changed, 61 insertions(+), 26 deletions(-) diff --git a/docs/integrations/hermes.mdx b/docs/integrations/hermes.mdx index abe167622..dce08e63f 100644 --- a/docs/integrations/hermes.mdx +++ b/docs/integrations/hermes.mdx @@ -1,39 +1,35 @@ --- title: Hermes Agent -description: "Add long-term memory to Hermes agents with Mem0, on managed Mem0 Cloud or fully self-hosted (OSS), with automatic background sync and zero-latency prefetch." +description: "Add long-term memory to Hermes agents with Mem0: managed Platform, a self-hosted server, or fully local OSS — with current-turn recall and background fact extraction." --- -Add long-term memory to [Hermes Agent](https://github.com/NousResearch/hermes-agent), a self-improving AI agent CLI by Nous Research. Hermes has a pluggable memory system, and Mem0 is one of the supported providers. Once enabled, Mem0 learns facts from your conversations and surfaces relevant ones before each turn, without slowing down the chat. +Add long-term memory to [Hermes Agent](https://github.com/NousResearch/hermes-agent), a self-improving AI agent CLI by Nous Research. Hermes has a pluggable memory system, and Mem0 is one of the supported providers. Once enabled, Mem0 learns facts from your conversations and surfaces relevant ones for the current question, without slowing down the chat. -You can run Mem0 in two ways: +You can run Mem0 in three ways: - **Platform mode** (default): managed Mem0 Cloud. Add your API key and you are ready. -- **OSS mode**: fully self-hosted with your own LLM, embedder, and vector store. No data leaves your machine. +- **Self-hosted server mode**: point the plugin at a Mem0 server you run yourself (the Docker-shipped server). The plugin only talks HTTP to your server. +- **OSS mode**: run Mem0 in-process with your own LLM, embedder, and vector store. No Mem0 server required. ## How It Works -Hermes runs a built-in memory system (file-based `MEMORY.md` and `USER.md`) alongside one external provider. When Mem0 is active, it works additively with the built-in system at three points in every conversation turn. +Hermes runs a built-in memory system (file-based `MEMORY.md` and `USER.md`) alongside one external provider. When Mem0 is active, it works additively with the built-in system at two points in every conversation turn. -### 1. Before the agent responds (prefetch) +### 1. Current-turn recall (bounded wait) -When you send a message, Hermes checks for cached Mem0 search results from the previous turn. If they exist, those memories are injected into the system prompt so the model can see them. This is zero-latency, with no waiting on an API call. +When you send a message, Hermes searches your stored memories for the current question and waits up to 3 seconds for results. If they arrive in time, they are injected into the system prompt so the model can see them. If the backend is slower, Hermes skips the injection and the model can still call `mem0_search` itself — so a slow backend never blocks a turn. -### 2. After the agent responds (sync) +### 2. Background fact extraction (sync) Once the model finishes, Hermes sends the `(user message, assistant response)` pair to Mem0 in a background thread. Mem0 extracts facts automatically (for example, "user prefers Python" or "user works at Acme Corp"), so you never have to tell it what to remember. Each write is tagged with the gateway channel it came from. -### 3. Background prefetch for the next turn - -At the same time, Hermes runs a background search to pre-load relevant memories for your next message. By the time you type, the results are already cached. - ## Agent Tools -When Mem0 is active, the model gets five tools it can call during a conversation: +When Mem0 is active, the model gets four tools it can call during a conversation: | Tool | Description | Parameters | |------|-------------|------------| -| `mem0_list` | List all stored memories, for a full overview | `page`, `page_size` (default 100, max 200) | -| `mem0_search` | Semantic search by meaning, ranked by relevance | `query` (required), `top_k` (default 10, max 50), `rerank` (default `true`, Platform mode only) | +| `mem0_search` | Semantic search by meaning, ranked by relevance | `query` (required), `top_k` (default 10, max 50), `rerank` (default `false`, Platform mode only) | | `mem0_add` | Store a fact verbatim, with no LLM extraction | `content` (required) | | `mem0_update` | Update a memory's text by ID | `memory_id`, `text` (both required) | | `mem0_delete` | Delete a memory by ID | `memory_id` (required) | @@ -79,6 +75,36 @@ memory: That's it. Mem0 runs automatically from here. +## Self-Hosted Server Setup + +Run the [Mem0 server](https://github.com/mem0ai/mem0/tree/main/server) (FastAPI + pgvector) from its Docker image and point the plugin at it. Unlike OSS mode, the plugin just talks HTTP to your server. + +### Interactive + +```bash +hermes memory setup +# Select "mem0", then "Self-hosted server", and enter the server URL +``` + +### With flags + +```bash +hermes memory setup mem0 --mode selfhosted \ + --host http://localhost:8888 \ + --api-key your-admin-api-key +``` + +### With environment variables + +```bash +echo "MEM0_HOST=http://localhost:8888" >> ~/.hermes/.env +echo "MEM0_API_KEY=your-admin-api-key" >> ~/.hermes/.env +``` + +Then start a fresh Hermes session and call `mem0_search` — it connects to your server. The plugin authenticates with `X-API-Key` and uses the server's `/search` and `/memories` routes. The API key is optional only for servers running with `AUTH_DISABLED`. + +Setting `host` routes to the self-hosted server automatically. Don't combine it with `mode: oss` — OSS takes precedence and ignores `host`. + ## OSS (Self-Hosted) Setup OSS mode runs Mem0 entirely on your own infrastructure: your LLM, your embedder, and your vector store. No data is sent to Mem0 Cloud, and no Mem0 API key is required. @@ -111,15 +137,20 @@ hermes memory setup mem0 --mode oss \ | Flag | Description | |------|-------------| -| `--mode` | `platform` or `oss` | +| `--mode` | `platform`, `selfhosted`, or `oss` | +| `--api-key` | Platform API key, or the admin key of a self-hosted server | +| `--host` | Self-hosted server URL (with `--mode selfhosted`) | | `--oss-llm` | LLM provider (`openai` or `ollama`, default `openai`) | | `--oss-llm-key` | LLM API key (for `openai`) | | `--oss-llm-model` | Override the LLM model | | `--oss-llm-url` | LLM base URL (for `ollama` or a custom endpoint) | | `--oss-embedder` | Embedder provider (default `openai`) | | `--oss-embedder-key` | Embedder API key | +| `--oss-embedder-model` | Override the embedder model | +| `--oss-embedder-url` | Embedder base URL (for `ollama` or a custom endpoint) | | `--oss-vector` | Vector store (`qdrant` or `pgvector`, default `qdrant`) | | `--oss-vector-path` | Local Qdrant storage path | +| `--oss-vector-url` | Qdrant server URL | | `--oss-vector-host`, `--oss-vector-port` | PGVector or remote Qdrant host and port | | `--oss-vector-user`, `--oss-vector-password`, `--oss-vector-dbname` | PGVector connection details | | `--user-id` | Canonical user identifier | @@ -127,7 +158,7 @@ hermes memory setup mem0 --mode oss \ ## Switching Modes -You can move between Platform and OSS at any time. Run the setup command again, or edit `~/.hermes/mem0.json` directly. +You can move between the three modes at any time. Run the setup command again, or edit `~/.hermes/mem0.json` directly. ```bash # Platform to OSS @@ -136,6 +167,9 @@ hermes memory setup mem0 --mode oss --oss-llm-key sk-... # OSS to Platform hermes memory setup mem0 --mode platform --api-key sk-... +# Platform to a self-hosted server +hermes memory setup mem0 --mode selfhosted --host http://localhost:8888 + # Preview without writing anything hermes memory setup mem0 --mode oss --oss-llm-key sk-... --dry-run ``` @@ -146,7 +180,7 @@ A self-hosted `~/.hermes/mem0.json` looks like this: { "mode": "oss", "oss": { - "llm": {"provider": "openai", "config": {"model": "gpt-5-mini"}}, + "llm": {"provider": "openai", "config": {"model": "gpt-5-mini", "is_reasoning_model": true}}, "embedder": {"provider": "openai", "config": {"model": "text-embedding-3-small"}}, "vector_store": {"provider": "qdrant", "config": {"path": "~/.hermes/mem0_qdrant"}} } @@ -159,11 +193,12 @@ Behavioral settings live in `~/.hermes/mem0.json` and are written for you by `he | Key | Default | Description | |-----|---------|-------------| -| `mode` | `platform` | `platform` (Mem0 Cloud) or `oss` (self-hosted) | -| `api_key` | none | Mem0 Platform API key, required in Platform mode. Stored in `.env` as `MEM0_API_KEY` | +| `mode` | `platform` | `platform` (Mem0 Cloud) or `oss` (self-managed, in-process). Self-hosted server routing is set via `host` | +| `host` | none | Self-hosted Mem0 server URL. When set, the plugin talks HTTP to your server instead of the cloud | +| `api_key` | none | Mem0 Platform API key, or the admin key of a self-hosted server. Stored in `.env` as `MEM0_API_KEY` | | `user_id` | `hermes-user` | Identifier that scopes memories. See cross-channel behavior below | | `agent_id` | `hermes` | Agent identifier attached to writes | -| `rerank` | `true` | Rerank search results for relevance (Platform mode only) | +| `rerank` | `false` | Rerank search results for relevance (Platform mode only) | ### Cross-channel memories @@ -174,12 +209,11 @@ Hermes can run from the CLI and from gateways like Telegram, Slack, and Discord. Either way, every write is tagged with `metadata.channel` (for example `telegram` or `cli`), so per-channel views are still possible at query time. - ## Reliability - **Circuit breaker**: if Mem0 fails five times in a row, Hermes pauses calls for two minutes, then retries. The agent keeps working without memory during that window. Expected client errors, like a 404 on a missing memory id, do not count toward tripping the breaker. -- **Non-blocking**: every Mem0 call runs in a background daemon thread, so a slow or failed call never blocks your conversation. -- **Thread-safe**: the client uses lazy initialization with locking, and the background sync and prefetch threads are guarded so concurrent gateway messages cannot produce duplicate memories. +- **Non-blocking**: fact extraction runs in a background daemon thread, and current-turn recall waits at most 3 seconds, so a slow or failed call never blocks your conversation. +- **Thread-safe**: the client uses lazy initialization with locking, and the background sync and recall threads are guarded so concurrent gateway messages cannot produce duplicate memories. ## Troubleshooting @@ -188,6 +222,7 @@ Either way, every write is tagged with `metadata.channel` (for example `telegram The circuit breaker tripped after five consecutive failures and resets after two minutes. - **Platform mode**: check your API key and internet connection. +- **Self-hosted server mode**: check that the server is running and reachable at the configured `host` URL. - **OSS mode**: make sure your vector store (Qdrant or PGVector) is running and reachable. ### OSS: vector store connection refused @@ -217,8 +252,8 @@ curl http://localhost:11434/api/tags ## Key Features -1. **Two ways to run**: managed Platform or fully self-hosted OSS, switchable at any time. -2. **Zero-latency recall**: memories are prefetched in the background and cached before you type. +1. **Three ways to run**: managed Platform, a self-hosted server, or fully local OSS, switchable at any time. +2. **Current-turn recall**: memories for the current question are injected within a 3-second window, with `mem0_search` as the model's own backstop. 3. **Automatic extraction**: Mem0 extracts and deduplicates facts from each exchange for you. 4. **Non-blocking and fault tolerant**: background threads plus a circuit breaker keep the agent responsive even when Mem0 is unreachable. 5. **Additive memory**: works alongside Hermes' built-in file memory (`MEMORY.md`, `USER.md`). From b51f7692f002d4f8719dd5c0f23d4d129003757d Mon Sep 17 00:00:00 2001 From: PowderXu <126909591+PowderXu@users.noreply.github.com> Date: Tue, 15 Sep 2026 10:11:46 -0400 Subject: [PATCH 03/55] docs(upstash): correct the default collection namespace (#7287) --- docs/components/vectordbs/dbs/upstash-vector.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/components/vectordbs/dbs/upstash-vector.mdx b/docs/components/vectordbs/dbs/upstash-vector.mdx index 1858516f8..90fa49397 100644 --- a/docs/components/vectordbs/dbs/upstash-vector.mdx +++ b/docs/components/vectordbs/dbs/upstash-vector.mdx @@ -102,7 +102,7 @@ Here are the parameters available for configuring Upstash Vector: | `url` | URL for the Upstash Vector index | `None` | | `token` | Token for the Upstash Vector index | `None` | | `client` | An `upstash_vector.Index` instance | `None` | -| `collection_name` | The default namespace used | `""` | +| `collection_name` | The default namespace used | `"mem0"` | | `enable_embeddings` | Whether to use Upstash embeddings | `False` | From 0df3e4b87df20785f0741370c75e44428796193e Mon Sep 17 00:00:00 2001 From: Paurush Mittal <137642194+paurushmittal@users.noreply.github.com> Date: Wed, 16 Sep 2026 17:14:33 +0530 Subject: [PATCH 04/55] fix(docs): correct rendered titles and remaining SEO links (#7344) --- docs/api-reference.mdx | 5 ++--- docs/api-reference/memory/delete-memory.mdx | 5 ++--- docs/api-reference/memory/update-memory.mdx | 5 ++--- docs/api-reference/organization/add-org-member.mdx | 5 ++--- docs/api-reference/organization/get-org-members.mdx | 5 ++--- docs/api-reference/project/add-project-member.mdx | 5 ++--- docs/api-reference/project/get-project-members.mdx | 5 ++--- docs/components/embedders/config.mdx | 5 ++--- docs/components/embedders/models/aws-bedrock.mdx | 5 ++--- docs/components/embedders/models/azure-openai.mdx | 5 ++--- docs/components/embedders/models/google-ai.mdx | 5 ++--- docs/components/embedders/models/langchain.mdx | 5 ++--- docs/components/embedders/models/lmstudio.mdx | 5 ++--- docs/components/embedders/models/ollama.mdx | 5 ++--- docs/components/embedders/models/openai.mdx | 5 ++--- docs/components/embedders/models/together.mdx | 5 ++--- docs/components/embedders/overview.mdx | 5 ++--- docs/components/llms/config.mdx | 5 ++--- docs/components/llms/models/aws-bedrock.mdx | 5 ++--- docs/components/llms/models/azure-openai.mdx | 5 ++--- docs/components/llms/models/deepseek.mdx | 2 +- docs/components/llms/models/google-ai.mdx | 5 ++--- docs/components/llms/models/langchain.mdx | 5 ++--- docs/components/llms/models/lmstudio.mdx | 7 +++---- docs/components/llms/models/minimax.mdx | 2 +- docs/components/llms/models/ollama.mdx | 5 ++--- docs/components/llms/models/openai.mdx | 5 ++--- docs/components/llms/models/together.mdx | 5 ++--- docs/components/llms/models/xAI.mdx | 5 ++--- docs/components/llms/overview.mdx | 5 ++--- docs/components/rerankers/overview.mdx | 5 ++--- docs/components/vectordbs/config.mdx | 5 ++--- docs/components/vectordbs/dbs/langchain.mdx | 5 ++--- docs/components/vectordbs/overview.mdx | 5 ++--- docs/cookbooks/overview.mdx | 5 ++--- docs/core-concepts/memory-operations/delete.mdx | 5 ++--- docs/core-concepts/memory-operations/update.mdx | 5 ++--- docs/integrations.mdx | 5 ++--- docs/integrations/aws-bedrock.mdx | 5 ++--- docs/integrations/codex.mdx | 2 +- docs/integrations/flowise.mdx | 2 +- docs/integrations/langchain.mdx | 5 ++--- docs/integrations/n8n.mdx | 5 ++--- docs/open-source/features/custom-instructions.mdx | 5 ++--- docs/open-source/features/multimodal-support.mdx | 5 ++--- docs/open-source/features/overview.mdx | 5 ++--- docs/open-source/features/rest-api.mdx | 2 +- docs/open-source/overview.mdx | 5 ++--- docs/platform/cli.mdx | 5 ++--- docs/platform/features/custom-instructions.mdx | 5 ++--- docs/platform/features/multimodal-support.mdx | 5 ++--- docs/platform/overview.mdx | 5 ++--- 52 files changed, 100 insertions(+), 147 deletions(-) diff --git a/docs/api-reference.mdx b/docs/api-reference.mdx index 1aac9708e..2477bf313 100644 --- a/docs/api-reference.mdx +++ b/docs/api-reference.mdx @@ -1,7 +1,6 @@ --- -title: "Overview" -seo: - title: "API Reference Overview - Mem0" +title: "API Reference Overview" +sidebarTitle: "Overview" icon: "terminal" iconType: "solid" description: "REST APIs for memory management, search, and entity operations" diff --git a/docs/api-reference/memory/delete-memory.mdx b/docs/api-reference/memory/delete-memory.mdx index 1ff61da9e..87084b005 100644 --- a/docs/api-reference/memory/delete-memory.mdx +++ b/docs/api-reference/memory/delete-memory.mdx @@ -1,7 +1,6 @@ --- -title: 'Delete Memory' -seo: - title: "Delete Memory API Endpoint - Mem0" +title: "Delete Memory API Endpoint" +sidebarTitle: "Delete Memory" description: "Delete a single memory by its unique memory ID from the Mem0 platform using the DELETE endpoint." openapi: delete /v1/memories/{memory_id}/ --- \ No newline at end of file diff --git a/docs/api-reference/memory/update-memory.mdx b/docs/api-reference/memory/update-memory.mdx index 4818be587..a8a53a2e0 100644 --- a/docs/api-reference/memory/update-memory.mdx +++ b/docs/api-reference/memory/update-memory.mdx @@ -1,7 +1,6 @@ --- -title: 'Update Memory' -seo: - title: "Update Memory API Endpoint - Mem0" +title: "Update Memory API Endpoint" +sidebarTitle: "Update Memory" description: "Update the content, metadata, timestamp, or expiration date of a single memory by its unique ID using the PUT endpoint." openapi: put /v1/memories/{memory_id}/ --- diff --git a/docs/api-reference/organization/add-org-member.mdx b/docs/api-reference/organization/add-org-member.mdx index 2b0f00f4f..35237ffb6 100644 --- a/docs/api-reference/organization/add-org-member.mdx +++ b/docs/api-reference/organization/add-org-member.mdx @@ -1,7 +1,6 @@ --- -title: 'Add Member' -seo: - title: "Add Organization Member API Endpoint - Mem0" +title: "Add Organization Member API Endpoint" +sidebarTitle: "Add Member" description: "Add a new member to an organization with a specified role such as READER or OWNER access level." openapi: post /api/v1/orgs/organizations/{org_id}/members/ --- diff --git a/docs/api-reference/organization/get-org-members.mdx b/docs/api-reference/organization/get-org-members.mdx index b1a401195..333859d4c 100644 --- a/docs/api-reference/organization/get-org-members.mdx +++ b/docs/api-reference/organization/get-org-members.mdx @@ -1,7 +1,6 @@ --- -title: 'Get Members' -seo: - title: "Get Organization Members API Endpoint - Mem0" +title: "Get Organization Members API Endpoint" +sidebarTitle: "Get Members" description: "Retrieve a list of all members belonging to a specific organization on the Mem0 platform." openapi: get /api/v1/orgs/organizations/{org_id}/members/ --- \ No newline at end of file diff --git a/docs/api-reference/project/add-project-member.mdx b/docs/api-reference/project/add-project-member.mdx index f3e78c7f1..d1338f1b6 100644 --- a/docs/api-reference/project/add-project-member.mdx +++ b/docs/api-reference/project/add-project-member.mdx @@ -1,7 +1,6 @@ --- -title: 'Add Member' -seo: - title: "Add Project Member API Endpoint - Mem0" +title: "Add Project Member API Endpoint" +sidebarTitle: "Add Member" description: "Add a new member to a project with a specified role such as READER or OWNER access level." openapi: post /api/v1/orgs/organizations/{org_id}/projects/{project_id}/members/ --- diff --git a/docs/api-reference/project/get-project-members.mdx b/docs/api-reference/project/get-project-members.mdx index 722aafeba..35a4d5eb8 100644 --- a/docs/api-reference/project/get-project-members.mdx +++ b/docs/api-reference/project/get-project-members.mdx @@ -1,7 +1,6 @@ --- -title: 'Get Members' -seo: - title: "Get Project Members API Endpoint - Mem0" +title: "Get Project Members API Endpoint" +sidebarTitle: "Get Members" description: "Retrieve a list of all members belonging to a specific project on the Mem0 platform." openapi: get /api/v1/orgs/organizations/{org_id}/projects/{project_id}/members/ --- \ No newline at end of file diff --git a/docs/components/embedders/config.mdx b/docs/components/embedders/config.mdx index dd107fc04..577db6353 100644 --- a/docs/components/embedders/config.mdx +++ b/docs/components/embedders/config.mdx @@ -1,7 +1,6 @@ --- -title: Configurations -seo: - title: "Embedder Configuration Reference - Mem0" +title: "Embedder Configuration Reference" +sidebarTitle: "Configurations" description: "Reference for embedder configuration options in Mem0, including provider selection and model settings." --- diff --git a/docs/components/embedders/models/aws-bedrock.mdx b/docs/components/embedders/models/aws-bedrock.mdx index d831a5aad..2528a79fe 100644 --- a/docs/components/embedders/models/aws-bedrock.mdx +++ b/docs/components/embedders/models/aws-bedrock.mdx @@ -1,7 +1,6 @@ --- -title: AWS Bedrock -seo: - title: "AWS Bedrock as Embedding Provider - Mem0" +title: "AWS Bedrock as Embedding Provider" +sidebarTitle: "AWS Bedrock" description: "Configure AWS Bedrock as an embedding provider in Mem0 with IAM credentials and boto3 authentication." --- diff --git a/docs/components/embedders/models/azure-openai.mdx b/docs/components/embedders/models/azure-openai.mdx index 1b0e7cb9c..eb1086444 100644 --- a/docs/components/embedders/models/azure-openai.mdx +++ b/docs/components/embedders/models/azure-openai.mdx @@ -1,7 +1,6 @@ --- -title: Azure OpenAI -seo: - title: "Azure OpenAI as Embedding Provider - Mem0" +title: "Azure OpenAI as Embedding Provider" +sidebarTitle: "Azure OpenAI" description: "Configure Azure OpenAI as an embedding provider in Mem0 with API key, deployment, and endpoint settings." --- diff --git a/docs/components/embedders/models/google-ai.mdx b/docs/components/embedders/models/google-ai.mdx index c9a67bf1c..726dd83e0 100644 --- a/docs/components/embedders/models/google-ai.mdx +++ b/docs/components/embedders/models/google-ai.mdx @@ -1,7 +1,6 @@ --- -title: Google AI -seo: - title: "Google AI as Embedding Provider - Mem0" +title: "Google AI as Embedding Provider" +sidebarTitle: "Google AI" description: "Configure Google AI as an embedding provider in Mem0 using Gemini models and the GOOGLE_API_KEY variable." --- diff --git a/docs/components/embedders/models/langchain.mdx b/docs/components/embedders/models/langchain.mdx index 05908c295..e72ab32e7 100644 --- a/docs/components/embedders/models/langchain.mdx +++ b/docs/components/embedders/models/langchain.mdx @@ -1,7 +1,6 @@ --- -title: LangChain -seo: - title: "LangChain as Embedding Provider - Mem0" +title: "LangChain as Embedding Provider" +sidebarTitle: "LangChain" description: "Use LangChain as an embedding provider in Mem0 to access a wide range of models through a unified interface." --- diff --git a/docs/components/embedders/models/lmstudio.mdx b/docs/components/embedders/models/lmstudio.mdx index 8fe656be0..5ab13b08e 100644 --- a/docs/components/embedders/models/lmstudio.mdx +++ b/docs/components/embedders/models/lmstudio.mdx @@ -1,7 +1,6 @@ --- -title: "LM Studio" -seo: - title: "LM Studio as Embedding Provider - Mem0" +title: "LM Studio as Embedding Provider" +sidebarTitle: "LM Studio" description: "Configure LM Studio as an embedding provider in Mem0 for local embedding generation with models like nomic-embed-text." --- You can use embedding models from LM Studio to run Mem0 locally. diff --git a/docs/components/embedders/models/ollama.mdx b/docs/components/embedders/models/ollama.mdx index cc3f65e78..e4345b727 100644 --- a/docs/components/embedders/models/ollama.mdx +++ b/docs/components/embedders/models/ollama.mdx @@ -1,7 +1,6 @@ --- -title: "Ollama" -seo: - title: "Ollama as Embedding Provider - Mem0" +title: "Ollama as Embedding Provider" +sidebarTitle: "Ollama" description: "Configure Ollama as an embedding provider in Mem0 to generate embeddings locally using open-source models." --- You can use embedding models from Ollama to run Mem0 locally. diff --git a/docs/components/embedders/models/openai.mdx b/docs/components/embedders/models/openai.mdx index 376ffb87d..4acf136aa 100644 --- a/docs/components/embedders/models/openai.mdx +++ b/docs/components/embedders/models/openai.mdx @@ -1,7 +1,6 @@ --- -title: OpenAI -seo: - title: "OpenAI as Embedding Provider - Mem0" +title: "OpenAI as Embedding Provider" +sidebarTitle: "OpenAI" description: "Configure OpenAI as an embedding provider in Mem0 using models like text-embedding-3-large for vector generation." --- diff --git a/docs/components/embedders/models/together.mdx b/docs/components/embedders/models/together.mdx index 1cc4329c1..75f44227e 100644 --- a/docs/components/embedders/models/together.mdx +++ b/docs/components/embedders/models/together.mdx @@ -1,7 +1,6 @@ --- -title: Together -seo: - title: "Together AI as Embedding Provider - Mem0" +title: "Together AI as Embedding Provider" +sidebarTitle: "Together" description: "Configure Together AI as an embedding provider in Mem0 with support for 1024-dimensional embedding models." --- diff --git a/docs/components/embedders/overview.mdx b/docs/components/embedders/overview.mdx index e8cffd476..28f649091 100644 --- a/docs/components/embedders/overview.mdx +++ b/docs/components/embedders/overview.mdx @@ -1,7 +1,6 @@ --- -title: Overview -seo: - title: "Embedding Providers Overview - Mem0" +title: "Embedding Providers Overview" +sidebarTitle: Overview description: "Overview of all supported embedding model providers in Mem0, including OpenAI, Azure, Ollama, and more." --- diff --git a/docs/components/llms/config.mdx b/docs/components/llms/config.mdx index 5482376dc..5c67c876a 100644 --- a/docs/components/llms/config.mdx +++ b/docs/components/llms/config.mdx @@ -1,7 +1,6 @@ --- -title: Configurations -seo: - title: "LLM Configuration Reference - Mem0" +title: "LLM Configuration Reference" +sidebarTitle: "Configurations" description: "Reference for LLM configuration options in Mem0 for Python and TypeScript, including value precedence rules." --- diff --git a/docs/components/llms/models/aws-bedrock.mdx b/docs/components/llms/models/aws-bedrock.mdx index e75971391..f6f940024 100644 --- a/docs/components/llms/models/aws-bedrock.mdx +++ b/docs/components/llms/models/aws-bedrock.mdx @@ -1,7 +1,6 @@ --- -title: AWS Bedrock -seo: - title: "AWS Bedrock as LLM Provider - Mem0" +title: "AWS Bedrock as LLM Provider" +sidebarTitle: "AWS Bedrock" description: "Configure AWS Bedrock as an LLM provider in Mem0 with IAM authentication and Claude model support." --- diff --git a/docs/components/llms/models/azure-openai.mdx b/docs/components/llms/models/azure-openai.mdx index 550ff0fce..a81d3ec5f 100644 --- a/docs/components/llms/models/azure-openai.mdx +++ b/docs/components/llms/models/azure-openai.mdx @@ -1,7 +1,6 @@ --- -title: Azure OpenAI -seo: - title: "Azure OpenAI as LLM Provider - Mem0" +title: "Azure OpenAI as LLM Provider" +sidebarTitle: "Azure OpenAI" description: "Configure Azure OpenAI as an LLM provider in Mem0 with Azure Identity authentication and deployment settings." --- diff --git a/docs/components/llms/models/deepseek.mdx b/docs/components/llms/models/deepseek.mdx index ef178382a..6d9ccdb0f 100644 --- a/docs/components/llms/models/deepseek.mdx +++ b/docs/components/llms/models/deepseek.mdx @@ -3,7 +3,7 @@ title: DeepSeek description: "Configure DeepSeek as an LLM provider in Mem0 with API key setup and optional custom endpoint configuration." --- -To use DeepSeek LLM models, you have to set the `DEEPSEEK_API_KEY` environment variable. You can also optionally set `DEEPSEEK_API_BASE` if you need to use a different API endpoint (defaults to "https://api.deepseek.com"). +To use DeepSeek LLM models, you have to set the `DEEPSEEK_API_KEY` environment variable. You can also optionally set `DEEPSEEK_API_BASE` if you need to use a different API endpoint (defaults to `https://api.deepseek.com`). ## Usage diff --git a/docs/components/llms/models/google-ai.mdx b/docs/components/llms/models/google-ai.mdx index ba5e50d07..5cb7a576e 100644 --- a/docs/components/llms/models/google-ai.mdx +++ b/docs/components/llms/models/google-ai.mdx @@ -1,7 +1,6 @@ --- -title: Google AI -seo: - title: "Google AI as LLM Provider - Mem0" +title: "Google AI as LLM Provider" +sidebarTitle: "Google AI" description: "Configure Google Gemini as an LLM provider in Mem0 using the google.genai SDK and GOOGLE_API_KEY variable." --- diff --git a/docs/components/llms/models/langchain.mdx b/docs/components/llms/models/langchain.mdx index b7676ece2..2bace4cb9 100644 --- a/docs/components/llms/models/langchain.mdx +++ b/docs/components/llms/models/langchain.mdx @@ -1,7 +1,6 @@ --- -title: LangChain -seo: - title: "LangChain as LLM Provider - Mem0" +title: "LangChain as LLM Provider" +sidebarTitle: "LangChain" description: "Use LangChain as an LLM provider in Mem0 to integrate with various chat models through a unified interface." --- diff --git a/docs/components/llms/models/lmstudio.mdx b/docs/components/llms/models/lmstudio.mdx index 727ede319..192fe64e2 100644 --- a/docs/components/llms/models/lmstudio.mdx +++ b/docs/components/llms/models/lmstudio.mdx @@ -1,7 +1,6 @@ --- -title: LM Studio -seo: - title: "LM Studio as LLM Provider - Mem0" +title: "LM Studio as LLM Provider" +sidebarTitle: "LM Studio" description: "Configure LM Studio as an LLM provider in Mem0 for running local language models via an OpenAI-compatible API." --- @@ -78,7 +77,7 @@ m.add(messages, user_id="alice123", metadata={"category": "movies"}) To use LM Studio, you need to: 1. Download and install [LM Studio](https://lmstudio.ai/) 2. Start a local server from the "Server" tab - 3. Set the appropriate `lmstudio_base_url` in your configuration (default is usually http://localhost:1234/v1) + 3. Set the appropriate `lmstudio_base_url` in your configuration (default is usually `http://localhost:1234/v1`) ## Config diff --git a/docs/components/llms/models/minimax.mdx b/docs/components/llms/models/minimax.mdx index d885324e3..3d5cf36ac 100644 --- a/docs/components/llms/models/minimax.mdx +++ b/docs/components/llms/models/minimax.mdx @@ -3,7 +3,7 @@ title: MiniMax description: "Configure MiniMax as an LLM provider in Mem0 with API key setup and optional custom endpoint configuration." --- -To use MiniMax LLM models, you have to set the `MINIMAX_API_KEY` environment variable. You can also optionally set `MINIMAX_API_BASE` if you need to use a different API endpoint (defaults to "https://api.minimax.io/v1"). +To use MiniMax LLM models, you have to set the `MINIMAX_API_KEY` environment variable. You can also optionally set `MINIMAX_API_BASE` if you need to use a different API endpoint (defaults to `https://api.minimax.io/v1`). ## Usage diff --git a/docs/components/llms/models/ollama.mdx b/docs/components/llms/models/ollama.mdx index 2d6133575..7aef3d948 100644 --- a/docs/components/llms/models/ollama.mdx +++ b/docs/components/llms/models/ollama.mdx @@ -1,7 +1,6 @@ --- -title: Ollama -seo: - title: "Ollama as LLM Provider - Mem0" +title: "Ollama as LLM Provider" +sidebarTitle: "Ollama" description: "Configure Ollama as an LLM provider in Mem0 for running local language models with tool-calling support." --- diff --git a/docs/components/llms/models/openai.mdx b/docs/components/llms/models/openai.mdx index 5fe67ffb0..12e709b1f 100644 --- a/docs/components/llms/models/openai.mdx +++ b/docs/components/llms/models/openai.mdx @@ -1,7 +1,6 @@ --- -title: OpenAI -seo: - title: "OpenAI as LLM Provider - Mem0" +title: "OpenAI as LLM Provider" +sidebarTitle: "OpenAI" description: "Configure OpenAI as an LLM provider in Mem0 with support for GPT models and Openrouter compatibility." --- diff --git a/docs/components/llms/models/together.mdx b/docs/components/llms/models/together.mdx index 314564e61..d80b0592f 100644 --- a/docs/components/llms/models/together.mdx +++ b/docs/components/llms/models/together.mdx @@ -1,7 +1,6 @@ --- -title: Together -seo: - title: "Together AI as LLM Provider - Mem0" +title: "Together AI as LLM Provider" +sidebarTitle: "Together" description: "Configure Together AI as an LLM provider in Mem0 with API key setup and optional custom endpoint configuration." --- diff --git a/docs/components/llms/models/xAI.mdx b/docs/components/llms/models/xAI.mdx index 3c4ff4edc..59d41444a 100644 --- a/docs/components/llms/models/xAI.mdx +++ b/docs/components/llms/models/xAI.mdx @@ -1,7 +1,6 @@ --- -title: xAI -seo: - title: "xAI Grok as LLM Provider - Mem0" +title: "xAI Grok as LLM Provider" +sidebarTitle: "xAI" description: "Configure xAI Grok models as an LLM provider in Mem0 with API key setup and usage examples." --- diff --git a/docs/components/llms/overview.mdx b/docs/components/llms/overview.mdx index e500f58cc..99755a9d1 100644 --- a/docs/components/llms/overview.mdx +++ b/docs/components/llms/overview.mdx @@ -1,7 +1,6 @@ --- -title: Overview -seo: - title: "LLM Providers Overview - Mem0" +title: "LLM Providers Overview" +sidebarTitle: Overview description: "Overview of all supported LLM providers in Mem0, including OpenAI, Anthropic, Groq, Ollama, and more." --- diff --git a/docs/components/rerankers/overview.mdx b/docs/components/rerankers/overview.mdx index 8ec18c4e7..b5cfde3a9 100644 --- a/docs/components/rerankers/overview.mdx +++ b/docs/components/rerankers/overview.mdx @@ -1,7 +1,6 @@ --- -title: Overview -seo: - title: "Reranker Providers Overview - Mem0" +title: "Reranker Providers Overview" +sidebarTitle: "Overview" description: 'Pick the right reranker path to boost Mem0 search relevance.' --- diff --git a/docs/components/vectordbs/config.mdx b/docs/components/vectordbs/config.mdx index 2fcd6fa7a..d48dc1672 100644 --- a/docs/components/vectordbs/config.mdx +++ b/docs/components/vectordbs/config.mdx @@ -1,7 +1,6 @@ --- -title: Configurations -seo: - title: "Vector Store Configuration Reference - Mem0" +title: "Vector Store Configuration Reference" +sidebarTitle: "Configurations" description: "Reference for vector database configuration options in Mem0, including provider selection and connection settings." --- diff --git a/docs/components/vectordbs/dbs/langchain.mdx b/docs/components/vectordbs/dbs/langchain.mdx index 0ff348466..10cbee109 100644 --- a/docs/components/vectordbs/dbs/langchain.mdx +++ b/docs/components/vectordbs/dbs/langchain.mdx @@ -1,7 +1,6 @@ --- -title: LangChain -seo: - title: "LangChain as Vector Store Provider - Mem0" +title: "LangChain as Vector Store Provider" +sidebarTitle: "LangChain" description: "Use LangChain as a unified vector store provider in Mem0 to access multiple vector databases through one interface." --- diff --git a/docs/components/vectordbs/overview.mdx b/docs/components/vectordbs/overview.mdx index 2d7085d61..21f979c95 100644 --- a/docs/components/vectordbs/overview.mdx +++ b/docs/components/vectordbs/overview.mdx @@ -1,7 +1,6 @@ --- -title: Overview -seo: - title: "Vector Store Providers Overview - Mem0" +title: "Vector Store Providers Overview" +sidebarTitle: "Overview" description: "Overview of all supported vector databases in Mem0, including Qdrant, Chroma, PGVector, Pinecone, Oracle, and more." --- diff --git a/docs/cookbooks/overview.mdx b/docs/cookbooks/overview.mdx index df98e590c..c8434e771 100644 --- a/docs/cookbooks/overview.mdx +++ b/docs/cookbooks/overview.mdx @@ -1,7 +1,6 @@ --- -title: Overview -seo: - title: "Cookbooks and Tutorials - Mem0" +title: "Cookbooks and Tutorials" +sidebarTitle: "Overview" description: "Browse cookbook examples and tutorials for building AI applications with Mem0, from companion chatbots to AI agents." --- diff --git a/docs/core-concepts/memory-operations/delete.mdx b/docs/core-concepts/memory-operations/delete.mdx index 694546f8e..eb8f4c8c9 100644 --- a/docs/core-concepts/memory-operations/delete.mdx +++ b/docs/core-concepts/memory-operations/delete.mdx @@ -1,7 +1,6 @@ --- -title: Delete Memory -seo: - title: "Delete Memory Operation - Mem0" +title: "Delete Memory Operation" +sidebarTitle: "Delete Memory" description: Remove memories from Mem0 either individually, in bulk, or via filters. icon: "trash" iconType: "solid" diff --git a/docs/core-concepts/memory-operations/update.mdx b/docs/core-concepts/memory-operations/update.mdx index b53af5559..b1e190b47 100644 --- a/docs/core-concepts/memory-operations/update.mdx +++ b/docs/core-concepts/memory-operations/update.mdx @@ -1,7 +1,6 @@ --- -title: Update Memory -seo: - title: "Update Memory Operation - Mem0" +title: "Update Memory Operation" +sidebarTitle: "Update Memory" description: Modify an existing memory by updating its content or metadata. icon: "pen-to-square" iconType: "solid" diff --git a/docs/integrations.mdx b/docs/integrations.mdx index 138e6cffe..a912afcad 100644 --- a/docs/integrations.mdx +++ b/docs/integrations.mdx @@ -1,7 +1,6 @@ --- -title: Overview -seo: - title: "Integrations Overview - Mem0" +title: "Integrations Overview" +sidebarTitle: "Overview" description: "Overview of Mem0 integrations with popular AI frameworks and tools for persistent memory and context management." --- diff --git a/docs/integrations/aws-bedrock.mdx b/docs/integrations/aws-bedrock.mdx index 55c757f16..069893fc6 100644 --- a/docs/integrations/aws-bedrock.mdx +++ b/docs/integrations/aws-bedrock.mdx @@ -1,7 +1,6 @@ --- -title: AWS Bedrock -seo: - title: "AWS Bedrock Integration with Mem0" +title: "AWS Bedrock Integration" +sidebarTitle: "AWS Bedrock" description: "Use Mem0 with AWS Bedrock and OpenSearch Service for cloud-native persistent semantic memory storage." --- diff --git a/docs/integrations/codex.mdx b/docs/integrations/codex.mdx index d0ad0735f..a91f4f8f0 100644 --- a/docs/integrations/codex.mdx +++ b/docs/integrations/codex.mdx @@ -3,7 +3,7 @@ title: Codex description: "Add persistent memory to OpenAI Codex with automatic capture, automatic recall, a search tool, and six memory skills." --- -Add persistent memory to [**OpenAI Codex**](https://openai.com/index/codex/) with the Mem0 plugin. Codex forgets everything between tasks. This plugin fixes that by connecting to Mem0's cloud memory layer via MCP, automatically capturing learnings at key lifecycle points, and retrieving relevant context on the first prompt of a session. Codex can use the search tool for recall later in the session. +Add persistent memory to [**OpenAI Codex**](https://openai.com/codex/) with the Mem0 plugin. Codex forgets everything between tasks. This plugin fixes that by connecting to Mem0's cloud memory layer via MCP, automatically capturing learnings at key lifecycle points, and retrieving relevant context on the first prompt of a session. Codex can use the search tool for recall later in the session. Current plugin version: `0.3.1`. diff --git a/docs/integrations/flowise.mdx b/docs/integrations/flowise.mdx index 790a470fb..56649eb7b 100644 --- a/docs/integrations/flowise.mdx +++ b/docs/integrations/flowise.mdx @@ -23,7 +23,7 @@ npm install -g flowise npx flowise start ``` -2. Access to the Flowise UI at http://localhost:3000 +2. Access to the Flowise UI at `http://localhost:3000` 3. Basic familiarity with [Flowise's LLM orchestration](https://flowiseai.com/#features) concepts ## Setup and Configuration diff --git a/docs/integrations/langchain.mdx b/docs/integrations/langchain.mdx index 2f8d1a7a9..ae8e41ef3 100644 --- a/docs/integrations/langchain.mdx +++ b/docs/integrations/langchain.mdx @@ -1,7 +1,6 @@ --- -title: Langchain -seo: - title: "LangChain Integration with Mem0" +title: "LangChain Integration" +sidebarTitle: "Langchain" description: "Build personalized AI agents using LangChain for conversation flow and Mem0 for long-term memory retention." --- diff --git a/docs/integrations/n8n.mdx b/docs/integrations/n8n.mdx index b9d345d6b..f53358b77 100644 --- a/docs/integrations/n8n.mdx +++ b/docs/integrations/n8n.mdx @@ -1,7 +1,6 @@ --- -title: n8n -seo: - title: "n8n Integration with Mem0" +title: "n8n Integration" +sidebarTitle: "n8n" description: "Add long-term memory to n8n workflows and AI Agents with the Mem0 community node, no code required." --- diff --git a/docs/open-source/features/custom-instructions.mdx b/docs/open-source/features/custom-instructions.mdx index 06a3acd10..b6d40f39f 100644 --- a/docs/open-source/features/custom-instructions.mdx +++ b/docs/open-source/features/custom-instructions.mdx @@ -1,7 +1,6 @@ --- -title: Custom Instructions -seo: - title: "Open Source Custom Instructions - Mem0" +title: "Open Source Custom Instructions" +sidebarTitle: "Custom Instructions" description: Tailor fact extraction so Mem0 stores only the details you care about. icon: "wand-magic-sparkles" --- diff --git a/docs/open-source/features/multimodal-support.mdx b/docs/open-source/features/multimodal-support.mdx index 7fb9f335b..b1697cced 100644 --- a/docs/open-source/features/multimodal-support.mdx +++ b/docs/open-source/features/multimodal-support.mdx @@ -1,7 +1,6 @@ --- -title: Multimodal Support -seo: - title: "Open Source Multimodal Support - Mem0" +title: "Open Source Multimodal Support" +sidebarTitle: "Multimodal Support" description: Capture and recall memories from both text and images. icon: "image" --- diff --git a/docs/open-source/features/overview.mdx b/docs/open-source/features/overview.mdx index 8e8379bd8..59c01f5f6 100644 --- a/docs/open-source/features/overview.mdx +++ b/docs/open-source/features/overview.mdx @@ -1,7 +1,6 @@ --- -title: "Overview" -seo: - title: "Open Source Features Overview - Mem0" +title: "Open Source Features Overview" +sidebarTitle: "Overview" description: "Self-hosting features that extend Mem0 beyond basic memory storage" icon: "list" --- diff --git a/docs/open-source/features/rest-api.mdx b/docs/open-source/features/rest-api.mdx index b798d242d..4a877907c 100644 --- a/docs/open-source/features/rest-api.mdx +++ b/docs/open-source/features/rest-api.mdx @@ -56,7 +56,7 @@ The Mem0 REST API server exposes every OSS memory operation over HTTP. Run it al make bootstrap # starts Compose, creates an admin, issues the first API key ``` - Or to start the stack only and finish setup via the browser wizard at http://localhost:3000: + Or to start the stack only and finish setup via the browser wizard at `http://localhost:3000`: ```bash cd server diff --git a/docs/open-source/overview.mdx b/docs/open-source/overview.mdx index 667172c08..0adb15003 100644 --- a/docs/open-source/overview.mdx +++ b/docs/open-source/overview.mdx @@ -1,7 +1,6 @@ --- -title: "Overview" -seo: - title: "Mem0 Open Source Overview" +title: "Open Source Overview" +sidebarTitle: "Overview" description: "Self-host Mem0 with full control over your infrastructure and data" icon: "house" --- diff --git a/docs/platform/cli.mdx b/docs/platform/cli.mdx index 21d48d29e..e34f0aa59 100644 --- a/docs/platform/cli.mdx +++ b/docs/platform/cli.mdx @@ -1,7 +1,6 @@ --- -title: CLI -seo: - title: "Mem0 CLI for Terminal Memory Management" +title: "CLI for Terminal Memory Management" +sidebarTitle: "CLI" description: "Manage memories from your terminal, for both humans and AI agents." icon: "terminal" iconType: "solid" diff --git a/docs/platform/features/custom-instructions.mdx b/docs/platform/features/custom-instructions.mdx index 923c8f5dc..8b5b1f35e 100644 --- a/docs/platform/features/custom-instructions.mdx +++ b/docs/platform/features/custom-instructions.mdx @@ -1,7 +1,6 @@ --- -title: Custom Instructions -seo: - title: "Platform Custom Instructions - Mem0" +title: "Platform Custom Instructions" +sidebarTitle: "Custom Instructions" description: 'Control how Mem0 extracts and stores memories using natural language guidelines' --- diff --git a/docs/platform/features/multimodal-support.mdx b/docs/platform/features/multimodal-support.mdx index 4c450ea37..3de9e0177 100644 --- a/docs/platform/features/multimodal-support.mdx +++ b/docs/platform/features/multimodal-support.mdx @@ -1,7 +1,6 @@ --- -title: Multimodal Support -seo: - title: "Platform Multimodal Support - Mem0" +title: "Platform Multimodal Support" +sidebarTitle: "Multimodal Support" description: Integrate images and documents into your interactions with Mem0 --- diff --git a/docs/platform/overview.mdx b/docs/platform/overview.mdx index 35933c511..ddb5ff405 100644 --- a/docs/platform/overview.mdx +++ b/docs/platform/overview.mdx @@ -1,7 +1,6 @@ --- -title: "Overview" -seo: - title: "Mem0 Platform Overview" +title: "Platform Overview" +sidebarTitle: "Overview" description: "Managed memory layer for AI agents, production-ready in minutes" icon: "cloud" --- From f5220ff8d4236f2369a19b554f76a47059deb2b6 Mon Sep 17 00:00:00 2001 From: ANIRUDDHA ADAK Date: Thu, 17 Sep 2026 19:23:45 +0530 Subject: [PATCH 05/55] fix(security): bump next to 15.5.24, patches GHSA-p293-qw3h-jr36 (#7320) --- examples/mem0-demo/package.json | 2 +- server/dashboard/package.json | 2 +- server/dashboard/pnpm-lock.yaml | 84 ++++++++++++++++----------------- 3 files changed, 44 insertions(+), 44 deletions(-) diff --git a/examples/mem0-demo/package.json b/examples/mem0-demo/package.json index ec5b7c61c..ef1f8d20a 100644 --- a/examples/mem0-demo/package.json +++ b/examples/mem0-demo/package.json @@ -28,7 +28,7 @@ "clsx": "^2.1.1", "js-cookie": "^3.0.6", "lucide-react": "^0.477.0", - "next": "15.5.21", + "next": "15.5.24", "react": "^19.0.0", "react-dom": "^19.0.0", "react-markdown": "^10.0.1", diff --git a/server/dashboard/package.json b/server/dashboard/package.json index 7d1b86432..d2ce90831 100644 --- a/server/dashboard/package.json +++ b/server/dashboard/package.json @@ -45,7 +45,7 @@ "framer-motion": "^12.23.12", "lodash": "^4.18.1", "lucide-react": "^0.542.0", - "next": "15.5.21", + "next": "15.5.24", "next-themes": "^0.4.4", "react": "^19.0.0", "react-copy-to-clipboard": "^5.1.0", diff --git a/server/dashboard/pnpm-lock.yaml b/server/dashboard/pnpm-lock.yaml index acbd0b7eb..1fe88f38f 100644 --- a/server/dashboard/pnpm-lock.yaml +++ b/server/dashboard/pnpm-lock.yaml @@ -122,8 +122,8 @@ importers: specifier: ^0.542.0 version: 0.542.0(react@19.2.7) next: - specifier: 15.5.21 - version: 15.5.21(@types/node@22.5.4)(react-dom@19.2.7(react@19.2.7))(react@19.2.7) + specifier: 15.5.24 + version: 15.5.24(@types/node@22.5.4)(react-dom@19.2.7(react@19.2.7))(react@19.2.7) next-themes: specifier: ^0.4.4 version: 0.4.6(react-dom@19.2.7(react@19.2.7))(react@19.2.7) @@ -476,60 +476,60 @@ packages: '@emnapi/core': ^1.7.1 '@emnapi/runtime': ^1.7.1 - '@next/env@15.5.21': - resolution: {integrity: sha512-hjJI/GfrjWHgNguRIBzItjRRu0m3Nrz17GhxsjuHfjIvg9hyg3239REd2dpI+bpMTFuVrVprHzEQ19m++cDtbw==} + '@next/env@15.5.24': + resolution: {integrity: sha512-mBDF7T0XKZjs9SpUAl0buizVO+O02ULjOvWX8o/AZo/5AGw/UAS1Zzcylmd4pqbftzmKQi+L/nB4jgBYKEAl5Q==} '@next/eslint-plugin-next@15.5.18': resolution: {integrity: sha512-w4MYq8M26a8PNrfto0JosLf5/3ssln1rsyP96g2DkC8uFVymStM5DLSz5ElxxrPRg2XnTMnFo3kREFlhYvxhWw==} - '@next/swc-darwin-arm64@15.5.21': - resolution: {integrity: sha512-ZfjqPEdi6TRC/fWx7UDbwb1fbVgyh2uD5tVTRKIDZDlYM+UNuE/LafDG2fwuAoZilADpABh46OY/F5qf9JjqLQ==} + '@next/swc-darwin-arm64@15.5.24': + resolution: {integrity: sha512-AGdNLvxZNY6eR2iSnV+6wUa8CiHTMr4F7g3uHH7fT4ICIJBE00R9u4tzN/Vuwsw0cOi8MTD2HJcTCb6siMH88Q==} engines: {node: '>= 10'} cpu: [arm64] os: [darwin] - '@next/swc-darwin-x64@15.5.21': - resolution: {integrity: sha512-TlCf1NpxgQLzTrexuev75xwmNCJMd1/qkJpTVP1GRRcih93hlIBn1P72hkh8T0gnRFr6BmWksQtbyG3jT6jnww==} + '@next/swc-darwin-x64@15.5.24': + resolution: {integrity: sha512-9HrQajBMmGcrrrvDfRimiCrbAPh3E6uHJmwBovYr6Yrmi9p9PZqI876BrXX280wICh3o2XwUlp4blkB0NNBqFg==} engines: {node: '>= 10'} cpu: [x64] os: [darwin] - '@next/swc-linux-arm64-gnu@15.5.21': - resolution: {integrity: sha512-LXRsq1p+HvHSi7ygwNcSEEcK0zuo5jS75ZlqFHtOH+LF7qntXAJVJxah+1Pi/GyBm7EpkwU7m4EgbvIKrMqm9A==} + '@next/swc-linux-arm64-gnu@15.5.24': + resolution: {integrity: sha512-rl9LSfE75si0WT3cDgdUC1XYCKS+TgxC+/IjitmeycrAG18X/plIP1/vy8dd/HPycYcIvE688PD7FuvEAiEAew==} engines: {node: '>= 10'} cpu: [arm64] os: [linux] libc: [glibc] - '@next/swc-linux-arm64-musl@15.5.21': - resolution: {integrity: sha512-hyGixhFxpDKjqoev6l4KlcRBlt9AXWrGhDZwmwg49sMJM5tnKQPSi+SEj9+e5n+l/bthRGZUdh59GKIs6lQPRw==} + '@next/swc-linux-arm64-musl@15.5.24': + resolution: {integrity: sha512-TlNAnpsjxSF3aAUtqnfmtXXf8m9sIDBlmF3c7bTAlnshUYu2U0OxN2uf5d0gcFwqHVEdivJNBcCaqNOwPGNimw==} engines: {node: '>= 10'} cpu: [arm64] os: [linux] libc: [musl] - '@next/swc-linux-x64-gnu@15.5.21': - resolution: {integrity: sha512-qfE+YfOba6S2+13e8qn1/UozDVNZ2clBlrs8UtDoax4s8ediu6sq93z66OEHUYlb69Tffh5JTNkgtsAKiSuugg==} + '@next/swc-linux-x64-gnu@15.5.24': + resolution: {integrity: sha512-7dwtlhr0SLndqTG1z9ncRkbJswDZiKWlxzFyXDvJ2RDZRDRHp8zyMJ4D9UH/FgnQeXxxB6gZy2pMcIUoNKQ4pA==} engines: {node: '>= 10'} cpu: [x64] os: [linux] libc: [glibc] - '@next/swc-linux-x64-musl@15.5.21': - resolution: {integrity: sha512-BXLGG+EvIwp/Rrgl6HY8sqvD6BOUOIRz8/naDbeLNX7mlA5H2XRcL6MW/0IGnJISfj5BA9gNhFyJj5yOoiIDJQ==} + '@next/swc-linux-x64-musl@15.5.24': + resolution: {integrity: sha512-kGZxM+WhkYs0276lFrMkj7PRtXT3Btp6cwvfSO/cCVLxJJttB5Ccnl2niaCgUja8HgSbEVnMHpg3FJWoOJ9e/g==} engines: {node: '>= 10'} cpu: [x64] os: [linux] libc: [musl] - '@next/swc-win32-arm64-msvc@15.5.21': - resolution: {integrity: sha512-tNGNOlT0Wn7E4IMsSnufjXN/l2L2/AGdLLpa2vzS89SYCBuihgLn3ngLsIrvndAnWo9nAkus+4gZHTI/Ijx9HA==} + '@next/swc-win32-arm64-msvc@15.5.24': + resolution: {integrity: sha512-jBDDkZ/qKAqkWivWDMkJSXUzbzV0QKRBKJjEHUAvSB97Hzw7NLzJ6yV56Lts/wjir7s4P31GYgpbS6ZL+hasAA==} engines: {node: '>= 10'} cpu: [arm64] os: [win32] - '@next/swc-win32-x64-msvc@15.5.21': - resolution: {integrity: sha512-DmIdWmC9p4rdNIiQqo8ap0+Cnj6kKtTZnuSCxoYydSc8sgpDgAg9wFhxplunak9imLV0pTvc5WVCOHwm5eHLtQ==} + '@next/swc-win32-x64-msvc@15.5.24': + resolution: {integrity: sha512-JqtwjvvorjacQ0spgjmUJoxySoYgPwdT1sFdQ0/zmW4iMlP2hjYlCoJIyS7o6Epb4Fug8eco3HXFoBDUCDeH7Q==} engines: {node: '>= 10'} cpu: [x64] os: [win32] @@ -2417,8 +2417,8 @@ packages: react: ^16.8 || ^17 || ^18 || ^19 || ^19.0.0-rc react-dom: ^16.8 || ^17 || ^18 || ^19 || ^19.0.0-rc - next@15.5.21: - resolution: {integrity: sha512-/TsdBtkWLhkl+NVL3Uqws2UphNd6IPzOtzSk1fHaf+0P7GQKLZDUytyhns/Ykbzdy9+YRjwG7ONvrHaaTDdFqQ==} + next@15.5.24: + resolution: {integrity: sha512-Y+xn8EQCoC3ZbsFPyzE+tE8XOdrWeUdUF7NeXbmg9DsgAxl5UYxlsrvgVESHTyTGigoTa1bCUrxn70F5bqt0Gw==} engines: {node: ^18.18.0 || ^19.8.0 || >= 20.0.0} hasBin: true peerDependencies: @@ -3343,34 +3343,34 @@ snapshots: '@tybys/wasm-util': 0.10.2 optional: true - '@next/env@15.5.21': {} + '@next/env@15.5.24': {} '@next/eslint-plugin-next@15.5.18': dependencies: fast-glob: 3.3.1 - '@next/swc-darwin-arm64@15.5.21': + '@next/swc-darwin-arm64@15.5.24': optional: true - '@next/swc-darwin-x64@15.5.21': + '@next/swc-darwin-x64@15.5.24': optional: true - '@next/swc-linux-arm64-gnu@15.5.21': + '@next/swc-linux-arm64-gnu@15.5.24': optional: true - '@next/swc-linux-arm64-musl@15.5.21': + '@next/swc-linux-arm64-musl@15.5.24': optional: true - '@next/swc-linux-x64-gnu@15.5.21': + '@next/swc-linux-x64-gnu@15.5.24': optional: true - '@next/swc-linux-x64-musl@15.5.21': + '@next/swc-linux-x64-musl@15.5.24': optional: true - '@next/swc-win32-arm64-msvc@15.5.21': + '@next/swc-win32-arm64-msvc@15.5.24': optional: true - '@next/swc-win32-x64-msvc@15.5.21': + '@next/swc-win32-x64-msvc@15.5.24': optional: true '@nodelib/fs.scandir@2.1.5': @@ -5421,24 +5421,24 @@ snapshots: react: 19.2.7 react-dom: 19.2.7(react@19.2.7) - next@15.5.21(@types/node@22.5.4)(react-dom@19.2.7(react@19.2.7))(react@19.2.7): + next@15.5.24(@types/node@22.5.4)(react-dom@19.2.7(react@19.2.7))(react@19.2.7): dependencies: - '@next/env': 15.5.21 + '@next/env': 15.5.24 '@swc/helpers': 0.5.15 - caniuse-lite: 1.0.30001797 + caniuse-lite: 1.0.30001810 postcss: 8.5.23 react: 19.2.7 react-dom: 19.2.7(react@19.2.7) styled-jsx: 5.1.6(react@19.2.7) optionalDependencies: - '@next/swc-darwin-arm64': 15.5.21 - '@next/swc-darwin-x64': 15.5.21 - '@next/swc-linux-arm64-gnu': 15.5.21 - '@next/swc-linux-arm64-musl': 15.5.21 - '@next/swc-linux-x64-gnu': 15.5.21 - '@next/swc-linux-x64-musl': 15.5.21 - '@next/swc-win32-arm64-msvc': 15.5.21 - '@next/swc-win32-x64-msvc': 15.5.21 + '@next/swc-darwin-arm64': 15.5.24 + '@next/swc-darwin-x64': 15.5.24 + '@next/swc-linux-arm64-gnu': 15.5.24 + '@next/swc-linux-arm64-musl': 15.5.24 + '@next/swc-linux-x64-gnu': 15.5.24 + '@next/swc-linux-x64-musl': 15.5.24 + '@next/swc-win32-arm64-msvc': 15.5.24 + '@next/swc-win32-x64-msvc': 15.5.24 sharp: 0.35.3(@types/node@22.5.4) transitivePeerDependencies: - '@babel/core' From f135cb994979170401d4e62d37fd043ed01ac5f8 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 17 Sep 2026 19:32:03 +0530 Subject: [PATCH 06/55] SEO & metadata audit: shorten hermes description (#7359) Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs/integrations/hermes.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/integrations/hermes.mdx b/docs/integrations/hermes.mdx index dce08e63f..26de7221c 100644 --- a/docs/integrations/hermes.mdx +++ b/docs/integrations/hermes.mdx @@ -1,6 +1,6 @@ --- title: Hermes Agent -description: "Add long-term memory to Hermes agents with Mem0: managed Platform, a self-hosted server, or fully local OSS — with current-turn recall and background fact extraction." +description: "Add long-term memory to Hermes agents using Mem0 Platform, a self-hosted server, or local OSS mode with background fact extraction." --- Add long-term memory to [Hermes Agent](https://github.com/NousResearch/hermes-agent), a self-improving AI agent CLI by Nous Research. Hermes has a pluggable memory system, and Mem0 is one of the supported providers. Once enabled, Mem0 learns facts from your conversations and surfaces relevant ones for the current question, without slowing down the chat. From 84bf468176f0c5e82493bb95aec5484eb2d92bc1 Mon Sep 17 00:00:00 2001 From: Kartik Date: Fri, 18 Sep 2026 06:54:04 +0530 Subject: [PATCH 07/55] docs: add practical Mem0 Copilot guide (MEM-6344) (#7337) --- docs/docs.json | 1 + docs/llms.txt | 1 + docs/platform/copilot.mdx | 194 ++++++++++++++++++++++++++++++++++++++ 3 files changed, 196 insertions(+) create mode 100644 docs/platform/copilot.mdx diff --git a/docs/docs.json b/docs/docs.json index c1c4887d2..4ca51fa24 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -41,6 +41,7 @@ "pages": [ "platform/quickstart", "platform/overview", + "platform/copilot", "platform/agent-signup", "vibecoding", "platform/cli", diff --git a/docs/llms.txt b/docs/llms.txt index 65e13de8f..686835a0e 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -171,6 +171,7 @@ If the user is on a pre-current major (Python < 2, TS < 3, or a Platform call st - [Introduction](https://docs.mem0.ai/introduction) [Both]: Use when the user wants a one-page overview of how memory fits between the LLM and the app. - [Vibe Code with Mem0](https://docs.mem0.ai/vibecoding) [Both]: Use when the user is in Claude Code, Cursor, or Windsurf and wants memory wired into their editor. - [Platform Overview](https://docs.mem0.ai/platform/overview) [Platform]: Use when the user picks the managed product - 4-line integration, hosted API, dashboard. +- [Mem0 Copilot](https://docs.mem0.ai/platform/copilot) [Platform]: Use when inspecting project memories, reviewing configuration changes, or testing extraction in the dashboard. - [Sign up as an agent](https://docs.mem0.ai/platform/agent-signup) [Platform]: Use when an AI agent needs to mint a Mem0 API key autonomously - four commands, no email or dashboard, human claims ownership later. - [Platform vs Open Source](https://docs.mem0.ai/platform/platform-vs-oss) [Both]: Use when the user is deciding between managed and self-hosted. - [Platform Quickstart](https://docs.mem0.ai/platform/quickstart) [Platform]: Use for the first Platform integration - API key plus `MemoryClient.add/search`. diff --git a/docs/platform/copilot.mdx b/docs/platform/copilot.mdx new file mode 100644 index 000000000..3d218ff84 --- /dev/null +++ b/docs/platform/copilot.mdx @@ -0,0 +1,194 @@ +--- +title: "Mem0 Copilot" +description: "Inspect project memories, review configuration changes, and test extraction from the Mem0 dashboard." +icon: "message" +--- + +Copilot is an AI assistant in the [Mem0 dashboard](https://app.mem0.ai/dashboard/copilot). Ask it to inspect stored memories, suggest extraction rules and categories, change project settings, or explain the platform SDKs and APIs. + +You describe the task in chat. Copilot uses tools to read project data or propose changes. In **Review changes** mode, you approve each change before it runs. + +## Start with your project + +1. Sign in to the dashboard and select the organization and project you want to work on. +2. Open **Copilot** in the sidebar. +3. Select **Review changes** below the message box. +4. Ask: “Show my current project settings and explain what each one does.” +5. Expand an activity card, such as **Read project config**, to see its **Input** and **Result**. Check these results when reviewing an answer or confirming a change. + +You can ask about settings or SDK usage with an empty project. Suggestions based on stored data need enough project history to analyze. + +## Inspect stored memories + +Start with a project overview, then narrow the question: + +| Prompt | What to inspect | +| --- | --- | +| “Summarize what this project has stored and how it is categorized.” | The memories and category patterns Copilot reads. Check which records support its summary. | +| “Analyze the memories for user alice.” | Facts stored for `alice`, their categories, and unwanted information. To investigate a missing fact, also provide the original input. | +| “Search alice's memories for dietary preferences.” | Memories relevant to the query within that user's scope. | + +Copilot can list memories across the project. Searching by meaning needs a specific User, Agent, App, or Run ID. Select one in **Scope** or name it in your prompt. + +Memory lists are paginated, and suggestions use samples. Check the activity results to see which records were read. Ask for more pages when you need to inspect the rest. + +### Choose the memory scope + +Open **Scope** below the message box. Select an existing ID or type one and choose it. + +| Control | Identifies | +| --- | --- | +| **User** | The end user whose memories you want to inspect, such as `alice`. | +| **Agent** | An AI agent associated with the memories. | +| **App** | An application associated with the memories. | +| **Run** | A particular execution or session associated with the memories. | + +A field set to **any** adds no filter for that entity type. **Clear scope** removes the selections. Scope gives Copilot default IDs to use; you can request a different entity in a message. Check the activity's **Input** to confirm which IDs it used. Adding a test memory requires a **User** ID, even when another entity is selected. + + + Scope selects memories, not separate settings. Categories, extraction instructions, memory depth, and multilingual settings apply to the selected project. Category and extraction suggestions also analyze project data, regardless of the selected entity. + + +See [Entity-scoped memory](/platform/features/entity-scoped-memory) for how these IDs organize memories in your application. + +## Review and apply changes + +The mode control below the message box determines when changes run: + +- **Review changes**: Copilot pauses before changing project configuration or adding a test memory. Read the proposal and choose whether to apply it. +- **Auto-apply**: Copilot can change settings and add test memories without asking for approval. Check the selected project and scope before using it. + +Ask Copilot to show the current settings before requesting an update. In the approval card, review every listed field. Approving the card applies the whole proposal, including fields you did not edit. + +| Action | Effect | +| --- | --- | +| **Apply change** | Approve the proposed write. Inspect the subsequent result to confirm it succeeded. | +| **Edit** | When offered, edit extraction instructions or category names and descriptions. Choose **Apply with edits** to submit your revision. | +| **Discard edits** | Return to the original proposal without applying it. | +| **Decline** | Reject this proposal without applying it. | +| **Ask for something else** | Enter feedback and choose **Send**. This declines the current proposal and sends your feedback as a new message. Review the next proposal before applying it. | + +Not every field has an inline editor. If a proposal includes both extraction instructions and categories, only the instructions get an editor. The editor cannot apply blank instructions or an empty category list. Use **Ask for something else** to change other fields or request separate proposals. + + + A generated prompt profile contains separate prompts for extraction and summaries. If your project uses one, saving extraction instructions through Copilot deactivates it. Review the replacement rules and test the affected behavior before using them in production. + + +## What Copilot cannot do + +Copilot cannot perform these actions, even in **Auto-apply** mode: + +- Create or delete API keys. +- Directly edit or delete existing memories. +- Export project data. +- Invite or remove organization or project members, or change their roles and permissions. +- Create or delete organizations or projects. +- Change billing details or subscription plans. + +Use the dashboard or the relevant platform API for these tasks. Copilot can explain the steps or point you to documentation, but it cannot carry out the actions. + +Copilot supports the managed Mem0 platform. It does not help configure or use the [self-hosted open-source library](/open-source/overview). + +## Example 1: Stop storing small talk, then test extraction + +This walkthrough uses a project where you have noticed greetings or small talk in stored memories. Use a development project when trying configuration changes, since a test user does not isolate project settings. + + + + Select the project, set **User** to `alice`, and ask: + + > Analyze the memories for user alice. + + Inspect the returned memories. Identify examples of small talk you want to exclude and useful facts you still want to keep. + + + With **Review changes** selected, ask: + + > Update my extraction instructions to ignore greetings and small talk. Keep the existing rules for durable user preferences. + + Check for a **Read project config** activity before reviewing the update. If it is missing, ask Copilot to read the current instructions first. If analysis reports insufficient data, ask it to use the rule you provided. You can also set the rule directly through [Custom instructions](/platform/features/custom-instructions). + + + Review the full replacement text. Keep existing rules your application needs. For this test, the relevant rules could look like: + + ```text + Remember the following: + + * The user's dietary preferences and food restrictions. + + Don't remember the following: + + * Greetings and small talk. + ``` + + Use **Edit** to adjust the wording, or **Ask for something else** to request a revision. + + Choose **Apply change** or **Apply with edits**, then inspect the result to confirm the instructions were saved. + + + Choose a new **User** ID for this test, such as `copilot-extraction-test-01`, and clear any other entity selections. Ask: + + > Add this as a user message for copilot-extraction-test-01: “Hi! How's your day? I prefer vegetarian meals and avoid peanuts.” + + Review the test-memory proposal and choose **Apply change**. + + + Adding a test memory writes to the selected project. It is not a dry run. Use a dedicated test user so you can find and remove the test data afterward. + + + + Expand **Add test memory** and inspect **Result**. A `PENDING` status means extraction is still running. Use the returned `event_id` with the [Get Event API](/api-reference/events/get-event) to check progress. Wait for `SUCCEEDED` before evaluating the output. If the event is `FAILED`, inspect its details before retrying. + + Then ask: + + > List all memories for user copilot-extraction-test-01. Then search that user's memories for dietary preferences. + + Check that the memories retain the vegetarian preference and peanut restriction, and exclude the greeting. Inspect the full list as well as search results: a relevant search can hide unwanted small-talk records. + + If the output is wrong, describe the mismatch and review another instruction change. Use a new test user for the next attempt so earlier memories do not affect the result. Remove test data afterward through the dashboard or [memory deletion API](/api-reference/memory/delete-memories). + + + +Test with new inputs after changing settings. Updating configuration is not a cleanup operation for existing memories. See [Custom instructions](/platform/features/custom-instructions) for guidance on writing extraction rules. + +## Example 2: Suggest categories and extraction instructions + +These workflows sample the selected project's data. Generating a suggestion does not update settings by itself. Copilot can then propose applying it, which follows the selected review mode. Use **Review changes** to inspect suggestions before they are saved. + +| Workflow | Data used | Example prompt | +| --- | --- | --- | +| Custom categories | Stored memories, excluding deleted memories. | “Suggest custom categories from this project's memories.” | +| Extraction instructions | Successful requests to add conversation data, including requests that produced no memories. | “Compare recent add requests with the extracted memories and suggest better extraction instructions.” | + +Category suggestions identify recurring themes. Review the names, descriptions, and examples. Applying a category list replaces the project's previous list; it does not add to it or re-tag existing memories. See [Custom categories](/platform/features/custom-categories) for project and per-call behavior. + +Extraction suggestions compare conversation inputs with what was extracted. One add request can produce several memories or none, so the number of add requests is different from the number of stored memories. Keep your application's existing requirements when reviewing the proposal. + +Both workflows require enough project data. If a suggestion fails because there is too little data, check the activity's **Result** for the current and required counts. You can still inspect memories, ask SDK/API questions, or provide your own rules instead of requesting a data-based suggestion. + +## Example 3: Adjust detail and language + +Ask Copilot to read the current settings, then request the change you need: + +- **Memory depth** controls the level of detail: **Less**, **Medium**, or **More detailed**. Try “Show my current memory depth, then propose More detailed memories.” For deciding *which facts* to retain, use extraction instructions. +- **Multilingual** behavior preserves the user's original language. Try “Enable multilingual behavior so memories preserve the language of the input.” Test it with a new conversation in the language your application uses. + +Both are project settings. Review the proposed values and test a fresh input after applying them. See [Organization and project settings](/api-reference/organizations-projects) for configuration through the API. + +## Example 4: Ask SDK and API questions + +Include your language and the task, for example: + +> Show me how to search memories for user alice with the managed Mem0 Python SDK. Link the documentation you used. + +Copilot can look up the official platform documentation. Check the **Browse mem0 docs** and **Read docs page** activities and open the cited pages. If an answer has no sources, ask for them before using the example. The [Platform quickstart](/platform/quickstart) covers adding and searching memories in code. + +## Resume a conversation and check message limits + +Use **History** to reopen your 50 most recently active chats for the selected project. Chats belong to the person who created them; other project members cannot open them. Use **New chat** to start a separate conversation, or **Delete chat** in history to remove one. Deleting a chat does not undo settings changes or remove test memories. + +Message allowances depend on the organization's plan and are shared across its projects and members. They reset at the start of each calendar month in UTC. + +For plans with a limit, a usage notice appears once 80% of the allowance is used. Below that point, no counter is shown. At the limit, new messages are disabled until the allowance resets or the plan is upgraded. Follow the notice's upgrade link to review plan options. + +Sending feedback through **Ask for something else** counts as a new message. Approving or declining a saved proposal without feedback does not use another message. Test additions and searches also use the platform APIs and remain subject to their normal quotas. From e4e0307ae6c13dfa0b11d77c8b66936e524aede1 Mon Sep 17 00:00:00 2001 From: Saket Aryan Date: Fri, 18 Sep 2026 13:23:05 +0530 Subject: [PATCH 08/55] fix(plugins): say what telemetry actually sends, and salt the hashes (#7322) --- docs/integrations/claude-code.mdx | 30 ++++ docs/integrations/deepseek-plugin.mdx | 2 +- docs/integrations/openclaw.mdx | 4 +- .../agent-plugin-core/python/telemetry.py | 138 +++++++++++++++++- .../skills/pause/SKILL.md.tmpl | 4 +- .../antigravity-plugin/core/telemetry.py | 138 +++++++++++++++++- .../antigravity-plugin/skills/pause/SKILL.md | 4 +- integrations/claude-code-plugin/README.md | 14 +- .../claude-code-plugin/core/telemetry.py | 138 +++++++++++++++++- .../claude-code-plugin/skills/pause/SKILL.md | 4 +- .../tests/test_telemetry.py | 112 ++++++++++++++ integrations/codex-plugin/core/telemetry.py | 138 +++++++++++++++++- .../codex-plugin/skills/pause/SKILL.md | 4 +- integrations/cursor-plugin/core/telemetry.py | 138 +++++++++++++++++- .../cursor-plugin/skills/pause/SKILL.md | 4 +- integrations/deepseek-plugin/README.md | 4 +- integrations/deepseek-plugin/src/index.ts | 6 +- integrations/kimi-plugin/core/telemetry.py | 138 +++++++++++++++++- .../kimi-plugin/skills/pause/SKILL.md | 4 +- .../mem0-agent-plugin/core/telemetry.py | 138 +++++++++++++++++- .../mem0-agent-plugin/skills/pause/SKILL.md | 4 +- integrations/mem0-strands/README.md | 8 +- integrations/zapier-mem0/README.md | 2 +- 23 files changed, 1120 insertions(+), 56 deletions(-) diff --git a/docs/integrations/claude-code.mdx b/docs/integrations/claude-code.mdx index 0b8e5a328..4277bb90e 100644 --- a/docs/integrations/claude-code.mdx +++ b/docs/integrations/claude-code.mdx @@ -172,6 +172,36 @@ claude plugin update mem0@mem0-plugins --scope user | Sidekick won't start | Must be in a Git repo. Check that your Claude Code version supports plugin agents and worktrees. | | Remove the plugin | `claude plugin uninstall mem0@mem0-plugins` | +## Telemetry + +The plugin sends usage events (which hook ran, timing, result counts, failure +types) so Mem0 can see what's used and what's breaking. + +These events are **not anonymous**. When an API key is configured, which +installing the plugin requires, they are sent under your Mem0 account email, +the same way the Python SDK and the CLI attribute theirs. Without a key they +are sent under a random per-machine id. + +Each event carries the event name, the plugin version, the harness it ran in, +your OS and Python version, and per-event properties describing what happened: +timings, counts, coarse outcome and failure labels, and which model was +configured. Repository and session identifiers are hashed with a random salt +generated on your machine, so they cannot be linked back to a repository name +or path. + +The exact set is enforced in code rather than by this list: every property is +filtered through a denylist of sensitive keys and credential-shaped values are +redacted before anything is sent. + +Prompts, memory text, queries, file paths, repository names, and API keys are +never sent. + +Turn it off: + +```bash +export MEM0_TELEMETRY=false +``` + Detailed MCP configuration for all clients diff --git a/docs/integrations/deepseek-plugin.mdx b/docs/integrations/deepseek-plugin.mdx index 16b8badaf..0242496e1 100644 --- a/docs/integrations/deepseek-plugin.mdx +++ b/docs/integrations/deepseek-plugin.mdx @@ -114,7 +114,7 @@ Both tools also accept optional per-call `userId`, `agentId`, and `runId` params ## Telemetry -Writes are tagged `source="DEEPSEEK_HARNESS"` so Mem0 can attribute usage to this integration. Anonymous usage events include operation names, durations, result counts, and coarse failure kinds. Queries, memory text, entity IDs, and API keys are never included. Set `MEM0_TELEMETRY=false` to opt out. +Writes are tagged `source="DEEPSEEK_HARNESS"` so Mem0 can attribute usage to this integration. Usage events include operation names, durations, result counts, and coarse failure kinds. They are **not anonymous**: when an API key is configured they are sent under your Mem0 account email, the same way the SDK attributes its own. Queries, memory text, entity IDs, and API keys are never included. Set `MEM0_TELEMETRY=false` to opt out. This plugin is a developer preview and tracks the evolving DeepSeek Harness plugin API. diff --git a/docs/integrations/openclaw.mdx b/docs/integrations/openclaw.mdx index a9642d444..fd7d449d9 100644 --- a/docs/integrations/openclaw.mdx +++ b/docs/integrations/openclaw.mdx @@ -481,7 +481,9 @@ Plugin config is stored in `~/.openclaw/openclaw.json` with file permissions `0o ### Telemetry -Anonymous usage telemetry (PostHog) is enabled by default to help improve the plugin. No conversation content or memory values are included, only event counts (recall, capture, tool usage, CLI commands). +Usage telemetry (PostHog) is enabled by default to help improve the plugin. No conversation content or memory values are included, only event counts (recall, capture, tool usage, CLI commands). + +These events are **not anonymous**. OpenClaw does not send your account email the way the SDK does, but it does send an unsalted SHA-256 hash of it, falling back to a hash of the API key and then to a random per-machine id. Mem0 holds the email the hash is derived from, so the hash identifies your account rather than concealing it. The first run that resolves an account also emits a PostHog `$identify`, which permanently merges any earlier random id into that identity. To opt out, set the environment variable: diff --git a/integrations/agent-plugin-core/python/telemetry.py b/integrations/agent-plugin-core/python/telemetry.py index 249595475..132de5b0c 100644 --- a/integrations/agent-plugin-core/python/telemetry.py +++ b/integrations/agent-plugin-core/python/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,6 +34,7 @@ from typing import Any import memory_core +_salt_cache: str = "" _harness: str = "generic" _source_tag: str = "MEM0_PLUGIN" _PRIVATE_KEYS = { @@ -83,9 +89,126 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _salt_path() -> Path: + return memory_core.data_dir() / "telemetry-salt" + + +def _install_salt() -> str: + """Random per-install salt, created once and memoized for the process. + + Deliberately its own file, claimed with O_CREAT|O_EXCL, rather than a key in + the identity file. Three reasons, all of which produced wrong data when this + lived in the identity dict: + + - Hooks are short-lived separate processes firing on every tool call, and + people run more than one agent window. A read-modify-write would let each + process mint its own salt, so one repository would hash several ways in the + window before a writer won. + - resolve_distinct_id holds a copy of the identity dict across a network call + to /v1/ping/, so whichever write landed second erased the other's key — + losing either the salt (repo_hash changes mid-stream) or the email (a + second $identify, splitting the person). + - Touching the identity file from record() would create it, and is_first_run + keys off that file, so recording an event would silently suppress the + install event. + + Published atomically, and there is deliberately no derived fallback. Creating + the file with O_CREAT|O_EXCL and then writing into it leaves a window where + the file exists and is empty, and a concurrent hook that reads it in that + window gets nothing. Falling back to a digest of the path would hand that + process a salt an attacker can compute, memoized for its whole run, which is + the privacy control this function exists to provide silently turning itself + off under load. The salt is written to a private temp file first and linked + into place, so the name either does not exist or already has the full value. + + Returns "" when it genuinely cannot persist. Callers omit the hash entirely + rather than emit an unsalted one. + """ + global _salt_cache + if _salt_cache: + return _salt_cache + + path = _salt_path() + # Read before writing. Hooks are separate processes firing on every tool + # call, so all but the first find the salt already published; going straight + # to create-fsync-link-unlink meant every one of them paid an fsync to + # discover that, on a path whose whole promise is appending a line and + # returning. + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + if _salt_cache: + return _salt_cache + except OSError: + pass + + temporary = path.with_name(f"{path.name}.{os.getpid()}.tmp") + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(temporary, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(handle, "w", encoding="utf-8") as stream: + stream.write(uuid.uuid4().hex) + stream.flush() + os.fsync(stream.fileno()) + try: + # Atomic claim: fails if another process already published one. + # os.link rather than replace, which would clobber theirs. + os.link(temporary, path) + except FileExistsError: + pass + except OSError: + # No hardlinks here (some network mounts, some container volumes). + # Claim the name directly instead. That reopens the empty-file + # window, but the window is now benign: a reader that lands in it + # gets "" and omits the hash for that process rather than caching a + # guessable one. Losing the hashes on every run of an entire + # filesystem is the worse failure. + try: + fallback = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(fallback, "w", encoding="utf-8") as stream: + stream.write(temporary.read_text(encoding="utf-8")) + except OSError: + pass + except OSError: + pass + finally: + try: + temporary.unlink() + except OSError: + pass + + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + except OSError: + _salt_cache = "" + return _salt_cache + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + + Returns "" when there is no salt, so record() omits the property. An + unsalted digest over this input space is close to plaintext, and emitting one + under a name that implies it is hashed is worse than sending nothing. + """ + if not value: + return "" + salt = _install_salt() + if not salt: + return "" + return hashlib.sha256(f"{salt}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -174,10 +297,17 @@ def record( os=sys.platform, python_version=platform.python_version(), ) + # Assigned only when the digest is real. _scoped_digest returns "" when + # the salt could not be persisted, and an empty property is worse than an + # absent one: it survives the None filter below and reads as a value. if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + repo_hash = _scoped_digest(getattr(repo, "identity", "")) + if repo_hash: + properties["repo_hash"] = repo_hash if session_id: - properties["session_hash"] = _digest(session_id) + session_hash = _scoped_digest(session_id) + if session_hash: + properties["session_hash"] = session_hash line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", diff --git a/integrations/agent-plugin-core/skills/pause/SKILL.md.tmpl b/integrations/agent-plugin-core/skills/pause/SKILL.md.tmpl index 9cc720c7a..569305ec7 100644 --- a/integrations/agent-plugin-core/skills/pause/SKILL.md.tmpl +++ b/integrations/agent-plugin-core/skills/pause/SKILL.md.tmpl @@ -7,8 +7,8 @@ disable-model-invocation: true # Pause memory capture To pause (hooks stop capturing and sending session content; a minimal -anonymous telemetry ping still fires at session start unless -`MEM0_TELEMETRY=false`): +telemetry ping still fires at session start, under your Mem0 account email, +unless `MEM0_TELEMETRY=false`): ```bash python3 "{{PLUGIN_ROOT}}/core/memory_cli.py" --harness "{{HARNESS_ID}}" {{PLUGIN_DATA_ARG}} pause diff --git a/integrations/antigravity-plugin/core/telemetry.py b/integrations/antigravity-plugin/core/telemetry.py index 249595475..132de5b0c 100644 --- a/integrations/antigravity-plugin/core/telemetry.py +++ b/integrations/antigravity-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,6 +34,7 @@ from typing import Any import memory_core +_salt_cache: str = "" _harness: str = "generic" _source_tag: str = "MEM0_PLUGIN" _PRIVATE_KEYS = { @@ -83,9 +89,126 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _salt_path() -> Path: + return memory_core.data_dir() / "telemetry-salt" + + +def _install_salt() -> str: + """Random per-install salt, created once and memoized for the process. + + Deliberately its own file, claimed with O_CREAT|O_EXCL, rather than a key in + the identity file. Three reasons, all of which produced wrong data when this + lived in the identity dict: + + - Hooks are short-lived separate processes firing on every tool call, and + people run more than one agent window. A read-modify-write would let each + process mint its own salt, so one repository would hash several ways in the + window before a writer won. + - resolve_distinct_id holds a copy of the identity dict across a network call + to /v1/ping/, so whichever write landed second erased the other's key — + losing either the salt (repo_hash changes mid-stream) or the email (a + second $identify, splitting the person). + - Touching the identity file from record() would create it, and is_first_run + keys off that file, so recording an event would silently suppress the + install event. + + Published atomically, and there is deliberately no derived fallback. Creating + the file with O_CREAT|O_EXCL and then writing into it leaves a window where + the file exists and is empty, and a concurrent hook that reads it in that + window gets nothing. Falling back to a digest of the path would hand that + process a salt an attacker can compute, memoized for its whole run, which is + the privacy control this function exists to provide silently turning itself + off under load. The salt is written to a private temp file first and linked + into place, so the name either does not exist or already has the full value. + + Returns "" when it genuinely cannot persist. Callers omit the hash entirely + rather than emit an unsalted one. + """ + global _salt_cache + if _salt_cache: + return _salt_cache + + path = _salt_path() + # Read before writing. Hooks are separate processes firing on every tool + # call, so all but the first find the salt already published; going straight + # to create-fsync-link-unlink meant every one of them paid an fsync to + # discover that, on a path whose whole promise is appending a line and + # returning. + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + if _salt_cache: + return _salt_cache + except OSError: + pass + + temporary = path.with_name(f"{path.name}.{os.getpid()}.tmp") + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(temporary, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(handle, "w", encoding="utf-8") as stream: + stream.write(uuid.uuid4().hex) + stream.flush() + os.fsync(stream.fileno()) + try: + # Atomic claim: fails if another process already published one. + # os.link rather than replace, which would clobber theirs. + os.link(temporary, path) + except FileExistsError: + pass + except OSError: + # No hardlinks here (some network mounts, some container volumes). + # Claim the name directly instead. That reopens the empty-file + # window, but the window is now benign: a reader that lands in it + # gets "" and omits the hash for that process rather than caching a + # guessable one. Losing the hashes on every run of an entire + # filesystem is the worse failure. + try: + fallback = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(fallback, "w", encoding="utf-8") as stream: + stream.write(temporary.read_text(encoding="utf-8")) + except OSError: + pass + except OSError: + pass + finally: + try: + temporary.unlink() + except OSError: + pass + + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + except OSError: + _salt_cache = "" + return _salt_cache + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + + Returns "" when there is no salt, so record() omits the property. An + unsalted digest over this input space is close to plaintext, and emitting one + under a name that implies it is hashed is worse than sending nothing. + """ + if not value: + return "" + salt = _install_salt() + if not salt: + return "" + return hashlib.sha256(f"{salt}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -174,10 +297,17 @@ def record( os=sys.platform, python_version=platform.python_version(), ) + # Assigned only when the digest is real. _scoped_digest returns "" when + # the salt could not be persisted, and an empty property is worse than an + # absent one: it survives the None filter below and reads as a value. if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + repo_hash = _scoped_digest(getattr(repo, "identity", "")) + if repo_hash: + properties["repo_hash"] = repo_hash if session_id: - properties["session_hash"] = _digest(session_id) + session_hash = _scoped_digest(session_id) + if session_hash: + properties["session_hash"] = session_hash line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", diff --git a/integrations/antigravity-plugin/skills/pause/SKILL.md b/integrations/antigravity-plugin/skills/pause/SKILL.md index e88f7d315..77b4146b6 100644 --- a/integrations/antigravity-plugin/skills/pause/SKILL.md +++ b/integrations/antigravity-plugin/skills/pause/SKILL.md @@ -7,8 +7,8 @@ disable-model-invocation: true # Pause memory capture To pause (hooks stop capturing and sending session content; a minimal -anonymous telemetry ping still fires at session start unless -`MEM0_TELEMETRY=false`): +telemetry ping still fires at session start, under your Mem0 account email, +unless `MEM0_TELEMETRY=false`): ```bash python3 "${ANTIGRAVITY_PLUGIN_ROOT}/core/memory_cli.py" --harness "antigravity" pause diff --git a/integrations/claude-code-plugin/README.md b/integrations/claude-code-plugin/README.md index 130460b17..b58f54c79 100644 --- a/integrations/claude-code-plugin/README.md +++ b/integrations/claude-code-plugin/README.md @@ -136,13 +136,23 @@ Local data lives in `${CLAUDE_PLUGIN_DATA}`: - `pending/`: sessions waiting to be sent to Mem0 (retried after interruption) - `flush-worker.log`: whether memory creation succeeded - `plugin-errors.log`: hook errors (no credentials) -- `telemetry.jsonl` / `telemetry-identity.json`: anonymous usage events +- `telemetry.jsonl` / `telemetry-identity.json`: usage events and the id they are sent under +- `telemetry-salt`: random per-install salt for the repo and session hashes +- `install-state.json`: records that install has been counted once on this machine Mem0 receives captured user messages, Claude's answers, sidekick assignments and completed responses, and changed file paths. When a failed command is recorded, extraction can also include bounded command details and results. Complete files and general tool output stay on your machine. Values that look like credentials are redacted before anything is sent. ## Telemetry -Anonymous usage events (which hook ran, timing, result counts, failure types) so Mem0 can identify what's used and what's breaking. Repo and session IDs are hashed before leaving your machine. Prompts, memory text, file paths, tool output, and API keys are never sent. +Usage events (which hook ran, timing, result counts, failure types) so Mem0 can identify what's used and what's breaking. + +**These events are not anonymous.** When an API key is configured — which installing the plugin requires — events are sent under your Mem0 account email, the same way the Python SDK and the CLI attribute theirs. Without a key they are sent under a random per-machine id. + +What each event carries: the event name, the plugin version, the harness it ran in, your OS and Python version, and per-event properties describing what happened — timings, counts, coarse outcome and failure labels, and which model was configured. Repository and session identifiers are hashed with a random salt generated on your machine, so they cannot be linked back to a repository name or path. + +Rather than restate a list that drifts, the exact set is enforced in code: `telemetry.record` filters every property through a denylist of sensitive keys and redacts credential-shaped values. See `_PRIVATE_KEYS` in `core/telemetry.py`. + +Prompts, memory text, queries, file paths, repository names, and API keys are never sent. Turn it off: diff --git a/integrations/claude-code-plugin/core/telemetry.py b/integrations/claude-code-plugin/core/telemetry.py index 249595475..132de5b0c 100644 --- a/integrations/claude-code-plugin/core/telemetry.py +++ b/integrations/claude-code-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,6 +34,7 @@ from typing import Any import memory_core +_salt_cache: str = "" _harness: str = "generic" _source_tag: str = "MEM0_PLUGIN" _PRIVATE_KEYS = { @@ -83,9 +89,126 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _salt_path() -> Path: + return memory_core.data_dir() / "telemetry-salt" + + +def _install_salt() -> str: + """Random per-install salt, created once and memoized for the process. + + Deliberately its own file, claimed with O_CREAT|O_EXCL, rather than a key in + the identity file. Three reasons, all of which produced wrong data when this + lived in the identity dict: + + - Hooks are short-lived separate processes firing on every tool call, and + people run more than one agent window. A read-modify-write would let each + process mint its own salt, so one repository would hash several ways in the + window before a writer won. + - resolve_distinct_id holds a copy of the identity dict across a network call + to /v1/ping/, so whichever write landed second erased the other's key — + losing either the salt (repo_hash changes mid-stream) or the email (a + second $identify, splitting the person). + - Touching the identity file from record() would create it, and is_first_run + keys off that file, so recording an event would silently suppress the + install event. + + Published atomically, and there is deliberately no derived fallback. Creating + the file with O_CREAT|O_EXCL and then writing into it leaves a window where + the file exists and is empty, and a concurrent hook that reads it in that + window gets nothing. Falling back to a digest of the path would hand that + process a salt an attacker can compute, memoized for its whole run, which is + the privacy control this function exists to provide silently turning itself + off under load. The salt is written to a private temp file first and linked + into place, so the name either does not exist or already has the full value. + + Returns "" when it genuinely cannot persist. Callers omit the hash entirely + rather than emit an unsalted one. + """ + global _salt_cache + if _salt_cache: + return _salt_cache + + path = _salt_path() + # Read before writing. Hooks are separate processes firing on every tool + # call, so all but the first find the salt already published; going straight + # to create-fsync-link-unlink meant every one of them paid an fsync to + # discover that, on a path whose whole promise is appending a line and + # returning. + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + if _salt_cache: + return _salt_cache + except OSError: + pass + + temporary = path.with_name(f"{path.name}.{os.getpid()}.tmp") + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(temporary, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(handle, "w", encoding="utf-8") as stream: + stream.write(uuid.uuid4().hex) + stream.flush() + os.fsync(stream.fileno()) + try: + # Atomic claim: fails if another process already published one. + # os.link rather than replace, which would clobber theirs. + os.link(temporary, path) + except FileExistsError: + pass + except OSError: + # No hardlinks here (some network mounts, some container volumes). + # Claim the name directly instead. That reopens the empty-file + # window, but the window is now benign: a reader that lands in it + # gets "" and omits the hash for that process rather than caching a + # guessable one. Losing the hashes on every run of an entire + # filesystem is the worse failure. + try: + fallback = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(fallback, "w", encoding="utf-8") as stream: + stream.write(temporary.read_text(encoding="utf-8")) + except OSError: + pass + except OSError: + pass + finally: + try: + temporary.unlink() + except OSError: + pass + + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + except OSError: + _salt_cache = "" + return _salt_cache + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + + Returns "" when there is no salt, so record() omits the property. An + unsalted digest over this input space is close to plaintext, and emitting one + under a name that implies it is hashed is worse than sending nothing. + """ + if not value: + return "" + salt = _install_salt() + if not salt: + return "" + return hashlib.sha256(f"{salt}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -174,10 +297,17 @@ def record( os=sys.platform, python_version=platform.python_version(), ) + # Assigned only when the digest is real. _scoped_digest returns "" when + # the salt could not be persisted, and an empty property is worse than an + # absent one: it survives the None filter below and reads as a value. if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + repo_hash = _scoped_digest(getattr(repo, "identity", "")) + if repo_hash: + properties["repo_hash"] = repo_hash if session_id: - properties["session_hash"] = _digest(session_id) + session_hash = _scoped_digest(session_id) + if session_hash: + properties["session_hash"] = session_hash line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", diff --git a/integrations/claude-code-plugin/skills/pause/SKILL.md b/integrations/claude-code-plugin/skills/pause/SKILL.md index 5aef04f39..ce69d13d2 100644 --- a/integrations/claude-code-plugin/skills/pause/SKILL.md +++ b/integrations/claude-code-plugin/skills/pause/SKILL.md @@ -7,8 +7,8 @@ disable-model-invocation: true # Pause memory capture To pause (hooks stop capturing and sending session content; a minimal -anonymous telemetry ping still fires at session start unless -`MEM0_TELEMETRY=false`): +telemetry ping still fires at session start, under your Mem0 account email, +unless `MEM0_TELEMETRY=false`): ```bash python3 "${CLAUDE_PLUGIN_ROOT}/core/memory_cli.py" --harness "claude-code" --plugin-data-dir "${CLAUDE_PLUGIN_DATA}" pause diff --git a/integrations/claude-code-plugin/tests/test_telemetry.py b/integrations/claude-code-plugin/tests/test_telemetry.py index 0ae280b19..6029fa98a 100644 --- a/integrations/claude-code-plugin/tests/test_telemetry.py +++ b/integrations/claude-code-plugin/tests/test_telemetry.py @@ -1,6 +1,7 @@ from __future__ import annotations import json +import os import sys from pathlib import Path from unittest.mock import patch @@ -273,3 +274,114 @@ def test_spawn_flush_does_nothing_without_a_spool(isolated_env): with patch.object(telemetry.subprocess, "Popen") as popen: assert telemetry.spawn_flush() is True popen.assert_called_once() + + +def test_salt_is_stable_across_processes(isolated_env): + """Hooks are separate short-lived processes; one repo must hash one way. + + An unlocked read-modify-write let each process mint its own salt, so a + repository hashed several ways in the window before one writer won. + """ + import subprocess as sp + + core = str(Path(__file__).resolve().parents[1] / "core") + script = ( + f"import sys; sys.path.insert(0, {core!r})\n" + "import telemetry\n" + "print(telemetry._install_salt())" + ) + env = {**os.environ, "MEM0_CODE_DATA_DIR": str(memory_core.data_dir())} + salts = { + sp.run([sys.executable, "-c", script], capture_output=True, text=True, env=env).stdout.strip() + for _ in range(4) + } + assert len(salts) == 1, f"one repo hashed {len(salts)} ways: {salts}" + + +def test_salt_does_not_touch_the_identity_file(isolated_env): + """The identity file is is_first_run's marker and the sender's email store. + + Writing the salt into it would create it from record(), suppressing the + install event, and would race resolve_distinct_id, which holds a stale copy + of that dict across a network call. + """ + telemetry._install_salt() + assert not telemetry._identity_path().exists() + + +def test_no_salt_means_no_hash_rather_than_an_unsalted_one(isolated_env, monkeypatch): + """A read-only data dir drops the property; it must not emit a weak digest. + + The previous fallback was a digest of the salt file's own path, which an + attacker can compute, memoized for the whole process. A property named + repo_hash carrying an effectively unsalted digest is worse than no property: + it reads as protected and is not. + """ + telemetry._salt_cache = "" + monkeypatch.setattr(telemetry.os, "open", lambda *a, **k: (_ for _ in ()).throw(OSError("read-only"))) + + assert telemetry._install_salt() == "" + assert telemetry._scoped_digest("git@github.com:acme/secret.git") == "" + + +def test_a_half_written_salt_is_never_visible_to_another_process(isolated_env, monkeypatch): + """The window this closes: file created, value not yet written. + + O_CREAT|O_EXCL then write leaves the name present and empty in between. A + hook reading it there used to get "", fall back to the path digest and cache + that for its whole run, so the same repo hashed two ways depending on timing. + Publishing by link means the name either does not exist or is complete. + """ + telemetry._salt_cache = "" + salt_path = telemetry._salt_path() + observed = [] + + real_link = telemetry.os.link + + def observing_link(source, target): + # Stand where the racing reader stands: after the temp file is written, + # before the real name exists. + observed.append(salt_path.exists()) + return real_link(source, target) + + monkeypatch.setattr(telemetry.os, "link", observing_link) + salt = telemetry._install_salt() + + assert observed == [False], "the salt name existed before it held a value" + assert len(salt) == 32 + assert salt_path.read_text(encoding="utf-8").strip() == salt + + +def test_a_filesystem_without_hardlinks_still_gets_a_salt(isolated_env, monkeypatch): + """Publishing by link must not become a silent loss of the hashes. + + Some network mounts and container volumes reject os.link. Returning "" + there would drop repo_hash and session_hash on every run for that whole + cohort, which is a bigger loss than the narrow race the link closes. + """ + telemetry._salt_cache = "" + monkeypatch.setattr( + telemetry.os, "link", lambda src, dst: (_ for _ in ()).throw(OSError(38, "not implemented")) + ) + + salt = telemetry._install_salt() + + assert len(salt) == 32, "no salt on a filesystem without hardlinks" + assert telemetry._salt_path().read_text(encoding="utf-8").strip() == salt + assert telemetry._scoped_digest("git@github.com:acme/x.git") != "" + assert not list(telemetry._salt_path().parent.glob("telemetry-salt.*.tmp")) + + +def test_a_concurrent_writer_does_not_clobber_the_published_salt(isolated_env): + """Second process to finish must adopt the first one's salt, not replace it. + + os.link rather than os.replace is what makes losing the race harmless. + """ + telemetry._salt_cache = "" + first = telemetry._install_salt() + + telemetry._salt_cache = "" + second = telemetry._install_salt() + + assert second == first + assert not list(telemetry._salt_path().parent.glob("telemetry-salt.*.tmp")), "temp file left behind" diff --git a/integrations/codex-plugin/core/telemetry.py b/integrations/codex-plugin/core/telemetry.py index 249595475..132de5b0c 100644 --- a/integrations/codex-plugin/core/telemetry.py +++ b/integrations/codex-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,6 +34,7 @@ from typing import Any import memory_core +_salt_cache: str = "" _harness: str = "generic" _source_tag: str = "MEM0_PLUGIN" _PRIVATE_KEYS = { @@ -83,9 +89,126 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _salt_path() -> Path: + return memory_core.data_dir() / "telemetry-salt" + + +def _install_salt() -> str: + """Random per-install salt, created once and memoized for the process. + + Deliberately its own file, claimed with O_CREAT|O_EXCL, rather than a key in + the identity file. Three reasons, all of which produced wrong data when this + lived in the identity dict: + + - Hooks are short-lived separate processes firing on every tool call, and + people run more than one agent window. A read-modify-write would let each + process mint its own salt, so one repository would hash several ways in the + window before a writer won. + - resolve_distinct_id holds a copy of the identity dict across a network call + to /v1/ping/, so whichever write landed second erased the other's key — + losing either the salt (repo_hash changes mid-stream) or the email (a + second $identify, splitting the person). + - Touching the identity file from record() would create it, and is_first_run + keys off that file, so recording an event would silently suppress the + install event. + + Published atomically, and there is deliberately no derived fallback. Creating + the file with O_CREAT|O_EXCL and then writing into it leaves a window where + the file exists and is empty, and a concurrent hook that reads it in that + window gets nothing. Falling back to a digest of the path would hand that + process a salt an attacker can compute, memoized for its whole run, which is + the privacy control this function exists to provide silently turning itself + off under load. The salt is written to a private temp file first and linked + into place, so the name either does not exist or already has the full value. + + Returns "" when it genuinely cannot persist. Callers omit the hash entirely + rather than emit an unsalted one. + """ + global _salt_cache + if _salt_cache: + return _salt_cache + + path = _salt_path() + # Read before writing. Hooks are separate processes firing on every tool + # call, so all but the first find the salt already published; going straight + # to create-fsync-link-unlink meant every one of them paid an fsync to + # discover that, on a path whose whole promise is appending a line and + # returning. + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + if _salt_cache: + return _salt_cache + except OSError: + pass + + temporary = path.with_name(f"{path.name}.{os.getpid()}.tmp") + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(temporary, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(handle, "w", encoding="utf-8") as stream: + stream.write(uuid.uuid4().hex) + stream.flush() + os.fsync(stream.fileno()) + try: + # Atomic claim: fails if another process already published one. + # os.link rather than replace, which would clobber theirs. + os.link(temporary, path) + except FileExistsError: + pass + except OSError: + # No hardlinks here (some network mounts, some container volumes). + # Claim the name directly instead. That reopens the empty-file + # window, but the window is now benign: a reader that lands in it + # gets "" and omits the hash for that process rather than caching a + # guessable one. Losing the hashes on every run of an entire + # filesystem is the worse failure. + try: + fallback = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(fallback, "w", encoding="utf-8") as stream: + stream.write(temporary.read_text(encoding="utf-8")) + except OSError: + pass + except OSError: + pass + finally: + try: + temporary.unlink() + except OSError: + pass + + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + except OSError: + _salt_cache = "" + return _salt_cache + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + + Returns "" when there is no salt, so record() omits the property. An + unsalted digest over this input space is close to plaintext, and emitting one + under a name that implies it is hashed is worse than sending nothing. + """ + if not value: + return "" + salt = _install_salt() + if not salt: + return "" + return hashlib.sha256(f"{salt}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -174,10 +297,17 @@ def record( os=sys.platform, python_version=platform.python_version(), ) + # Assigned only when the digest is real. _scoped_digest returns "" when + # the salt could not be persisted, and an empty property is worse than an + # absent one: it survives the None filter below and reads as a value. if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + repo_hash = _scoped_digest(getattr(repo, "identity", "")) + if repo_hash: + properties["repo_hash"] = repo_hash if session_id: - properties["session_hash"] = _digest(session_id) + session_hash = _scoped_digest(session_id) + if session_hash: + properties["session_hash"] = session_hash line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", diff --git a/integrations/codex-plugin/skills/pause/SKILL.md b/integrations/codex-plugin/skills/pause/SKILL.md index d8a52f47b..c8f8ddd5f 100644 --- a/integrations/codex-plugin/skills/pause/SKILL.md +++ b/integrations/codex-plugin/skills/pause/SKILL.md @@ -7,8 +7,8 @@ disable-model-invocation: true # Pause memory capture To pause (hooks stop capturing and sending session content; a minimal -anonymous telemetry ping still fires at session start unless -`MEM0_TELEMETRY=false`): +telemetry ping still fires at session start, under your Mem0 account email, +unless `MEM0_TELEMETRY=false`): ```bash python3 "${PLUGIN_ROOT}/core/memory_cli.py" --harness "codex" --plugin-data-dir "${PLUGIN_DATA}" pause diff --git a/integrations/cursor-plugin/core/telemetry.py b/integrations/cursor-plugin/core/telemetry.py index 249595475..132de5b0c 100644 --- a/integrations/cursor-plugin/core/telemetry.py +++ b/integrations/cursor-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,6 +34,7 @@ from typing import Any import memory_core +_salt_cache: str = "" _harness: str = "generic" _source_tag: str = "MEM0_PLUGIN" _PRIVATE_KEYS = { @@ -83,9 +89,126 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _salt_path() -> Path: + return memory_core.data_dir() / "telemetry-salt" + + +def _install_salt() -> str: + """Random per-install salt, created once and memoized for the process. + + Deliberately its own file, claimed with O_CREAT|O_EXCL, rather than a key in + the identity file. Three reasons, all of which produced wrong data when this + lived in the identity dict: + + - Hooks are short-lived separate processes firing on every tool call, and + people run more than one agent window. A read-modify-write would let each + process mint its own salt, so one repository would hash several ways in the + window before a writer won. + - resolve_distinct_id holds a copy of the identity dict across a network call + to /v1/ping/, so whichever write landed second erased the other's key — + losing either the salt (repo_hash changes mid-stream) or the email (a + second $identify, splitting the person). + - Touching the identity file from record() would create it, and is_first_run + keys off that file, so recording an event would silently suppress the + install event. + + Published atomically, and there is deliberately no derived fallback. Creating + the file with O_CREAT|O_EXCL and then writing into it leaves a window where + the file exists and is empty, and a concurrent hook that reads it in that + window gets nothing. Falling back to a digest of the path would hand that + process a salt an attacker can compute, memoized for its whole run, which is + the privacy control this function exists to provide silently turning itself + off under load. The salt is written to a private temp file first and linked + into place, so the name either does not exist or already has the full value. + + Returns "" when it genuinely cannot persist. Callers omit the hash entirely + rather than emit an unsalted one. + """ + global _salt_cache + if _salt_cache: + return _salt_cache + + path = _salt_path() + # Read before writing. Hooks are separate processes firing on every tool + # call, so all but the first find the salt already published; going straight + # to create-fsync-link-unlink meant every one of them paid an fsync to + # discover that, on a path whose whole promise is appending a line and + # returning. + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + if _salt_cache: + return _salt_cache + except OSError: + pass + + temporary = path.with_name(f"{path.name}.{os.getpid()}.tmp") + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(temporary, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(handle, "w", encoding="utf-8") as stream: + stream.write(uuid.uuid4().hex) + stream.flush() + os.fsync(stream.fileno()) + try: + # Atomic claim: fails if another process already published one. + # os.link rather than replace, which would clobber theirs. + os.link(temporary, path) + except FileExistsError: + pass + except OSError: + # No hardlinks here (some network mounts, some container volumes). + # Claim the name directly instead. That reopens the empty-file + # window, but the window is now benign: a reader that lands in it + # gets "" and omits the hash for that process rather than caching a + # guessable one. Losing the hashes on every run of an entire + # filesystem is the worse failure. + try: + fallback = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(fallback, "w", encoding="utf-8") as stream: + stream.write(temporary.read_text(encoding="utf-8")) + except OSError: + pass + except OSError: + pass + finally: + try: + temporary.unlink() + except OSError: + pass + + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + except OSError: + _salt_cache = "" + return _salt_cache + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + + Returns "" when there is no salt, so record() omits the property. An + unsalted digest over this input space is close to plaintext, and emitting one + under a name that implies it is hashed is worse than sending nothing. + """ + if not value: + return "" + salt = _install_salt() + if not salt: + return "" + return hashlib.sha256(f"{salt}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -174,10 +297,17 @@ def record( os=sys.platform, python_version=platform.python_version(), ) + # Assigned only when the digest is real. _scoped_digest returns "" when + # the salt could not be persisted, and an empty property is worse than an + # absent one: it survives the None filter below and reads as a value. if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + repo_hash = _scoped_digest(getattr(repo, "identity", "")) + if repo_hash: + properties["repo_hash"] = repo_hash if session_id: - properties["session_hash"] = _digest(session_id) + session_hash = _scoped_digest(session_id) + if session_hash: + properties["session_hash"] = session_hash line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", diff --git a/integrations/cursor-plugin/skills/pause/SKILL.md b/integrations/cursor-plugin/skills/pause/SKILL.md index 634385145..17384c368 100644 --- a/integrations/cursor-plugin/skills/pause/SKILL.md +++ b/integrations/cursor-plugin/skills/pause/SKILL.md @@ -7,8 +7,8 @@ disable-model-invocation: true # Pause memory capture To pause (hooks stop capturing and sending session content; a minimal -anonymous telemetry ping still fires at session start unless -`MEM0_TELEMETRY=false`): +telemetry ping still fires at session start, under your Mem0 account email, +unless `MEM0_TELEMETRY=false`): ```bash python3 "${CURSOR_PLUGIN_ROOT}/core/memory_cli.py" --harness "cursor" pause diff --git a/integrations/deepseek-plugin/README.md b/integrations/deepseek-plugin/README.md index 93e5f563f..d5cb3345a 100644 --- a/integrations/deepseek-plugin/README.md +++ b/integrations/deepseek-plugin/README.md @@ -86,9 +86,9 @@ Per-call `userId` overrides are rejected unless the operator enables `allowUserO ## Telemetry -Writes are tagged `source="DEEPSEEK_HARNESS"` so Mem0's backend can attribute usage to this integration. For it to surface by name (rather than bucketing into `OTHERS`), `DEEPSEEK_HARNESS` must be present in the backend's `KNOWN_EVENT_SOURCES` allowlist, a one-line platform change matching the existing `ZAPIER` / `STRANDS` sources. +Writes are tagged `source="DEEPSEEK_HARNESS"`. That value has to exist in the backend's `EventSource` enum for usage to surface by name; until it does, these writes read as `OTHERS`. It is added by [mem0ai/platform#3602](https://github.com/mem0ai/platform/pull/3602), which has to ship before this claim is true. -The plugin also sends anonymous usage events (which tool ran, duration, result counts, coarse failure kind) so Mem0 can tell how the plugin is used and where it breaks. Queries, memory text, and entity ids are never sent. Turn it off with `MEM0_TELEMETRY=false`. +The plugin also sends usage events (which tool ran, duration, result counts, coarse failure kind) so Mem0 can tell how the plugin is used and where it breaks. These are **not anonymous**: when an API key is configured they are sent under your Mem0 account email, the same way the SDK attributes its own. Queries, memory text, and entity ids are never sent. Turn it off with `MEM0_TELEMETRY=false`. ## Status diff --git a/integrations/deepseek-plugin/src/index.ts b/integrations/deepseek-plugin/src/index.ts index bea70c02c..2d24b498a 100644 --- a/integrations/deepseek-plugin/src/index.ts +++ b/integrations/deepseek-plugin/src/index.ts @@ -26,10 +26,8 @@ export const name = "mem0"; export const inject = ["tools", "systemPrompt"]; // Tags writes so Mem0's backend attributes them to this integration in -// telemetry. The backend keeps recognized values via its KNOWN_EVENT_SOURCES -// allowlist; unknown values bucket into "OTHERS", so "DEEPSEEK_HARNESS" must be -// added to that allowlist for usage to surface by name (a one-line backend PR, -// same pattern as the ZAPIER / STRANDS sources). +// telemetry. The backend's KNOWN_EVENT_SOURCES allowlist recognizes this value; +// anything outside it buckets into "OTHERS". const SOURCE = "DEEPSEEK_HARNESS"; const DEFAULT_SEARCH_LIMIT = 10; diff --git a/integrations/kimi-plugin/core/telemetry.py b/integrations/kimi-plugin/core/telemetry.py index 249595475..132de5b0c 100644 --- a/integrations/kimi-plugin/core/telemetry.py +++ b/integrations/kimi-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,6 +34,7 @@ from typing import Any import memory_core +_salt_cache: str = "" _harness: str = "generic" _source_tag: str = "MEM0_PLUGIN" _PRIVATE_KEYS = { @@ -83,9 +89,126 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _salt_path() -> Path: + return memory_core.data_dir() / "telemetry-salt" + + +def _install_salt() -> str: + """Random per-install salt, created once and memoized for the process. + + Deliberately its own file, claimed with O_CREAT|O_EXCL, rather than a key in + the identity file. Three reasons, all of which produced wrong data when this + lived in the identity dict: + + - Hooks are short-lived separate processes firing on every tool call, and + people run more than one agent window. A read-modify-write would let each + process mint its own salt, so one repository would hash several ways in the + window before a writer won. + - resolve_distinct_id holds a copy of the identity dict across a network call + to /v1/ping/, so whichever write landed second erased the other's key — + losing either the salt (repo_hash changes mid-stream) or the email (a + second $identify, splitting the person). + - Touching the identity file from record() would create it, and is_first_run + keys off that file, so recording an event would silently suppress the + install event. + + Published atomically, and there is deliberately no derived fallback. Creating + the file with O_CREAT|O_EXCL and then writing into it leaves a window where + the file exists and is empty, and a concurrent hook that reads it in that + window gets nothing. Falling back to a digest of the path would hand that + process a salt an attacker can compute, memoized for its whole run, which is + the privacy control this function exists to provide silently turning itself + off under load. The salt is written to a private temp file first and linked + into place, so the name either does not exist or already has the full value. + + Returns "" when it genuinely cannot persist. Callers omit the hash entirely + rather than emit an unsalted one. + """ + global _salt_cache + if _salt_cache: + return _salt_cache + + path = _salt_path() + # Read before writing. Hooks are separate processes firing on every tool + # call, so all but the first find the salt already published; going straight + # to create-fsync-link-unlink meant every one of them paid an fsync to + # discover that, on a path whose whole promise is appending a line and + # returning. + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + if _salt_cache: + return _salt_cache + except OSError: + pass + + temporary = path.with_name(f"{path.name}.{os.getpid()}.tmp") + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(temporary, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(handle, "w", encoding="utf-8") as stream: + stream.write(uuid.uuid4().hex) + stream.flush() + os.fsync(stream.fileno()) + try: + # Atomic claim: fails if another process already published one. + # os.link rather than replace, which would clobber theirs. + os.link(temporary, path) + except FileExistsError: + pass + except OSError: + # No hardlinks here (some network mounts, some container volumes). + # Claim the name directly instead. That reopens the empty-file + # window, but the window is now benign: a reader that lands in it + # gets "" and omits the hash for that process rather than caching a + # guessable one. Losing the hashes on every run of an entire + # filesystem is the worse failure. + try: + fallback = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(fallback, "w", encoding="utf-8") as stream: + stream.write(temporary.read_text(encoding="utf-8")) + except OSError: + pass + except OSError: + pass + finally: + try: + temporary.unlink() + except OSError: + pass + + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + except OSError: + _salt_cache = "" + return _salt_cache + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + + Returns "" when there is no salt, so record() omits the property. An + unsalted digest over this input space is close to plaintext, and emitting one + under a name that implies it is hashed is worse than sending nothing. + """ + if not value: + return "" + salt = _install_salt() + if not salt: + return "" + return hashlib.sha256(f"{salt}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -174,10 +297,17 @@ def record( os=sys.platform, python_version=platform.python_version(), ) + # Assigned only when the digest is real. _scoped_digest returns "" when + # the salt could not be persisted, and an empty property is worse than an + # absent one: it survives the None filter below and reads as a value. if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + repo_hash = _scoped_digest(getattr(repo, "identity", "")) + if repo_hash: + properties["repo_hash"] = repo_hash if session_id: - properties["session_hash"] = _digest(session_id) + session_hash = _scoped_digest(session_id) + if session_hash: + properties["session_hash"] = session_hash line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", diff --git a/integrations/kimi-plugin/skills/pause/SKILL.md b/integrations/kimi-plugin/skills/pause/SKILL.md index 9f217a468..8f93e3bf7 100644 --- a/integrations/kimi-plugin/skills/pause/SKILL.md +++ b/integrations/kimi-plugin/skills/pause/SKILL.md @@ -7,8 +7,8 @@ disable-model-invocation: true # Pause memory capture To pause (hooks stop capturing and sending session content; a minimal -anonymous telemetry ping still fires at session start unless -`MEM0_TELEMETRY=false`): +telemetry ping still fires at session start, under your Mem0 account email, +unless `MEM0_TELEMETRY=false`): ```bash python3 "${KIMI_PLUGIN_ROOT}/core/memory_cli.py" --harness "kimi" pause diff --git a/integrations/mem0-agent-plugin/core/telemetry.py b/integrations/mem0-agent-plugin/core/telemetry.py index 249595475..132de5b0c 100644 --- a/integrations/mem0-agent-plugin/core/telemetry.py +++ b/integrations/mem0-agent-plugin/core/telemetry.py @@ -1,5 +1,9 @@ #!/usr/bin/env python3 -"""Anonymous usage telemetry for Mem0 agent plugins. +"""Usage telemetry for Mem0 agent plugins. + +Events are linked to your Mem0 account email when an API key is configured, and +to a random per-machine id otherwise. Not anonymous — the Python SDK and CLI +attribute the same way. Hooks run on a 3-6 second budget and fire on every tool call, so recording never touches the network: `record` appends one JSON line to a local spool and returns. @@ -9,7 +13,8 @@ started once per session and again from the flush worker that is already detache Pure stdlib, matching the rest of the plugin. Opt out with MEM0_TELEMETRY=false. Never sends prompts, memory text, queries, file paths, repository names, or API -keys: only event names, durations, counts, coarse outcomes, and salted hashes. +keys: only event names, durations, counts, coarse outcomes, and repo/session +identifiers hashed with a random per-install salt. """ from __future__ import annotations @@ -29,6 +34,7 @@ from typing import Any import memory_core +_salt_cache: str = "" _harness: str = "generic" _source_tag: str = "MEM0_PLUGIN" _PRIVATE_KEYS = { @@ -83,9 +89,126 @@ def is_enabled() -> bool: def _digest(value: str, length: int = 16) -> str: + """Unsalted digest. Only for values that are already secrets (API keys).""" return hashlib.sha256(value.encode("utf-8")).hexdigest()[:length] +def _salt_path() -> Path: + return memory_core.data_dir() / "telemetry-salt" + + +def _install_salt() -> str: + """Random per-install salt, created once and memoized for the process. + + Deliberately its own file, claimed with O_CREAT|O_EXCL, rather than a key in + the identity file. Three reasons, all of which produced wrong data when this + lived in the identity dict: + + - Hooks are short-lived separate processes firing on every tool call, and + people run more than one agent window. A read-modify-write would let each + process mint its own salt, so one repository would hash several ways in the + window before a writer won. + - resolve_distinct_id holds a copy of the identity dict across a network call + to /v1/ping/, so whichever write landed second erased the other's key — + losing either the salt (repo_hash changes mid-stream) or the email (a + second $identify, splitting the person). + - Touching the identity file from record() would create it, and is_first_run + keys off that file, so recording an event would silently suppress the + install event. + + Published atomically, and there is deliberately no derived fallback. Creating + the file with O_CREAT|O_EXCL and then writing into it leaves a window where + the file exists and is empty, and a concurrent hook that reads it in that + window gets nothing. Falling back to a digest of the path would hand that + process a salt an attacker can compute, memoized for its whole run, which is + the privacy control this function exists to provide silently turning itself + off under load. The salt is written to a private temp file first and linked + into place, so the name either does not exist or already has the full value. + + Returns "" when it genuinely cannot persist. Callers omit the hash entirely + rather than emit an unsalted one. + """ + global _salt_cache + if _salt_cache: + return _salt_cache + + path = _salt_path() + # Read before writing. Hooks are separate processes firing on every tool + # call, so all but the first find the salt already published; going straight + # to create-fsync-link-unlink meant every one of them paid an fsync to + # discover that, on a path whose whole promise is appending a line and + # returning. + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + if _salt_cache: + return _salt_cache + except OSError: + pass + + temporary = path.with_name(f"{path.name}.{os.getpid()}.tmp") + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(temporary, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(handle, "w", encoding="utf-8") as stream: + stream.write(uuid.uuid4().hex) + stream.flush() + os.fsync(stream.fileno()) + try: + # Atomic claim: fails if another process already published one. + # os.link rather than replace, which would clobber theirs. + os.link(temporary, path) + except FileExistsError: + pass + except OSError: + # No hardlinks here (some network mounts, some container volumes). + # Claim the name directly instead. That reopens the empty-file + # window, but the window is now benign: a reader that lands in it + # gets "" and omits the hash for that process rather than caching a + # guessable one. Losing the hashes on every run of an entire + # filesystem is the worse failure. + try: + fallback = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + with os.fdopen(fallback, "w", encoding="utf-8") as stream: + stream.write(temporary.read_text(encoding="utf-8")) + except OSError: + pass + except OSError: + pass + finally: + try: + temporary.unlink() + except OSError: + pass + + try: + _salt_cache = path.read_text(encoding="utf-8").strip() + except OSError: + _salt_cache = "" + return _salt_cache + + +def _scoped_digest(value: str, length: int = 16) -> str: + """Salted digest for values drawn from a guessable space. + + repo.identity is a git remote URL, or ``local:`` when there is + no remote — which normally contains the account username. Sixteen unsalted + hex characters over that input space is enumerable, so this is not a + privacy control without the salt. Salting per install keeps every + within-account join the analytics actually use and gives up only + cross-machine joins on the same repository, which nothing computes. + + Returns "" when there is no salt, so record() omits the property. An + unsalted digest over this input space is close to plaintext, and emitting one + under a name that implies it is hashed is worse than sending nothing. + """ + if not value: + return "" + salt = _install_salt() + if not salt: + return "" + return hashlib.sha256(f"{salt}:{value}".encode("utf-8")).hexdigest()[:length] + + def _safe_value(value: Any) -> Any: if isinstance(value, str): return memory_core.redact(value) @@ -174,10 +297,17 @@ def record( os=sys.platform, python_version=platform.python_version(), ) + # Assigned only when the digest is real. _scoped_digest returns "" when + # the salt could not be persisted, and an empty property is worse than an + # absent one: it survives the None filter below and reads as a value. if repo is not None: - properties["repo_hash"] = _digest(getattr(repo, "identity", "")) + repo_hash = _scoped_digest(getattr(repo, "identity", "")) + if repo_hash: + properties["repo_hash"] = repo_hash if session_id: - properties["session_hash"] = _digest(session_id) + session_hash = _scoped_digest(session_id) + if session_hash: + properties["session_hash"] = session_hash line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", diff --git a/integrations/mem0-agent-plugin/skills/pause/SKILL.md b/integrations/mem0-agent-plugin/skills/pause/SKILL.md index c6316dd0b..a87d6c3ee 100644 --- a/integrations/mem0-agent-plugin/skills/pause/SKILL.md +++ b/integrations/mem0-agent-plugin/skills/pause/SKILL.md @@ -6,8 +6,8 @@ description: Pause Mem0 memory capture on this machine. Use when the user wants # Pause memory capture To pause (hooks stop capturing and sending session content; a minimal -anonymous telemetry ping still fires at session start unless -`MEM0_TELEMETRY=false`): +telemetry ping still fires at session start, under your Mem0 account email, +unless `MEM0_TELEMETRY=false`): ```bash python3 "${PLUGIN_ROOT}/core/memory_cli.py" --harness "coding-agent" pause diff --git a/integrations/mem0-strands/README.md b/integrations/mem0-strands/README.md index f45d98e44..8ea4ecacc 100644 --- a/integrations/mem0-strands/README.md +++ b/integrations/mem0-strands/README.md @@ -79,9 +79,11 @@ the tool share one Mem0 backend and namespace. ## Telemetry -The store sends anonymous usage events (store configuration, operation, duration, -result counts, coarse failure kind) over the Mem0 SDK's existing telemetry client, -tagged `source="STRANDS"`. Queries, memory text, message content, entity ids, and +The store sends usage events (store configuration, operation, duration, result +counts, coarse failure kind) over the Mem0 SDK's existing telemetry client, +tagged `source="STRANDS"`. These are **not anonymous**: when an API key is +configured they are sent under your Mem0 account email, the same way the SDK +attributes its own. Queries, memory text, message content, entity ids, and metadata are never sent. Turn it off with `MEM0_TELEMETRY=false`. ## Development diff --git a/integrations/zapier-mem0/README.md b/integrations/zapier-mem0/README.md index 7b3f5ed0f..dab21d3f3 100644 --- a/integrations/zapier-mem0/README.md +++ b/integrations/zapier-mem0/README.md @@ -32,7 +32,7 @@ pnpm test:unit # offline unit tests (mocked, no network) MEM0_API_KEY=m0-... pnpm test # unit + live E2E against api.mem0.ai ``` -Anonymous usage telemetry is sent to Mem0; opt out with `MEM0_TELEMETRY=false`. +This app sends no telemetry of its own. Its API requests carry `source: "ZAPIER"` so Mem0 can see aggregate usage of the integration. To deploy (maintainers): `pnpm build && zapier push`. From 012cd32c3a5a8d1cbd3eccc3f71a62fa29e9ff26 Mon Sep 17 00:00:00 2001 From: Saket Aryan Date: Fri, 18 Sep 2026 13:42:34 +0530 Subject: [PATCH 09/55] fix(plugins): report the plugin that produced the event, not the one that sent it (#7323) --- integrations/agent-plugin-core/build/build.py | 28 +++ .../agent-plugin-core/python/telemetry.py | 42 +++- .../tests/test_uninitialised_identity.py | 179 ++++++++++++++++++ .../antigravity-plugin/core/_harness_id.py | 9 + .../antigravity-plugin/core/telemetry.py | 42 +++- .../claude-code-plugin/core/_harness_id.py | 9 + .../claude-code-plugin/core/telemetry.py | 42 +++- integrations/codex-plugin/core/_harness_id.py | 9 + integrations/codex-plugin/core/telemetry.py | 42 +++- .../cursor-plugin/core/_harness_id.py | 9 + integrations/cursor-plugin/core/telemetry.py | 42 +++- integrations/kimi-plugin/core/_harness_id.py | 9 + integrations/kimi-plugin/core/telemetry.py | 42 +++- .../mem0-agent-plugin/core/_harness_id.py | 9 + .../mem0-agent-plugin/core/telemetry.py | 42 +++- 15 files changed, 520 insertions(+), 35 deletions(-) create mode 100644 integrations/agent-plugin-core/tests/test_uninitialised_identity.py create mode 100644 integrations/antigravity-plugin/core/_harness_id.py create mode 100644 integrations/claude-code-plugin/core/_harness_id.py create mode 100644 integrations/codex-plugin/core/_harness_id.py create mode 100644 integrations/cursor-plugin/core/_harness_id.py create mode 100644 integrations/kimi-plugin/core/_harness_id.py create mode 100644 integrations/mem0-agent-plugin/core/_harness_id.py diff --git a/integrations/agent-plugin-core/build/build.py b/integrations/agent-plugin-core/build/build.py index 7a72e5c51..e675efb02 100644 --- a/integrations/agent-plugin-core/build/build.py +++ b/integrations/agent-plugin-core/build/build.py @@ -81,6 +81,28 @@ def replace_output(staged: Path, output: Path) -> Path: return output +def _render_harness_id(host: str) -> str: + """Emit core/_harness_id.py for one host. + + Carries both vocabularies from a single definition: the PostHog `source` tag + and the platform's X-Mem0-Source / X-Application pair. Keeping them together + is what stops the two from drifting into separate vocabularies for the same + thing. + """ + tag = host.upper().replace("-", "_") + "_PLUGIN" + return ( + '"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit."""\n' + "\n" + f'HARNESS_ID = "{host}"\n' + f'SOURCE_TAG = "{tag}"\n' + "\n" + "# Platform-side vocabulary (mem0_event.source + X-Application). The whole\n" + "# plugin family is one source; which editor it runs in is the application.\n" + 'PLATFORM_SOURCE = "MEM0_PLUGIN"\n' + f'PLATFORM_APPLICATION = "{host}"\n' + ) + + def _bundle_python( staged: Path, host: str, @@ -96,6 +118,12 @@ def _bundle_python( continue shutil.copy2(source, core / source.name) + # Generated per host so identity does not depend on an entrypoint remembering + # to call telemetry.init(). mcp_server.py and the detached telemetry.py sender + # never did, which is how MCP searches reported harness=generic and every + # batch they drained was labelled MEM0_PLUGIN regardless of the real host. + (core / "_harness_id.py").write_text(_render_harness_id(host), encoding="utf-8") + values = { "PLUGIN_ROOT": plugin_root, "PLUGIN_DATA": "${PLUGIN_DATA}", diff --git a/integrations/agent-plugin-core/python/telemetry.py b/integrations/agent-plugin-core/python/telemetry.py index 132de5b0c..6d7aeecae 100644 --- a/integrations/agent-plugin-core/python/telemetry.py +++ b/integrations/agent-plugin-core/python/telemetry.py @@ -34,9 +34,24 @@ from typing import Any import memory_core +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + _salt_cache: str = "" -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -62,10 +77,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -291,8 +315,13 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), @@ -311,6 +340,7 @@ def record( line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -496,6 +526,8 @@ def flush() -> int: "distinct_id": distinct_id, "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, diff --git a/integrations/agent-plugin-core/tests/test_uninitialised_identity.py b/integrations/agent-plugin-core/tests/test_uninitialised_identity.py new file mode 100644 index 000000000..14f911bee --- /dev/null +++ b/integrations/agent-plugin-core/tests/test_uninitialised_identity.py @@ -0,0 +1,179 @@ +"""Core telemetry behaviour with NO telemetry.init(), in a real subprocess. + +Why this file exists +-------------------- +``telemetry.py`` lives in ``agent-plugin-core/python/`` but its only tests lived +under ``claude-code-plugin/tests/``, behind a ``conftest.py`` that calls +``configure_harness()`` and ``telemetry.init()`` at import. Core behaviour was +therefore only ever exercised inside an already-configured module. + +Two processes in the real pipeline never call ``init()``: + +- ``mcp_server.py``, which records every manual search; +- the detached ``python3 telemetry.py`` sender that ``spawn_flush()`` starts at + session start, after every skill command, and when the MCP server exits. + +Both fell back to module defaults, so MCP searches reported ``harness=generic`` +and everything that sender delivered was labelled ``MEM0_PLUGIN`` regardless of +which of the six plugins produced it. The suite stayed green throughout. + +These tests run in a fresh interpreter with no conftest, against a built host +bundle, which is the only arrangement that can catch that class of bug. +""" + +from __future__ import annotations + +import json +import subprocess +import sys +import tempfile +from pathlib import Path + +import pytest + +CORE_ROOT = Path(__file__).resolve().parents[1] +REPOSITORY_ROOT = CORE_ROOT.parents[1] +HOSTS = { + "claude-code": ("claude-code-plugin", "CLAUDE_CODE_PLUGIN"), + "cursor": ("cursor-plugin", "CURSOR_PLUGIN"), + "codex": ("codex-plugin", "CODEX_PLUGIN"), + "kimi": ("kimi-plugin", "KIMI_PLUGIN"), + "antigravity": ("antigravity-plugin", "ANTIGRAVITY_PLUGIN"), + # Portable: no flush_worker and no hook_runner, so its ONLY sender is the + # uninitialised telemetry.py. A native-only test passes here vacuously. + "coding-agent": ("mem0-agent-plugin", "CODING_AGENT_PLUGIN"), +} + + +def _core_dir(directory: str) -> Path: + return REPOSITORY_ROOT / "integrations" / directory / "core" + + +def _run(core: Path, data_dir: Path, body: str) -> str: + """Execute `body` in a fresh interpreter with only the host's core on sys.path.""" + script = f"import sys; sys.path.insert(0, {str(core)!r})\n{body}" + result = subprocess.run( + [sys.executable, "-c", script], + capture_output=True, + text=True, + env={ + "MEM0_CODE_DATA_DIR": str(data_dir), + "PATH": "/usr/bin:/bin", + "HOME": str(data_dir), + }, + ) + assert result.returncode == 0, result.stderr + return result.stdout.strip() + + +@pytest.mark.parametrize("harness,spec", sorted(HOSTS.items())) +def test_identity_resolves_without_init(harness, spec): + """Every built host knows what it is with no configuration call at all.""" + directory, source_tag = spec + core = _core_dir(directory) + if not core.exists(): + pytest.skip(f"{directory} is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + out = _run( + core, + Path(tmp), + "import telemetry; print(telemetry._harness, telemetry._source_tag)", + ) + assert out == f"{harness} {source_tag}" + + +def test_mcp_server_records_the_real_harness(): + """mcp_server imports telemetry and never initialises it (server.py has no init). + + Its recorded events used to carry harness=generic for every plugin. + """ + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + data_dir = Path(tmp) + _run( + core, + data_dir, + "import mcp_server, telemetry; telemetry.record('search', trigger='mcp-search')", + ) + spooled = (data_dir / "telemetry.jsonl").read_text(encoding="utf-8").strip() + + event = json.loads(spooled) + assert event["properties"]["harness"] == "claude-code" + assert event["properties"]["source"] == "CLAUDE_CODE_PLUGIN" + + +def test_the_detached_sender_does_not_relabel_events(): + """`python3 telemetry.py` is the sender spawn_flush() starts, and never inits. + + source is stamped at record time now, so which process sends is irrelevant. + """ + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + data_dir = Path(tmp) + _run(core, data_dir, "import telemetry; telemetry.record('search')") + + captured = data_dir / "captured.json" + # Drain with a fresh, unconfigured interpreter, capturing the payload + # instead of posting it. + _run( + core, + data_dir, + "import json, telemetry\n" + "sent = []\n" + "telemetry._post = lambda payload, url: sent.append(payload) or True\n" + "telemetry.flush()\n" + f"open({str(captured)!r}, 'w').write(json.dumps(sent))", + ) + payloads = json.loads(captured.read_text(encoding="utf-8")) + + batches = [p for p in payloads if "batch" in p] + assert batches, "nothing was sent" + properties = batches[0]["batch"][0]["properties"] + assert properties["source"] == "CLAUDE_CODE_PLUGIN" + assert properties["harness"] == "claude-code" + + +def test_every_event_carries_a_uuid_for_dedupe(): + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + data_dir = Path(tmp) + _run(core, data_dir, "import telemetry; telemetry.record('search'); telemetry.record('flush')") + lines = (data_dir / "telemetry.jsonl").read_text(encoding="utf-8").strip().splitlines() + + ids = [json.loads(line)["uuid"] for line in lines] + assert len(ids) == 2 + assert len(set(ids)) == 2 + + +def test_source_tag_defaults_agree_between_the_two_modules(): + """configure_harness and telemetry.init must derive the same tag. + + They disagreed: `_plugin` in one and `MEM0__PLUGIN` in the other, + so one plugin could emit three different source values depending on which + process sent the batch. + """ + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + out = _run( + core, + Path(tmp), + "import memory_core, telemetry\n" + "memory_core.configure_harness('kimi')\n" + "telemetry.init(harness='kimi')\n" + "print(memory_core.harness_config()['source_tag'].upper(), telemetry._source_tag)", + ) + left, right = out.split() + assert left == right == "KIMI_PLUGIN" diff --git a/integrations/antigravity-plugin/core/_harness_id.py b/integrations/antigravity-plugin/core/_harness_id.py new file mode 100644 index 000000000..2c8a515f4 --- /dev/null +++ b/integrations/antigravity-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "antigravity" +SOURCE_TAG = "ANTIGRAVITY_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "antigravity" diff --git a/integrations/antigravity-plugin/core/telemetry.py b/integrations/antigravity-plugin/core/telemetry.py index 132de5b0c..6d7aeecae 100644 --- a/integrations/antigravity-plugin/core/telemetry.py +++ b/integrations/antigravity-plugin/core/telemetry.py @@ -34,9 +34,24 @@ from typing import Any import memory_core +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + _salt_cache: str = "" -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -62,10 +77,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -291,8 +315,13 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), @@ -311,6 +340,7 @@ def record( line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -496,6 +526,8 @@ def flush() -> int: "distinct_id": distinct_id, "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, diff --git a/integrations/claude-code-plugin/core/_harness_id.py b/integrations/claude-code-plugin/core/_harness_id.py new file mode 100644 index 000000000..6c3e1ce15 --- /dev/null +++ b/integrations/claude-code-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "claude-code" +SOURCE_TAG = "CLAUDE_CODE_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "claude-code" diff --git a/integrations/claude-code-plugin/core/telemetry.py b/integrations/claude-code-plugin/core/telemetry.py index 132de5b0c..6d7aeecae 100644 --- a/integrations/claude-code-plugin/core/telemetry.py +++ b/integrations/claude-code-plugin/core/telemetry.py @@ -34,9 +34,24 @@ from typing import Any import memory_core +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + _salt_cache: str = "" -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -62,10 +77,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -291,8 +315,13 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), @@ -311,6 +340,7 @@ def record( line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -496,6 +526,8 @@ def flush() -> int: "distinct_id": distinct_id, "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, diff --git a/integrations/codex-plugin/core/_harness_id.py b/integrations/codex-plugin/core/_harness_id.py new file mode 100644 index 000000000..152313a21 --- /dev/null +++ b/integrations/codex-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "codex" +SOURCE_TAG = "CODEX_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "codex" diff --git a/integrations/codex-plugin/core/telemetry.py b/integrations/codex-plugin/core/telemetry.py index 132de5b0c..6d7aeecae 100644 --- a/integrations/codex-plugin/core/telemetry.py +++ b/integrations/codex-plugin/core/telemetry.py @@ -34,9 +34,24 @@ from typing import Any import memory_core +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + _salt_cache: str = "" -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -62,10 +77,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -291,8 +315,13 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), @@ -311,6 +340,7 @@ def record( line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -496,6 +526,8 @@ def flush() -> int: "distinct_id": distinct_id, "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, diff --git a/integrations/cursor-plugin/core/_harness_id.py b/integrations/cursor-plugin/core/_harness_id.py new file mode 100644 index 000000000..40241a7f4 --- /dev/null +++ b/integrations/cursor-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "cursor" +SOURCE_TAG = "CURSOR_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "cursor" diff --git a/integrations/cursor-plugin/core/telemetry.py b/integrations/cursor-plugin/core/telemetry.py index 132de5b0c..6d7aeecae 100644 --- a/integrations/cursor-plugin/core/telemetry.py +++ b/integrations/cursor-plugin/core/telemetry.py @@ -34,9 +34,24 @@ from typing import Any import memory_core +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + _salt_cache: str = "" -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -62,10 +77,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -291,8 +315,13 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), @@ -311,6 +340,7 @@ def record( line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -496,6 +526,8 @@ def flush() -> int: "distinct_id": distinct_id, "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, diff --git a/integrations/kimi-plugin/core/_harness_id.py b/integrations/kimi-plugin/core/_harness_id.py new file mode 100644 index 000000000..aa17750b1 --- /dev/null +++ b/integrations/kimi-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "kimi" +SOURCE_TAG = "KIMI_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "kimi" diff --git a/integrations/kimi-plugin/core/telemetry.py b/integrations/kimi-plugin/core/telemetry.py index 132de5b0c..6d7aeecae 100644 --- a/integrations/kimi-plugin/core/telemetry.py +++ b/integrations/kimi-plugin/core/telemetry.py @@ -34,9 +34,24 @@ from typing import Any import memory_core +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + _salt_cache: str = "" -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -62,10 +77,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -291,8 +315,13 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), @@ -311,6 +340,7 @@ def record( line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -496,6 +526,8 @@ def flush() -> int: "distinct_id": distinct_id, "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, diff --git a/integrations/mem0-agent-plugin/core/_harness_id.py b/integrations/mem0-agent-plugin/core/_harness_id.py new file mode 100644 index 000000000..b0836d6de --- /dev/null +++ b/integrations/mem0-agent-plugin/core/_harness_id.py @@ -0,0 +1,9 @@ +"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit.""" + +HARNESS_ID = "coding-agent" +SOURCE_TAG = "CODING_AGENT_PLUGIN" + +# Platform-side vocabulary (mem0_event.source + X-Application). The whole +# plugin family is one source; which editor it runs in is the application. +PLATFORM_SOURCE = "MEM0_PLUGIN" +PLATFORM_APPLICATION = "coding-agent" diff --git a/integrations/mem0-agent-plugin/core/telemetry.py b/integrations/mem0-agent-plugin/core/telemetry.py index 132de5b0c..6d7aeecae 100644 --- a/integrations/mem0-agent-plugin/core/telemetry.py +++ b/integrations/mem0-agent-plugin/core/telemetry.py @@ -34,9 +34,24 @@ from typing import Any import memory_core +# Seeded from the per-host module the build generates into core/. Two processes +# in this pipeline never call init() — mcp_server.py, and the detached +# `python3 telemetry.py` sender that spawn_flush() starts — so a module default +# was what every one of their events got labelled with. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import HARNESS_ID as _DEFAULT_HARNESS + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE + from _harness_id import SOURCE_TAG as _DEFAULT_SOURCE_TAG +except ImportError: + _DEFAULT_HARNESS = "generic" + _DEFAULT_SOURCE_TAG = "MEM0_PLUGIN" + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + _salt_cache: str = "" -_harness: str = "generic" -_source_tag: str = "MEM0_PLUGIN" +_harness: str = _DEFAULT_HARNESS +_source_tag: str = _DEFAULT_SOURCE_TAG _PRIVATE_KEYS = { "apikey", "authorization", @@ -62,10 +77,19 @@ _PRIVATE_KEYS = { } -def init(harness: str = "generic", source_tag: str = "") -> None: +def init(harness: str = "", source_tag: str = "") -> None: + """Override the generated identity. Optional — core/_harness_id.py is the default. + + The fallback shape matches memory_core.configure_harness's (``_PLUGIN``). + It used to be ``MEM0__PLUGIN`` here and ``_plugin`` there, which + meant one plugin could emit three different source values depending on which + process happened to send the batch. + """ global _harness, _source_tag - _harness = harness - _source_tag = source_tag or f"MEM0_{harness.upper().replace('-', '_')}_PLUGIN" + _harness = harness or _DEFAULT_HARNESS + _source_tag = source_tag or ( + f"{_harness.upper().replace('-', '_')}_PLUGIN" if harness else _DEFAULT_SOURCE_TAG + ) POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX" POSTHOG_CAPTURE_URL = "https://us.i.posthog.com/i/v0/e/" @@ -291,8 +315,13 @@ def record( except OSError: pass properties = _safe_value(properties) + # Stamped in the RECORDING process, beside harness. `source` used to be + # read in the sending process from a module global, so whichever process + # drained the spool named every event in it. flush() spreads per-event + # properties last, so this now wins over any sender's default. properties.update( harness=_harness, + source=_source_tag, plugin_version=memory_core.PLUGIN_VERSION, os=sys.platform, python_version=platform.python_version(), @@ -311,6 +340,7 @@ def record( line = json.dumps( { "event": f"{EVENT_PREFIX}.{event}", + "uuid": str(uuid.uuid4()), "timestamp": memory_core.utc_now(), "properties": { key: value for key, value in properties.items() if value is not None @@ -496,6 +526,8 @@ def flush() -> int: "distinct_id": distinct_id, "timestamp": event.get("timestamp"), "properties": { + # Fallback only: events recorded by a build before source + # moved into record() have none of their own. "source": _source_tag, "language": "python", "$process_person_profile": False, From 33629990956ca6336501deea2e9cd625e5fe09af Mon Sep 17 00:00:00 2001 From: Saket Aryan Date: Fri, 18 Sep 2026 13:43:33 +0530 Subject: [PATCH 10/55] fix(plugins): stop delivering telemetry events twice, and stop losing parked ones (#7324) --- .../agent-plugin-core/python/telemetry.py | 274 ++++++++++- .../tests/test_spool_delivery.py | 446 ++++++++++++++++++ .../antigravity-plugin/core/telemetry.py | 274 ++++++++++- .../claude-code-plugin/core/telemetry.py | 274 ++++++++++- .../tests/test_telemetry.py | 18 +- integrations/codex-plugin/core/telemetry.py | 274 ++++++++++- integrations/cursor-plugin/core/telemetry.py | 274 ++++++++++- integrations/kimi-plugin/core/telemetry.py | 274 ++++++++++- .../mem0-agent-plugin/core/telemetry.py | 274 ++++++++++- 9 files changed, 2243 insertions(+), 139 deletions(-) create mode 100644 integrations/agent-plugin-core/tests/test_spool_delivery.py diff --git a/integrations/agent-plugin-core/python/telemetry.py b/integrations/agent-plugin-core/python/telemetry.py index 6d7aeecae..a4375f002 100644 --- a/integrations/agent-plugin-core/python/telemetry.py +++ b/integrations/agent-plugin-core/python/telemetry.py @@ -100,6 +100,16 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 +# Added to the wait before a released claim becomes reclaimable, per attempt +# already spent. Releasing straight to "reclaimable now" let two senders burn the +# whole budget within seconds of one another on a single momentary failure, and +# discard a batch a retry a minute later would have delivered. +RETRY_COOLDOWN_SECONDS = 60 def is_enabled() -> bool: @@ -399,38 +409,201 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape. + + Anchored on field position, not on a leading "a": the legacy shape is + ``telemetry--.sending`` and a hex id such as ``a1234567`` would + otherwise parse as attempt 1234567 and be discarded unsent on the first + flush after an upgrade. + """ + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + parts = stem.split("-") + if len(parts) != 4: + return 0 + tail = parts[3] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _sweep_debris(directory: Path) -> None: + """Remove files nothing else will ever pick up again. + + *.partial is a temp file orphaned by a crash between write and rename. + *.corrupt is a batch quarantined for undecodable content. No glob in this + module matches either, so without this they accumulate on disk for the life + of the install. + + Quarantined batches are kept far longer than debris: they are the only + evidence left of events that could not be delivered, and someone diagnosing + a report of missing telemetry has to be able to find one. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for debris in directory.glob("telemetry-*.partial"): + try: + if now - debris.stat().st_mtime > CLAIM_STALE_SECONDS: + debris.unlink() + except OSError: + continue + for quarantined in directory.glob("telemetry-*.corrupt"): + try: + if now - quarantined.stat().st_mtime > CLAIM_EXPIRY_SECONDS: + quarantined.unlink() + except OSError: + continue + # The same reasoning covers *.tmp. _write_identity and _install_salt both + # create one and unlink it in a finally, which a SIGKILL skips, and no glob + # in this module matches the leftovers either. + for temporary in directory.glob("telemetry-*.tmp"): + try: + if now - temporary.stat().st_mtime > CLAIM_STALE_SECONDS: + temporary.unlink() + except OSError: + continue + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ + now = time.time() + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. This check has to come + # first. Claiming a file bumps its attempt count and refreshes its + # mtime, so a sender that has just taken the final attempt looks + # exhausted to everyone else while it is actively draining. Judging + # exhaustion before liveness let a second sender unlink a batch out + # from under its owner, losing every event in it. + continue + # Attempts, not age. Every re-claim touches the mtime and every release + # backdates it by a fixed amount, so age is pinned near the stale + # threshold and never reaches the expiry. Age stays only as a backstop + # for files that never carried an attempt marker. + if _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS or age > CLAIM_EXPIRY_SECONDS: try: orphan.unlink() except OSError: pass continue - if age < CLAIM_STALE_SECONDS: - continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + payload = "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining) + # fsync before the rename: without it the rename can land while the + # bytes have not, and the claim comes back empty or truncated after a + # crash. _drain then reads zero events and unlinks it. + with open(temporary, "w", encoding="utf-8") as handle: + handle.write(payload) + handle.flush() + os.fsync(handle.fileno()) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + # Backdate past the stale threshold so the next flush can pick it up, + # minus a cooldown that grows with the attempts already spent. Clamped so + # the mtime never lands in the future, which would read as a live lease. + cooldown = min(_claim_attempt(claim) * RETRY_COOLDOWN_SECONDS, CLAIM_STALE_SECONDS) + released = time.time() - CLAIM_STALE_SECONDS - 1 + cooldown + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -478,16 +651,61 @@ def resolve_distinct_id() -> tuple[str, str]: def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + _sweep_debris(directory) + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() + except ValueError: + # UnicodeDecodeError from a torn write: the content is unrecoverable, so + # quarantine rather than retry. flush() runs from a bare `finally:` in + # flush_worker, so raising here also skips the handoff cleanup, and an + # undecodable file would otherwise be re-read on every flush forever. + # Reported as delivered because there is nothing left to deliver and the + # rest of the run should continue. + try: + claim.replace(claim.with_suffix(".corrupt")) + except OSError: + try: + claim.unlink() + except OSError: + pass + return 0, True except OSError: - return 0 + # Could not read it, which is not the same as having nothing to send. + # The file is left exactly where it is: a vanished or briefly unreadable + # claim is retryable, and quarantining it here would discard events over + # a transient filesystem error. Reported as undelivered so the run stops + # instead of counting a batch nothing was posted from as delivered. + return 0, False events = [] for line in lines: try: @@ -497,11 +715,18 @@ def flush() -> int: if isinstance(value, dict) and value.get("event"): events.append(value) if not events: + # Only delete when the file really is empty. A non-empty file that + # parses to nothing is a torn write, and its contents are the unsent + # remainder — deleting it is the data loss this PR exists to prevent. try: - claim.unlink() + empty = claim.stat().st_size == 0 + except OSError: + empty = True + try: + claim.replace(claim.with_suffix(".corrupt")) if not empty else claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -520,10 +745,13 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { # Fallback only: events recorded by a build before source @@ -535,16 +763,24 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. If the + # rewrite fails the claim still holds delivered events, so stop rather + # than carry on as though progress were recorded — continuing is how the + # duplicate delivery this PR fixes would come back. + if not _rewrite_claim(claim, events[start + len(chunk) :]): + _release_claim(claim, events[start + len(chunk) :]) + return sent, False + return sent, True def main() -> int: diff --git a/integrations/agent-plugin-core/tests/test_spool_delivery.py b/integrations/agent-plugin-core/tests/test_spool_delivery.py new file mode 100644 index 000000000..accd631a6 --- /dev/null +++ b/integrations/agent-plugin-core/tests/test_spool_delivery.py @@ -0,0 +1,446 @@ +"""Delivery semantics of the telemetry spool: no duplicates, no starvation. + +These run against a built host's core in-process (not a subprocess) because they +need to inject failures into ``_post``. The identity tests next door cover the +uninitialised-process case that needs a real interpreter. +""" + +from __future__ import annotations + +import importlib +import json +import os +import sys +import time +from pathlib import Path + +import pytest + +CORE_ROOT = Path(__file__).resolve().parents[1] +REPOSITORY_ROOT = CORE_ROOT.parents[1] +HOST_CORE = REPOSITORY_ROOT / "integrations" / "claude-code-plugin" / "core" + +pytestmark = pytest.mark.skipif(not HOST_CORE.exists(), reason="claude-code-plugin is not built") + + +@pytest.fixture() +def telemetry(tmp_path, monkeypatch): + # CI runs this directory and claude-code-plugin/tests in ONE pytest process, + # and that suite's conftest sets MEM0_TELEMETRY=false at import, process-wide. + # Without this the whole file silently no-ops: record() returns early and + # every assertion sees an empty spool. Do not rely on ambient env. + monkeypatch.setenv("MEM0_TELEMETRY", "true") + monkeypatch.setenv("MEM0_CODE_DATA_DIR", str(tmp_path / "data")) + monkeypatch.syspath_prepend(str(HOST_CORE)) + + # Save and RESTORE rather than delete. claude-code-plugin/tests/conftest.py + # imports memory_core once at collection and calls configure_harness() on it; + # dropping the module left a later re-import with default harness config, so + # tests in that suite failed depending on collection order. + names = ("telemetry", "memory_core", "_harness_id") + saved = {name: sys.modules.get(name) for name in names} + for name in names: + sys.modules.pop(name, None) + + module = importlib.import_module("telemetry") + monkeypatch.setattr(module, "resolve_distinct_id", lambda: ("tester@example.com", "")) + try: + yield module + finally: + for name in names: + sys.modules.pop(name, None) + if saved[name] is not None: + sys.modules[name] = saved[name] + + +def _delivered(payloads): + return [event for payload in payloads if "batch" in payload for event in payload["batch"]] + + +def test_a_partial_failure_does_not_redeliver_what_already_arrived(telemetry): + """Defect 2a: flush kept the whole claim on failure and retried from the top. + + 150 events across two batches, the second failing, previously delivered 250. + """ + for index in range(150): + telemetry.record("search", index=index) + + sent: list[dict] = [] + calls = {"n": 0} + + def flaky(payload, url): + calls["n"] += 1 + if calls["n"] == 2: # second batch fails + return False + sent.append(payload) + return True + + telemetry._post = flaky + telemetry.flush() + + telemetry._post = lambda payload, url: sent.append(payload) or True + telemetry.flush() + + events = _delivered(sent) + assert len(events) == 150 + assert len({event["uuid"] for event in events}) == 150 + + +def test_a_fresh_claim_is_not_immediately_stealable(telemetry): + """Defect 2b: rename preserves mtime, so a claim inherited the spool's age. + + With the last write older than the stale threshold, a claim made now looked + abandoned the instant it existed and a second sender took it over. + """ + telemetry.record("search") + spool = telemetry._spool_path() + old = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(spool, (old, old)) + + first = telemetry._claim_spool() + assert first is not None + + # A second sender starting right now must find nothing to take. + assert telemetry._claim_parked(first.parent) is None + + +def test_a_live_final_attempt_is_not_deleted_by_another_sender(telemetry): + """Review finding: exhaustion was judged before liveness, so owners lost batches. + + Claiming a parked file bumps its attempt count and refreshes its mtime. Once + the count reaches the budget, the owner draining it looked exhausted to every + other sender, which unlinked the file out from under it. Everything in that + batch was gone, which is precisely the loss this PR exists to stop. + """ + telemetry.record("search", reason="owned-by-the-first-sender") + spool = telemetry._spool_path() + stale = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(spool, (stale, stale)) + + claim = telemetry._claim_spool() + assert claim is not None + + # Walk it to the final attempt, ageing it each round so it can be re-claimed. + # _claim_spool hands back a0 and _release_claim keeps the name, so it takes + # one full round per attempt to reach the budget. + for _ in range(telemetry.MAX_CLAIM_ATTEMPTS): + # Carry the marker through each rewrite so the final assertion proves the + # events survived, not merely that some file with the right name did. + telemetry._release_claim(claim, [{"event": "code.search", "uuid": "owned-by-the-first-sender"}]) + parked = sorted(claim.parent.glob("telemetry-*.sending")) + assert parked, "the batch was dropped while still inside its budget" + os.utime(parked[0], (stale, stale)) + claim = telemetry._claim_parked(claim.parent) + assert claim is not None + + assert telemetry._claim_attempt(claim) >= telemetry.MAX_CLAIM_ATTEMPTS + assert claim.exists() + + # The owner is draining it right now: fresh mtime, live lease. + second_sender = telemetry._claim_parked(claim.parent) + + assert second_sender is None, "a second sender took a batch under a live lease" + assert claim.exists(), "a second sender deleted a batch its owner was draining" + assert "owned-by-the-first-sender" in claim.read_text(encoding="utf-8") + + +def test_an_exhausted_batch_is_still_discarded_once_its_lease_lapses(telemetry): + """The liveness check must defer the cleanup, not cancel it. + + Guards the obvious over-correction: skipping live claims is only safe if an + abandoned one at the same attempt count is still reaped on a later run. + """ + telemetry.record("search") + spool = telemetry._spool_path() + stale = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(spool, (stale, stale)) + + claim = telemetry._claim_spool() + assert claim is not None + exhausted = claim.parent / telemetry._claim_name(telemetry.MAX_CLAIM_ATTEMPTS) + claim.replace(exhausted) + os.utime(exhausted, (stale, stale)) + + assert telemetry._claim_parked(exhausted.parent) is None + assert not exhausted.exists(), "an abandoned exhausted batch was left behind forever" + + +def test_a_parked_batch_is_drained_behind_the_live_spool(telemetry): + """Defect 6: parked claims were only reachable when no spool existed. + + Because sessions keep recording there usually was one, so a batch parked by + a failed send waited until the 7-day expiry deleted it unsent — even though + its own presence is what starts the sender. + """ + telemetry.record("parked") + telemetry._post = lambda payload, url: False + telemetry.flush() + + parked = list(telemetry.memory_core.data_dir().glob("telemetry-*.sending")) + assert len(parked) == 1 + old = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(parked[0], (old, old)) + + telemetry.record("fresh") + sent: list[dict] = [] + telemetry._post = lambda payload, url: sent.append(payload) or True + telemetry.flush() + + names = {event["event"] for event in _delivered(sent)} + assert names == {"code.parked", "code.fresh"} + + +def test_a_batch_is_retried_until_the_budget_is_spent_not_discarded(telemetry): + """Expiry discards what failed repeatedly, not what merely sat for a while. + + The budget is the attempt count, because age cannot be one: every re-claim + touches the mtime and every release backdates it, so age never accumulates. + """ + telemetry.record("parked") + telemetry._post = lambda payload, url: False + telemetry.flush() + + parked = list(telemetry.memory_core.data_dir().glob("telemetry-*.sending")) + assert len(parked) == 1 + assert telemetry._claim_attempt(parked[0]) < telemetry.MAX_CLAIM_ATTEMPTS + + sent: list[dict] = [] + telemetry._post = lambda payload, url: sent.append(payload) or True + telemetry.flush() + + assert [event["event"] for event in _delivered(sent)] == ["code.parked"] + + +def test_progress_is_recorded_after_every_batch(telemetry): + """A crash repeats at most one batch, not the whole file.""" + for index in range(250): + telemetry.record("search", index=index) + + calls = {"n": 0} + + def die_after_two(payload, url): + calls["n"] += 1 + if calls["n"] > 2: + return False + return True + + telemetry._post = die_after_two + telemetry.flush() + + parked = list(telemetry.memory_core.data_dir().glob("telemetry-*.sending")) + assert len(parked) == 1 + remaining = parked[0].read_text(encoding="utf-8").strip().splitlines() + # Two batches of 100 landed; only the last 50 should still be pending. + assert len(remaining) == 50 + assert json.loads(remaining[0])["properties"]["index"] == 200 + + +def test_the_heartbeat_actually_refreshes_the_lease(telemetry): + """The claim rewrite doubles as the lease heartbeat. + + Previously asserted `SEND_TIMEOUT * 4 < CLAIM_STALE_SECONDS`, which compares + two constants and executes none of the code under test. Drive the real + rewrite and watch the mtime move instead. + """ + for index in range(150): + telemetry.record("search", index=index) + claim = telemetry._claim_spool() + assert claim is not None + + stale = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(claim, (stale, stale)) + assert time.time() - claim.stat().st_mtime > telemetry.CLAIM_STALE_SECONDS + + telemetry._rewrite_claim(claim, [{"event": "code.x", "properties": {}}]) + assert time.time() - claim.stat().st_mtime < telemetry.CLAIM_STALE_SECONDS + + +def test_an_undeliverable_batch_is_eventually_given_up_on(telemetry): + """Expiry has to be reachable from a state the state machine can produce. + + It was not: every re-claim touched the mtime and every release backdated it + by a fixed amount, so age hovered near the stale threshold and the 7-day + expiry never fired. An undeliverable batch lived on disk forever, and + spawn_flush saw it and started a sender on every hook. + """ + telemetry.record("doomed") + telemetry._post = lambda payload, url: False + + directory = telemetry.memory_core.data_dir() + for _ in range(telemetry.MAX_CLAIM_ATTEMPTS + 3): + telemetry.flush() + # Attempts now carry a cooldown, so a released claim is not instantly + # reclaimable. Age it to stand in for the wall time a real retry waits; + # without this the loop spins inside one cooldown and proves nothing. + for parked in directory.glob("telemetry-*.sending"): + stale = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(parked, (stale, stale)) + + leftover = list(directory.glob("telemetry-*.sending")) + assert leftover == [], f"batch never given up on: {[p.name for p in leftover]}" + + +def test_a_batch_that_cannot_be_read_is_not_counted_as_delivered(telemetry): + """Review finding: a read failure reported 'everything delivered'. + + Nothing was posted, so calling it delivered lets flush() carry on to other + claims as though this batch had arrived, and hides the failure from the one + signal that says the run went badly. It also must not quarantine: a briefly + unreadable file is retryable, and moving it to .corrupt discards the events + over a transient filesystem error, because nothing ever re-globs .corrupt. + """ + telemetry.record("search") + spool = telemetry._spool_path() + stale = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(spool, (stale, stale)) + claim = telemetry._claim_spool() + assert claim is not None + + original = Path.read_text + + def unreadable(self, *args, **kwargs): + if self == claim: + raise OSError(5, "I/O error") + return original(self, *args, **kwargs) + + Path.read_text = unreadable + try: + sent, delivered = telemetry._drain(claim) + finally: + Path.read_text = original + + assert sent == 0 + assert delivered is False, "an unread batch was reported as delivered" + assert claim.exists(), "a transient read error discarded the batch" + assert not list(claim.parent.glob("*.corrupt")), "quarantined over a transient error" + + +def test_undecodable_content_is_still_quarantined_and_the_run_continues(telemetry): + """The other half: genuinely unrecoverable content must not block the run. + + Guards the over-correction. If every read problem returned undelivered, one + torn file would stop every later claim on every flush, forever. + """ + telemetry.record("search") + spool = telemetry._spool_path() + stale = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(spool, (stale, stale)) + claim = telemetry._claim_spool() + assert claim is not None + claim.write_bytes(b"\xff\xfe torn \x00 write") + + sent, delivered = telemetry._drain(claim) + + assert (sent, delivered) == (0, True) + assert not claim.exists() + assert list(claim.parent.glob("*.corrupt")), "unrecoverable content was not quarantined" + + +def test_retries_are_spread_over_real_time_not_burned_at_once(telemetry): + """Review finding: releasing straight to reclaimable spent the budget instantly. + + Two senders hitting one momentary failure could walk a batch from attempt 0 + to the limit within seconds and discard it, when a retry a minute later would + have delivered. Each release now has to age past a cooldown that grows with + the attempts already spent. + """ + telemetry.record("doomed") + telemetry._post = lambda payload, url: False + + directory = telemetry.memory_core.data_dir() + telemetry.flush() + + parked = list(directory.glob("telemetry-*.sending")) + assert parked, "the batch was discarded on its first failure" + assert telemetry._claim_attempt(parked[0]) == 0 + + # Second sender, immediately: the cooldown has not elapsed, so it must not + # be able to spend another attempt. + telemetry.flush() + still = list(directory.glob("telemetry-*.sending")) + assert len(still) == 1 + assert telemetry._claim_attempt(still[0]) <= 1, "burned attempts without waiting" + + +def test_a_legacy_claim_filename_is_not_mistaken_for_a_huge_attempt_count(telemetry): + """The old shape is telemetry--.sending, and hex can start with 'a'.""" + assert telemetry._claim_attempt(Path("telemetry-999-deadbeef.sending")) == 0 + assert telemetry._claim_attempt(Path("telemetry-999-a1234567.sending")) == 0 + assert telemetry._claim_attempt(Path("telemetry-999-deadbeef-a2.sending")) == 2 + + +def test_a_torn_claim_is_quarantined_not_deleted(telemetry): + """A non-empty file that parses to nothing is the remainder, not garbage.""" + telemetry.record("search") + claim = telemetry._claim_spool() + claim.write_bytes(b"\xff\xfe not utf-8 at all") + stale = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(claim, (stale, stale)) + + sent = telemetry.flush() + + assert sent == 0 + assert not claim.exists() + quarantined = list(telemetry.memory_core.data_dir().glob("*.corrupt")) + assert len(quarantined) == 1, "torn claim was destroyed instead of kept" + + +def test_a_failed_rewrite_stops_instead_of_redelivering(telemetry): + """Ignoring the rewrite result reintroduced the duplicates this PR fixes.""" + for index in range(250): + telemetry.record("search", index=index) + + telemetry._rewrite_claim = lambda claim, remaining: False + delivered = [] + telemetry._post = lambda payload, url: delivered.extend(payload.get("batch", [])) or True + + telemetry.flush() + assert len(delivered) == 100, f"kept going after a failed rewrite: {len(delivered)}" + + +def test_partial_files_are_swept(telemetry): + """Nothing else globs *.partial, so a crash mid-rename orphans one forever.""" + data_dir = telemetry.memory_core.data_dir() + data_dir.mkdir(parents=True, exist_ok=True) + debris = data_dir / "telemetry-1-abc-a0.1.partial" + debris.write_text("x", encoding="utf-8") + old = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(debris, (old, old)) + + telemetry.flush() + assert not debris.exists() + + +def test_quarantined_batches_are_eventually_collected(telemetry): + """Nothing re-globs .corrupt, so without a sweep they live on disk forever. + + Kept much longer than .partial debris on purpose: a quarantined batch is the + only remaining evidence of events that could not be delivered. + """ + directory = telemetry.memory_core.data_dir() + directory.mkdir(parents=True, exist_ok=True) + fresh = directory / "telemetry-1-aaaaaaaa-a0.corrupt" + old = directory / "telemetry-2-bbbbbbbb-a0.corrupt" + for path in (fresh, old): + path.write_text("torn", encoding="utf-8") + expired = time.time() - (telemetry.CLAIM_EXPIRY_SECONDS + 60) + os.utime(old, (expired, expired)) + + telemetry._sweep_debris(directory) + + assert fresh.exists(), "a recent quarantine was discarded before anyone could look at it" + assert not old.exists(), "an expired quarantine was left on disk forever" + + +def test_temp_files_orphaned_by_a_kill_are_collected(telemetry): + """_write_identity and _install_salt unlink in a finally, which SIGKILL skips.""" + directory = telemetry.memory_core.data_dir() + directory.mkdir(parents=True, exist_ok=True) + orphan = directory / "telemetry-salt.999.tmp" + orphan.write_text("abandoned", encoding="utf-8") + stale = time.time() - (telemetry.CLAIM_STALE_SECONDS + 60) + os.utime(orphan, (stale, stale)) + + telemetry._sweep_debris(directory) + + assert not orphan.exists(), "a killed process left a temp file on disk forever" diff --git a/integrations/antigravity-plugin/core/telemetry.py b/integrations/antigravity-plugin/core/telemetry.py index 6d7aeecae..a4375f002 100644 --- a/integrations/antigravity-plugin/core/telemetry.py +++ b/integrations/antigravity-plugin/core/telemetry.py @@ -100,6 +100,16 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 +# Added to the wait before a released claim becomes reclaimable, per attempt +# already spent. Releasing straight to "reclaimable now" let two senders burn the +# whole budget within seconds of one another on a single momentary failure, and +# discard a batch a retry a minute later would have delivered. +RETRY_COOLDOWN_SECONDS = 60 def is_enabled() -> bool: @@ -399,38 +409,201 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape. + + Anchored on field position, not on a leading "a": the legacy shape is + ``telemetry--.sending`` and a hex id such as ``a1234567`` would + otherwise parse as attempt 1234567 and be discarded unsent on the first + flush after an upgrade. + """ + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + parts = stem.split("-") + if len(parts) != 4: + return 0 + tail = parts[3] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _sweep_debris(directory: Path) -> None: + """Remove files nothing else will ever pick up again. + + *.partial is a temp file orphaned by a crash between write and rename. + *.corrupt is a batch quarantined for undecodable content. No glob in this + module matches either, so without this they accumulate on disk for the life + of the install. + + Quarantined batches are kept far longer than debris: they are the only + evidence left of events that could not be delivered, and someone diagnosing + a report of missing telemetry has to be able to find one. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for debris in directory.glob("telemetry-*.partial"): + try: + if now - debris.stat().st_mtime > CLAIM_STALE_SECONDS: + debris.unlink() + except OSError: + continue + for quarantined in directory.glob("telemetry-*.corrupt"): + try: + if now - quarantined.stat().st_mtime > CLAIM_EXPIRY_SECONDS: + quarantined.unlink() + except OSError: + continue + # The same reasoning covers *.tmp. _write_identity and _install_salt both + # create one and unlink it in a finally, which a SIGKILL skips, and no glob + # in this module matches the leftovers either. + for temporary in directory.glob("telemetry-*.tmp"): + try: + if now - temporary.stat().st_mtime > CLAIM_STALE_SECONDS: + temporary.unlink() + except OSError: + continue + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ + now = time.time() + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. This check has to come + # first. Claiming a file bumps its attempt count and refreshes its + # mtime, so a sender that has just taken the final attempt looks + # exhausted to everyone else while it is actively draining. Judging + # exhaustion before liveness let a second sender unlink a batch out + # from under its owner, losing every event in it. + continue + # Attempts, not age. Every re-claim touches the mtime and every release + # backdates it by a fixed amount, so age is pinned near the stale + # threshold and never reaches the expiry. Age stays only as a backstop + # for files that never carried an attempt marker. + if _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS or age > CLAIM_EXPIRY_SECONDS: try: orphan.unlink() except OSError: pass continue - if age < CLAIM_STALE_SECONDS: - continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + payload = "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining) + # fsync before the rename: without it the rename can land while the + # bytes have not, and the claim comes back empty or truncated after a + # crash. _drain then reads zero events and unlinks it. + with open(temporary, "w", encoding="utf-8") as handle: + handle.write(payload) + handle.flush() + os.fsync(handle.fileno()) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + # Backdate past the stale threshold so the next flush can pick it up, + # minus a cooldown that grows with the attempts already spent. Clamped so + # the mtime never lands in the future, which would read as a live lease. + cooldown = min(_claim_attempt(claim) * RETRY_COOLDOWN_SECONDS, CLAIM_STALE_SECONDS) + released = time.time() - CLAIM_STALE_SECONDS - 1 + cooldown + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -478,16 +651,61 @@ def resolve_distinct_id() -> tuple[str, str]: def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + _sweep_debris(directory) + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() + except ValueError: + # UnicodeDecodeError from a torn write: the content is unrecoverable, so + # quarantine rather than retry. flush() runs from a bare `finally:` in + # flush_worker, so raising here also skips the handoff cleanup, and an + # undecodable file would otherwise be re-read on every flush forever. + # Reported as delivered because there is nothing left to deliver and the + # rest of the run should continue. + try: + claim.replace(claim.with_suffix(".corrupt")) + except OSError: + try: + claim.unlink() + except OSError: + pass + return 0, True except OSError: - return 0 + # Could not read it, which is not the same as having nothing to send. + # The file is left exactly where it is: a vanished or briefly unreadable + # claim is retryable, and quarantining it here would discard events over + # a transient filesystem error. Reported as undelivered so the run stops + # instead of counting a batch nothing was posted from as delivered. + return 0, False events = [] for line in lines: try: @@ -497,11 +715,18 @@ def flush() -> int: if isinstance(value, dict) and value.get("event"): events.append(value) if not events: + # Only delete when the file really is empty. A non-empty file that + # parses to nothing is a torn write, and its contents are the unsent + # remainder — deleting it is the data loss this PR exists to prevent. try: - claim.unlink() + empty = claim.stat().st_size == 0 + except OSError: + empty = True + try: + claim.replace(claim.with_suffix(".corrupt")) if not empty else claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -520,10 +745,13 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { # Fallback only: events recorded by a build before source @@ -535,16 +763,24 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. If the + # rewrite fails the claim still holds delivered events, so stop rather + # than carry on as though progress were recorded — continuing is how the + # duplicate delivery this PR fixes would come back. + if not _rewrite_claim(claim, events[start + len(chunk) :]): + _release_claim(claim, events[start + len(chunk) :]) + return sent, False + return sent, True def main() -> int: diff --git a/integrations/claude-code-plugin/core/telemetry.py b/integrations/claude-code-plugin/core/telemetry.py index 6d7aeecae..a4375f002 100644 --- a/integrations/claude-code-plugin/core/telemetry.py +++ b/integrations/claude-code-plugin/core/telemetry.py @@ -100,6 +100,16 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 +# Added to the wait before a released claim becomes reclaimable, per attempt +# already spent. Releasing straight to "reclaimable now" let two senders burn the +# whole budget within seconds of one another on a single momentary failure, and +# discard a batch a retry a minute later would have delivered. +RETRY_COOLDOWN_SECONDS = 60 def is_enabled() -> bool: @@ -399,38 +409,201 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape. + + Anchored on field position, not on a leading "a": the legacy shape is + ``telemetry--.sending`` and a hex id such as ``a1234567`` would + otherwise parse as attempt 1234567 and be discarded unsent on the first + flush after an upgrade. + """ + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + parts = stem.split("-") + if len(parts) != 4: + return 0 + tail = parts[3] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _sweep_debris(directory: Path) -> None: + """Remove files nothing else will ever pick up again. + + *.partial is a temp file orphaned by a crash between write and rename. + *.corrupt is a batch quarantined for undecodable content. No glob in this + module matches either, so without this they accumulate on disk for the life + of the install. + + Quarantined batches are kept far longer than debris: they are the only + evidence left of events that could not be delivered, and someone diagnosing + a report of missing telemetry has to be able to find one. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for debris in directory.glob("telemetry-*.partial"): + try: + if now - debris.stat().st_mtime > CLAIM_STALE_SECONDS: + debris.unlink() + except OSError: + continue + for quarantined in directory.glob("telemetry-*.corrupt"): + try: + if now - quarantined.stat().st_mtime > CLAIM_EXPIRY_SECONDS: + quarantined.unlink() + except OSError: + continue + # The same reasoning covers *.tmp. _write_identity and _install_salt both + # create one and unlink it in a finally, which a SIGKILL skips, and no glob + # in this module matches the leftovers either. + for temporary in directory.glob("telemetry-*.tmp"): + try: + if now - temporary.stat().st_mtime > CLAIM_STALE_SECONDS: + temporary.unlink() + except OSError: + continue + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ + now = time.time() + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. This check has to come + # first. Claiming a file bumps its attempt count and refreshes its + # mtime, so a sender that has just taken the final attempt looks + # exhausted to everyone else while it is actively draining. Judging + # exhaustion before liveness let a second sender unlink a batch out + # from under its owner, losing every event in it. + continue + # Attempts, not age. Every re-claim touches the mtime and every release + # backdates it by a fixed amount, so age is pinned near the stale + # threshold and never reaches the expiry. Age stays only as a backstop + # for files that never carried an attempt marker. + if _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS or age > CLAIM_EXPIRY_SECONDS: try: orphan.unlink() except OSError: pass continue - if age < CLAIM_STALE_SECONDS: - continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + payload = "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining) + # fsync before the rename: without it the rename can land while the + # bytes have not, and the claim comes back empty or truncated after a + # crash. _drain then reads zero events and unlinks it. + with open(temporary, "w", encoding="utf-8") as handle: + handle.write(payload) + handle.flush() + os.fsync(handle.fileno()) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + # Backdate past the stale threshold so the next flush can pick it up, + # minus a cooldown that grows with the attempts already spent. Clamped so + # the mtime never lands in the future, which would read as a live lease. + cooldown = min(_claim_attempt(claim) * RETRY_COOLDOWN_SECONDS, CLAIM_STALE_SECONDS) + released = time.time() - CLAIM_STALE_SECONDS - 1 + cooldown + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -478,16 +651,61 @@ def resolve_distinct_id() -> tuple[str, str]: def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + _sweep_debris(directory) + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() + except ValueError: + # UnicodeDecodeError from a torn write: the content is unrecoverable, so + # quarantine rather than retry. flush() runs from a bare `finally:` in + # flush_worker, so raising here also skips the handoff cleanup, and an + # undecodable file would otherwise be re-read on every flush forever. + # Reported as delivered because there is nothing left to deliver and the + # rest of the run should continue. + try: + claim.replace(claim.with_suffix(".corrupt")) + except OSError: + try: + claim.unlink() + except OSError: + pass + return 0, True except OSError: - return 0 + # Could not read it, which is not the same as having nothing to send. + # The file is left exactly where it is: a vanished or briefly unreadable + # claim is retryable, and quarantining it here would discard events over + # a transient filesystem error. Reported as undelivered so the run stops + # instead of counting a batch nothing was posted from as delivered. + return 0, False events = [] for line in lines: try: @@ -497,11 +715,18 @@ def flush() -> int: if isinstance(value, dict) and value.get("event"): events.append(value) if not events: + # Only delete when the file really is empty. A non-empty file that + # parses to nothing is a torn write, and its contents are the unsent + # remainder — deleting it is the data loss this PR exists to prevent. try: - claim.unlink() + empty = claim.stat().st_size == 0 + except OSError: + empty = True + try: + claim.replace(claim.with_suffix(".corrupt")) if not empty else claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -520,10 +745,13 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { # Fallback only: events recorded by a build before source @@ -535,16 +763,24 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. If the + # rewrite fails the claim still holds delivered events, so stop rather + # than carry on as though progress were recorded — continuing is how the + # duplicate delivery this PR fixes would come back. + if not _rewrite_claim(claim, events[start + len(chunk) :]): + _release_claim(claim, events[start + len(chunk) :]) + return sent, False + return sent, True def main() -> int: diff --git a/integrations/claude-code-plugin/tests/test_telemetry.py b/integrations/claude-code-plugin/tests/test_telemetry.py index 6029fa98a..de0db10c6 100644 --- a/integrations/claude-code-plugin/tests/test_telemetry.py +++ b/integrations/claude-code-plugin/tests/test_telemetry.py @@ -199,9 +199,11 @@ def test_a_stale_claim_is_reclaimed(isolated_env, monkeypatch): telemetry.record("search") orphan = telemetry._claim_spool() assert orphan is not None - monkeypatch.setattr( - telemetry.time, "time", lambda: orphan.stat().st_mtime + telemetry.CLAIM_STALE_SECONDS + 1 - ) + # Frozen rather than re-stat'd per call: flush() drains the live spool and + # then looks for parked claims in the same run, so by the second look this + # file no longer exists. + stale_now = orphan.stat().st_mtime + telemetry.CLAIM_STALE_SECONDS + 1 + monkeypatch.setattr(telemetry.time, "time", lambda: stale_now) with patch.object(telemetry, "_post", lambda payload, url: True): assert telemetry.flush() == 1 @@ -211,9 +213,13 @@ def test_an_expired_claim_is_dropped(isolated_env, monkeypatch): telemetry.record("search") orphan = telemetry._claim_spool() assert orphan is not None - monkeypatch.setattr( - telemetry.time, "time", lambda: orphan.stat().st_mtime + telemetry.CLAIM_EXPIRY_SECONDS + 1 - ) + expired_now = orphan.stat().st_mtime + telemetry.CLAIM_EXPIRY_SECONDS + 1 + monkeypatch.setattr(telemetry.time, "time", lambda: expired_now) + # Expiry now only discards a batch that was genuinely retried and failed, + # so age alone is not enough — age it past the attempt budget too. + retried = orphan.parent / orphan.name.replace("-a0.", f"-a{telemetry.MAX_CLAIM_ATTEMPTS}.") + orphan.replace(retried) + os.utime(retried, (expired_now, expired_now - telemetry.CLAIM_EXPIRY_SECONDS - 1)) assert telemetry._claim_spool() is None assert not list(memory_core.data_dir().glob("telemetry-*.sending")) diff --git a/integrations/codex-plugin/core/telemetry.py b/integrations/codex-plugin/core/telemetry.py index 6d7aeecae..a4375f002 100644 --- a/integrations/codex-plugin/core/telemetry.py +++ b/integrations/codex-plugin/core/telemetry.py @@ -100,6 +100,16 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 +# Added to the wait before a released claim becomes reclaimable, per attempt +# already spent. Releasing straight to "reclaimable now" let two senders burn the +# whole budget within seconds of one another on a single momentary failure, and +# discard a batch a retry a minute later would have delivered. +RETRY_COOLDOWN_SECONDS = 60 def is_enabled() -> bool: @@ -399,38 +409,201 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape. + + Anchored on field position, not on a leading "a": the legacy shape is + ``telemetry--.sending`` and a hex id such as ``a1234567`` would + otherwise parse as attempt 1234567 and be discarded unsent on the first + flush after an upgrade. + """ + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + parts = stem.split("-") + if len(parts) != 4: + return 0 + tail = parts[3] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _sweep_debris(directory: Path) -> None: + """Remove files nothing else will ever pick up again. + + *.partial is a temp file orphaned by a crash between write and rename. + *.corrupt is a batch quarantined for undecodable content. No glob in this + module matches either, so without this they accumulate on disk for the life + of the install. + + Quarantined batches are kept far longer than debris: they are the only + evidence left of events that could not be delivered, and someone diagnosing + a report of missing telemetry has to be able to find one. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for debris in directory.glob("telemetry-*.partial"): + try: + if now - debris.stat().st_mtime > CLAIM_STALE_SECONDS: + debris.unlink() + except OSError: + continue + for quarantined in directory.glob("telemetry-*.corrupt"): + try: + if now - quarantined.stat().st_mtime > CLAIM_EXPIRY_SECONDS: + quarantined.unlink() + except OSError: + continue + # The same reasoning covers *.tmp. _write_identity and _install_salt both + # create one and unlink it in a finally, which a SIGKILL skips, and no glob + # in this module matches the leftovers either. + for temporary in directory.glob("telemetry-*.tmp"): + try: + if now - temporary.stat().st_mtime > CLAIM_STALE_SECONDS: + temporary.unlink() + except OSError: + continue + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ + now = time.time() + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. This check has to come + # first. Claiming a file bumps its attempt count and refreshes its + # mtime, so a sender that has just taken the final attempt looks + # exhausted to everyone else while it is actively draining. Judging + # exhaustion before liveness let a second sender unlink a batch out + # from under its owner, losing every event in it. + continue + # Attempts, not age. Every re-claim touches the mtime and every release + # backdates it by a fixed amount, so age is pinned near the stale + # threshold and never reaches the expiry. Age stays only as a backstop + # for files that never carried an attempt marker. + if _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS or age > CLAIM_EXPIRY_SECONDS: try: orphan.unlink() except OSError: pass continue - if age < CLAIM_STALE_SECONDS: - continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + payload = "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining) + # fsync before the rename: without it the rename can land while the + # bytes have not, and the claim comes back empty or truncated after a + # crash. _drain then reads zero events and unlinks it. + with open(temporary, "w", encoding="utf-8") as handle: + handle.write(payload) + handle.flush() + os.fsync(handle.fileno()) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + # Backdate past the stale threshold so the next flush can pick it up, + # minus a cooldown that grows with the attempts already spent. Clamped so + # the mtime never lands in the future, which would read as a live lease. + cooldown = min(_claim_attempt(claim) * RETRY_COOLDOWN_SECONDS, CLAIM_STALE_SECONDS) + released = time.time() - CLAIM_STALE_SECONDS - 1 + cooldown + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -478,16 +651,61 @@ def resolve_distinct_id() -> tuple[str, str]: def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + _sweep_debris(directory) + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() + except ValueError: + # UnicodeDecodeError from a torn write: the content is unrecoverable, so + # quarantine rather than retry. flush() runs from a bare `finally:` in + # flush_worker, so raising here also skips the handoff cleanup, and an + # undecodable file would otherwise be re-read on every flush forever. + # Reported as delivered because there is nothing left to deliver and the + # rest of the run should continue. + try: + claim.replace(claim.with_suffix(".corrupt")) + except OSError: + try: + claim.unlink() + except OSError: + pass + return 0, True except OSError: - return 0 + # Could not read it, which is not the same as having nothing to send. + # The file is left exactly where it is: a vanished or briefly unreadable + # claim is retryable, and quarantining it here would discard events over + # a transient filesystem error. Reported as undelivered so the run stops + # instead of counting a batch nothing was posted from as delivered. + return 0, False events = [] for line in lines: try: @@ -497,11 +715,18 @@ def flush() -> int: if isinstance(value, dict) and value.get("event"): events.append(value) if not events: + # Only delete when the file really is empty. A non-empty file that + # parses to nothing is a torn write, and its contents are the unsent + # remainder — deleting it is the data loss this PR exists to prevent. try: - claim.unlink() + empty = claim.stat().st_size == 0 + except OSError: + empty = True + try: + claim.replace(claim.with_suffix(".corrupt")) if not empty else claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -520,10 +745,13 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { # Fallback only: events recorded by a build before source @@ -535,16 +763,24 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. If the + # rewrite fails the claim still holds delivered events, so stop rather + # than carry on as though progress were recorded — continuing is how the + # duplicate delivery this PR fixes would come back. + if not _rewrite_claim(claim, events[start + len(chunk) :]): + _release_claim(claim, events[start + len(chunk) :]) + return sent, False + return sent, True def main() -> int: diff --git a/integrations/cursor-plugin/core/telemetry.py b/integrations/cursor-plugin/core/telemetry.py index 6d7aeecae..a4375f002 100644 --- a/integrations/cursor-plugin/core/telemetry.py +++ b/integrations/cursor-plugin/core/telemetry.py @@ -100,6 +100,16 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 +# Added to the wait before a released claim becomes reclaimable, per attempt +# already spent. Releasing straight to "reclaimable now" let two senders burn the +# whole budget within seconds of one another on a single momentary failure, and +# discard a batch a retry a minute later would have delivered. +RETRY_COOLDOWN_SECONDS = 60 def is_enabled() -> bool: @@ -399,38 +409,201 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape. + + Anchored on field position, not on a leading "a": the legacy shape is + ``telemetry--.sending`` and a hex id such as ``a1234567`` would + otherwise parse as attempt 1234567 and be discarded unsent on the first + flush after an upgrade. + """ + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + parts = stem.split("-") + if len(parts) != 4: + return 0 + tail = parts[3] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _sweep_debris(directory: Path) -> None: + """Remove files nothing else will ever pick up again. + + *.partial is a temp file orphaned by a crash between write and rename. + *.corrupt is a batch quarantined for undecodable content. No glob in this + module matches either, so without this they accumulate on disk for the life + of the install. + + Quarantined batches are kept far longer than debris: they are the only + evidence left of events that could not be delivered, and someone diagnosing + a report of missing telemetry has to be able to find one. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for debris in directory.glob("telemetry-*.partial"): + try: + if now - debris.stat().st_mtime > CLAIM_STALE_SECONDS: + debris.unlink() + except OSError: + continue + for quarantined in directory.glob("telemetry-*.corrupt"): + try: + if now - quarantined.stat().st_mtime > CLAIM_EXPIRY_SECONDS: + quarantined.unlink() + except OSError: + continue + # The same reasoning covers *.tmp. _write_identity and _install_salt both + # create one and unlink it in a finally, which a SIGKILL skips, and no glob + # in this module matches the leftovers either. + for temporary in directory.glob("telemetry-*.tmp"): + try: + if now - temporary.stat().st_mtime > CLAIM_STALE_SECONDS: + temporary.unlink() + except OSError: + continue + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ + now = time.time() + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. This check has to come + # first. Claiming a file bumps its attempt count and refreshes its + # mtime, so a sender that has just taken the final attempt looks + # exhausted to everyone else while it is actively draining. Judging + # exhaustion before liveness let a second sender unlink a batch out + # from under its owner, losing every event in it. + continue + # Attempts, not age. Every re-claim touches the mtime and every release + # backdates it by a fixed amount, so age is pinned near the stale + # threshold and never reaches the expiry. Age stays only as a backstop + # for files that never carried an attempt marker. + if _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS or age > CLAIM_EXPIRY_SECONDS: try: orphan.unlink() except OSError: pass continue - if age < CLAIM_STALE_SECONDS: - continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + payload = "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining) + # fsync before the rename: without it the rename can land while the + # bytes have not, and the claim comes back empty or truncated after a + # crash. _drain then reads zero events and unlinks it. + with open(temporary, "w", encoding="utf-8") as handle: + handle.write(payload) + handle.flush() + os.fsync(handle.fileno()) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + # Backdate past the stale threshold so the next flush can pick it up, + # minus a cooldown that grows with the attempts already spent. Clamped so + # the mtime never lands in the future, which would read as a live lease. + cooldown = min(_claim_attempt(claim) * RETRY_COOLDOWN_SECONDS, CLAIM_STALE_SECONDS) + released = time.time() - CLAIM_STALE_SECONDS - 1 + cooldown + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -478,16 +651,61 @@ def resolve_distinct_id() -> tuple[str, str]: def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + _sweep_debris(directory) + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() + except ValueError: + # UnicodeDecodeError from a torn write: the content is unrecoverable, so + # quarantine rather than retry. flush() runs from a bare `finally:` in + # flush_worker, so raising here also skips the handoff cleanup, and an + # undecodable file would otherwise be re-read on every flush forever. + # Reported as delivered because there is nothing left to deliver and the + # rest of the run should continue. + try: + claim.replace(claim.with_suffix(".corrupt")) + except OSError: + try: + claim.unlink() + except OSError: + pass + return 0, True except OSError: - return 0 + # Could not read it, which is not the same as having nothing to send. + # The file is left exactly where it is: a vanished or briefly unreadable + # claim is retryable, and quarantining it here would discard events over + # a transient filesystem error. Reported as undelivered so the run stops + # instead of counting a batch nothing was posted from as delivered. + return 0, False events = [] for line in lines: try: @@ -497,11 +715,18 @@ def flush() -> int: if isinstance(value, dict) and value.get("event"): events.append(value) if not events: + # Only delete when the file really is empty. A non-empty file that + # parses to nothing is a torn write, and its contents are the unsent + # remainder — deleting it is the data loss this PR exists to prevent. try: - claim.unlink() + empty = claim.stat().st_size == 0 + except OSError: + empty = True + try: + claim.replace(claim.with_suffix(".corrupt")) if not empty else claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -520,10 +745,13 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { # Fallback only: events recorded by a build before source @@ -535,16 +763,24 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. If the + # rewrite fails the claim still holds delivered events, so stop rather + # than carry on as though progress were recorded — continuing is how the + # duplicate delivery this PR fixes would come back. + if not _rewrite_claim(claim, events[start + len(chunk) :]): + _release_claim(claim, events[start + len(chunk) :]) + return sent, False + return sent, True def main() -> int: diff --git a/integrations/kimi-plugin/core/telemetry.py b/integrations/kimi-plugin/core/telemetry.py index 6d7aeecae..a4375f002 100644 --- a/integrations/kimi-plugin/core/telemetry.py +++ b/integrations/kimi-plugin/core/telemetry.py @@ -100,6 +100,16 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 +# Added to the wait before a released claim becomes reclaimable, per attempt +# already spent. Releasing straight to "reclaimable now" let two senders burn the +# whole budget within seconds of one another on a single momentary failure, and +# discard a batch a retry a minute later would have delivered. +RETRY_COOLDOWN_SECONDS = 60 def is_enabled() -> bool: @@ -399,38 +409,201 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape. + + Anchored on field position, not on a leading "a": the legacy shape is + ``telemetry--.sending`` and a hex id such as ``a1234567`` would + otherwise parse as attempt 1234567 and be discarded unsent on the first + flush after an upgrade. + """ + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + parts = stem.split("-") + if len(parts) != 4: + return 0 + tail = parts[3] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _sweep_debris(directory: Path) -> None: + """Remove files nothing else will ever pick up again. + + *.partial is a temp file orphaned by a crash between write and rename. + *.corrupt is a batch quarantined for undecodable content. No glob in this + module matches either, so without this they accumulate on disk for the life + of the install. + + Quarantined batches are kept far longer than debris: they are the only + evidence left of events that could not be delivered, and someone diagnosing + a report of missing telemetry has to be able to find one. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for debris in directory.glob("telemetry-*.partial"): + try: + if now - debris.stat().st_mtime > CLAIM_STALE_SECONDS: + debris.unlink() + except OSError: + continue + for quarantined in directory.glob("telemetry-*.corrupt"): + try: + if now - quarantined.stat().st_mtime > CLAIM_EXPIRY_SECONDS: + quarantined.unlink() + except OSError: + continue + # The same reasoning covers *.tmp. _write_identity and _install_salt both + # create one and unlink it in a finally, which a SIGKILL skips, and no glob + # in this module matches the leftovers either. + for temporary in directory.glob("telemetry-*.tmp"): + try: + if now - temporary.stat().st_mtime > CLAIM_STALE_SECONDS: + temporary.unlink() + except OSError: + continue + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ + now = time.time() + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. This check has to come + # first. Claiming a file bumps its attempt count and refreshes its + # mtime, so a sender that has just taken the final attempt looks + # exhausted to everyone else while it is actively draining. Judging + # exhaustion before liveness let a second sender unlink a batch out + # from under its owner, losing every event in it. + continue + # Attempts, not age. Every re-claim touches the mtime and every release + # backdates it by a fixed amount, so age is pinned near the stale + # threshold and never reaches the expiry. Age stays only as a backstop + # for files that never carried an attempt marker. + if _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS or age > CLAIM_EXPIRY_SECONDS: try: orphan.unlink() except OSError: pass continue - if age < CLAIM_STALE_SECONDS: - continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + payload = "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining) + # fsync before the rename: without it the rename can land while the + # bytes have not, and the claim comes back empty or truncated after a + # crash. _drain then reads zero events and unlinks it. + with open(temporary, "w", encoding="utf-8") as handle: + handle.write(payload) + handle.flush() + os.fsync(handle.fileno()) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + # Backdate past the stale threshold so the next flush can pick it up, + # minus a cooldown that grows with the attempts already spent. Clamped so + # the mtime never lands in the future, which would read as a live lease. + cooldown = min(_claim_attempt(claim) * RETRY_COOLDOWN_SECONDS, CLAIM_STALE_SECONDS) + released = time.time() - CLAIM_STALE_SECONDS - 1 + cooldown + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -478,16 +651,61 @@ def resolve_distinct_id() -> tuple[str, str]: def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + _sweep_debris(directory) + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() + except ValueError: + # UnicodeDecodeError from a torn write: the content is unrecoverable, so + # quarantine rather than retry. flush() runs from a bare `finally:` in + # flush_worker, so raising here also skips the handoff cleanup, and an + # undecodable file would otherwise be re-read on every flush forever. + # Reported as delivered because there is nothing left to deliver and the + # rest of the run should continue. + try: + claim.replace(claim.with_suffix(".corrupt")) + except OSError: + try: + claim.unlink() + except OSError: + pass + return 0, True except OSError: - return 0 + # Could not read it, which is not the same as having nothing to send. + # The file is left exactly where it is: a vanished or briefly unreadable + # claim is retryable, and quarantining it here would discard events over + # a transient filesystem error. Reported as undelivered so the run stops + # instead of counting a batch nothing was posted from as delivered. + return 0, False events = [] for line in lines: try: @@ -497,11 +715,18 @@ def flush() -> int: if isinstance(value, dict) and value.get("event"): events.append(value) if not events: + # Only delete when the file really is empty. A non-empty file that + # parses to nothing is a torn write, and its contents are the unsent + # remainder — deleting it is the data loss this PR exists to prevent. try: - claim.unlink() + empty = claim.stat().st_size == 0 + except OSError: + empty = True + try: + claim.replace(claim.with_suffix(".corrupt")) if not empty else claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -520,10 +745,13 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { # Fallback only: events recorded by a build before source @@ -535,16 +763,24 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. If the + # rewrite fails the claim still holds delivered events, so stop rather + # than carry on as though progress were recorded — continuing is how the + # duplicate delivery this PR fixes would come back. + if not _rewrite_claim(claim, events[start + len(chunk) :]): + _release_claim(claim, events[start + len(chunk) :]) + return sent, False + return sent, True def main() -> int: diff --git a/integrations/mem0-agent-plugin/core/telemetry.py b/integrations/mem0-agent-plugin/core/telemetry.py index 6d7aeecae..a4375f002 100644 --- a/integrations/mem0-agent-plugin/core/telemetry.py +++ b/integrations/mem0-agent-plugin/core/telemetry.py @@ -100,6 +100,16 @@ BATCH_SIZE = 100 SEND_TIMEOUT = 5 CLAIM_STALE_SECONDS = 120 CLAIM_EXPIRY_SECONDS = 7 * 24 * 60 * 60 +# A batch is only discarded once it has genuinely been retried this many times. +MAX_CLAIM_ATTEMPTS = 3 +# Parked claims drained per run, after the live spool. Bounded so a long backlog +# cannot turn one flush into an unbounded send loop. +MAX_PARKED_PER_RUN = 3 +# Added to the wait before a released claim becomes reclaimable, per attempt +# already spent. Releasing straight to "reclaimable now" let two senders burn the +# whole budget within seconds of one another on a single momentary failure, and +# discard a batch a retry a minute later would have delivered. +RETRY_COOLDOWN_SECONDS = 60 def is_enabled() -> bool: @@ -399,38 +409,201 @@ def spawn_flush() -> bool: return False +def _claim_name(attempt: int = 0) -> str: + """Claim filename. The attempt count rides in the name so the 7-day expiry + only ever discards a batch that was actually retried and failed.""" + return f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}-a{attempt}.sending" + + +def _claim_attempt(claim: Path) -> int: + """Attempts recorded in a claim filename; 0 for the pre-attempt-count shape. + + Anchored on field position, not on a leading "a": the legacy shape is + ``telemetry--.sending`` and a hex id such as ``a1234567`` would + otherwise parse as attempt 1234567 and be discarded unsent on the first + flush after an upgrade. + """ + stem = claim.name[: -len(".sending")] if claim.name.endswith(".sending") else claim.name + parts = stem.split("-") + if len(parts) != 4: + return 0 + tail = parts[3] + if tail.startswith("a") and tail[1:].isdigit(): + return int(tail[1:]) + return 0 + + +def _touch(path: Path) -> None: + """Refresh mtime so a claim's age measures time since it was claimed. + + ``Path.replace`` is ``os.rename``, which preserves mtime — so a claim created + after a quiet minute inherited the spool's last-write time and looked + abandoned the instant it was made. A second sender would then take it over + while the first was still posting, and both would deliver the batch. + """ + try: + os.utime(path, None) + except OSError: + pass + + def _claim_spool() -> Path | None: """Rename the spool aside so exactly one sender owns each batch.""" directory = memory_core.data_dir() - claim = directory / f"telemetry-{os.getpid()}-{uuid.uuid4().hex[:8]}.sending" + claim = directory / _claim_name() spool = _spool_path() try: spool.replace(claim) + _touch(claim) return claim except OSError: pass + return _claim_parked(directory) + + +def _sweep_debris(directory: Path) -> None: + """Remove files nothing else will ever pick up again. + + *.partial is a temp file orphaned by a crash between write and rename. + *.corrupt is a batch quarantined for undecodable content. No glob in this + module matches either, so without this they accumulate on disk for the life + of the install. + + Quarantined batches are kept far longer than debris: they are the only + evidence left of events that could not be delivered, and someone diagnosing + a report of missing telemetry has to be able to find one. + """ now = time.time() - for orphan in sorted(directory.glob("telemetry-*.sending")): + for debris in directory.glob("telemetry-*.partial"): + try: + if now - debris.stat().st_mtime > CLAIM_STALE_SECONDS: + debris.unlink() + except OSError: + continue + for quarantined in directory.glob("telemetry-*.corrupt"): + try: + if now - quarantined.stat().st_mtime > CLAIM_EXPIRY_SECONDS: + quarantined.unlink() + except OSError: + continue + # The same reasoning covers *.tmp. _write_identity and _install_salt both + # create one and unlink it in a finally, which a SIGKILL skips, and no glob + # in this module matches the leftovers either. + for temporary in directory.glob("telemetry-*.tmp"): + try: + if now - temporary.stat().st_mtime > CLAIM_STALE_SECONDS: + temporary.unlink() + except OSError: + continue + + +def _claim_parked(directory: Path) -> Path | None: + """Take the oldest abandoned claim, if any lease has actually expired. + + Kept separate from the live spool so flush() can drain both in one run. + Previously parked batches were only reachable when no spool existed at all, + and because sessions keep recording there usually was one — so a batch + parked by a failed send waited until the 7-day expiry deleted it unsent, + even though its own presence is what started the sender. + """ + now = time.time() + for orphan in sorted(directory.glob("telemetry-*.sending"), key=_safe_mtime): try: age = now - orphan.stat().st_mtime except OSError: continue - if age > CLAIM_EXPIRY_SECONDS: + if age < CLAIM_STALE_SECONDS: + # Someone else holds a live lease on it. This check has to come + # first. Claiming a file bumps its attempt count and refreshes its + # mtime, so a sender that has just taken the final attempt looks + # exhausted to everyone else while it is actively draining. Judging + # exhaustion before liveness let a second sender unlink a batch out + # from under its owner, losing every event in it. + continue + # Attempts, not age. Every re-claim touches the mtime and every release + # backdates it by a fixed amount, so age is pinned near the stale + # threshold and never reaches the expiry. Age stays only as a backstop + # for files that never carried an attempt marker. + if _claim_attempt(orphan) >= MAX_CLAIM_ATTEMPTS or age > CLAIM_EXPIRY_SECONDS: try: orphan.unlink() except OSError: pass continue - if age < CLAIM_STALE_SECONDS: - continue + claim = orphan.parent / _claim_name(_claim_attempt(orphan) + 1) try: orphan.replace(claim) + _touch(claim) return claim except OSError: continue return None +def _safe_mtime(path: Path) -> float: + try: + return path.stat().st_mtime + except OSError: + return 0.0 + + +def _rewrite_claim(claim: Path, remaining: list[dict[str, Any]]) -> bool: + """Persist the unsent remainder, atomically, and refresh the lease. + + Called after every successful batch. Two jobs: a retry resumes where the + send stopped instead of re-posting from the top, and the rewrite doubles as + the lease heartbeat, so a slow sender does not have its claim stolen + mid-flight. Interval is one batch, well inside CLAIM_STALE_SECONDS. + """ + if not remaining: + try: + claim.unlink() + except OSError: + pass + return True + temporary = claim.with_suffix(f".{os.getpid()}.partial") + try: + payload = "".join(json.dumps(event, separators=(",", ":"), default=str) + "\n" for event in remaining) + # fsync before the rename: without it the rename can land while the + # bytes have not, and the claim comes back empty or truncated after a + # crash. _drain then reads zero events and unlinks it. + with open(temporary, "w", encoding="utf-8") as handle: + handle.write(payload) + handle.flush() + os.fsync(handle.fileno()) + temporary.replace(claim) + _touch(claim) + return True + except OSError: + try: + temporary.unlink() + except OSError: + pass + return False + + +def _release_claim(claim: Path, remaining: list[dict[str, Any]]) -> None: + """Persist the remainder and drop the lease, because this sender has given up. + + Distinct from the per-batch heartbeat: heartbeating on the way out would + make an abandoned batch look actively owned for a further + CLAIM_STALE_SECONDS, delaying the retry for no reason. Ageing it past the + threshold lets the next flush pick it up immediately, while the attempt + count in the filename still bounds how many times that can happen. + """ + if not _rewrite_claim(claim, remaining): + return + try: + # Backdate past the stale threshold so the next flush can pick it up, + # minus a cooldown that grows with the attempts already spent. Clamped so + # the mtime never lands in the future, which would read as a live lease. + cooldown = min(_claim_attempt(claim) * RETRY_COOLDOWN_SECONDS, CLAIM_STALE_SECONDS) + released = time.time() - CLAIM_STALE_SECONDS - 1 + cooldown + os.utime(claim, (released, released)) + except OSError: + pass + + def _resolve_email(key: str) -> str: """Trade the API key for the account email so events join other Mem0 surfaces.""" url = os.environ.get("MEM0_API_URL", memory_core.DEFAULT_API_URL).rstrip("/") + "/v1/ping/" @@ -478,16 +651,61 @@ def resolve_distinct_id() -> tuple[str, str]: def flush() -> int: - """Drain claimed spools to PostHog and return the number of events sent.""" + """Drain the live spool, then any parked claims, and return events sent.""" if not is_enabled(): return 0 - claim = _claim_spool() + sent, delivered = _drain(_claim_spool()) + if not delivered: + # The network is failing. Retrying other batches now would only burn + # their attempt budget against the same broken connection. + return sent + + # Parked batches used to starve behind the live spool indefinitely. Bounded + # per run so a long backlog cannot turn one flush into an unbounded loop. + directory = memory_core.data_dir() + _sweep_debris(directory) + for _ in range(MAX_PARKED_PER_RUN): + parked = _claim_parked(directory) + if parked is None: + break + count, delivered = _drain(parked) + sent += count + if not delivered: + break + return sent + + +def _drain(claim: Path | None) -> tuple[int, bool]: + """Post one claimed batch file, recording progress after every batch. + + Returns (events sent, whether everything was delivered). + """ if claim is None: - return 0 + return 0, True try: lines = claim.read_text(encoding="utf-8").splitlines() + except ValueError: + # UnicodeDecodeError from a torn write: the content is unrecoverable, so + # quarantine rather than retry. flush() runs from a bare `finally:` in + # flush_worker, so raising here also skips the handoff cleanup, and an + # undecodable file would otherwise be re-read on every flush forever. + # Reported as delivered because there is nothing left to deliver and the + # rest of the run should continue. + try: + claim.replace(claim.with_suffix(".corrupt")) + except OSError: + try: + claim.unlink() + except OSError: + pass + return 0, True except OSError: - return 0 + # Could not read it, which is not the same as having nothing to send. + # The file is left exactly where it is: a vanished or briefly unreadable + # claim is retryable, and quarantining it here would discard events over + # a transient filesystem error. Reported as undelivered so the run stops + # instead of counting a batch nothing was posted from as delivered. + return 0, False events = [] for line in lines: try: @@ -497,11 +715,18 @@ def flush() -> int: if isinstance(value, dict) and value.get("event"): events.append(value) if not events: + # Only delete when the file really is empty. A non-empty file that + # parses to nothing is a torn write, and its contents are the unsent + # remainder — deleting it is the data loss this PR exists to prevent. try: - claim.unlink() + empty = claim.stat().st_size == 0 + except OSError: + empty = True + try: + claim.replace(claim.with_suffix(".corrupt")) if not empty else claim.unlink() except OSError: pass - return 0 + return 0, True distinct_id, aliased_anonymous_id = resolve_distinct_id() if aliased_anonymous_id: @@ -520,10 +745,13 @@ def flush() -> int: sent = 0 for start in range(0, len(events), BATCH_SIZE): + chunk = events[start : start + BATCH_SIZE] batch = [ { "event": event["event"], "distinct_id": distinct_id, + # Carried through from record() so a resend can be collapsed. + "uuid": event.get("uuid"), "timestamp": event.get("timestamp"), "properties": { # Fallback only: events recorded by a build before source @@ -535,16 +763,24 @@ def flush() -> int: **(event.get("properties") or {}), }, } - for event in events[start : start + BATCH_SIZE] + for event in chunk ] if not _post({"api_key": POSTHOG_API_KEY, "batch": batch}, POSTHOG_BATCH_URL): - return sent - sent += len(batch) - try: - claim.unlink() - except OSError: - pass - return sent + # Keep only what has not been delivered, and release the lease. + # Previously the whole file was kept and the retry re-posted every + # batch, including the ones that had already arrived. + _release_claim(claim, events[start:]) + return sent, False + sent += len(chunk) + # Record progress and refresh the lease after each successful batch, so + # a crash repeats at most one batch instead of the entire file. If the + # rewrite fails the claim still holds delivered events, so stop rather + # than carry on as though progress were recorded — continuing is how the + # duplicate delivery this PR fixes would come back. + if not _rewrite_claim(claim, events[start + len(chunk) :]): + _release_claim(claim, events[start + len(chunk) :]) + return sent, False + return sent, True def main() -> int: From 4e38b057fd110c201bd372ab5e1620e81c67a4ed Mon Sep 17 00:00:00 2001 From: Saket Aryan Date: Fri, 18 Sep 2026 13:46:25 +0530 Subject: [PATCH 11/55] fix(plugins): count installs once, and re-resolve the email when the key changes (#7325) --- .../agent-plugin-core/python/hook_runner.py | 18 +- .../agent-plugin-core/python/telemetry.py | 240 +++++++++++++++++- .../tests/test_uninitialised_identity.py | 68 +++++ .../antigravity-plugin/core/hook_runner.py | 18 +- .../antigravity-plugin/core/telemetry.py | 240 +++++++++++++++++- .../claude-code-plugin/core/hook_runner.py | 18 +- .../claude-code-plugin/core/telemetry.py | 240 +++++++++++++++++- .../tests/test_telemetry.py | 140 +++++++++- integrations/codex-plugin/core/hook_runner.py | 18 +- integrations/codex-plugin/core/telemetry.py | 240 +++++++++++++++++- .../cursor-plugin/core/hook_runner.py | 18 +- integrations/cursor-plugin/core/telemetry.py | 240 +++++++++++++++++- integrations/kimi-plugin/core/hook_runner.py | 18 +- integrations/kimi-plugin/core/telemetry.py | 240 +++++++++++++++++- .../mem0-agent-plugin/core/telemetry.py | 240 +++++++++++++++++- 15 files changed, 1912 insertions(+), 84 deletions(-) diff --git a/integrations/agent-plugin-core/python/hook_runner.py b/integrations/agent-plugin-core/python/hook_runner.py index 2a2adb557..b3d8a3210 100644 --- a/integrations/agent-plugin-core/python/hook_runner.py +++ b/integrations/agent-plugin-core/python/hook_runner.py @@ -290,6 +290,11 @@ def run( if args.plugin_data_dir: os.environ[data_dir_env] = args.plugin_data_dir + # Snapshot BEFORE anything writes to the data dir: cache_plugin_api_key + # writes `api-key` and EvidenceStore creates `evidence.sqlite3`, so asking + # after them always saw content and every fresh install reported an upgrade. + data_dir_was_empty = telemetry.data_dir_was_empty() + cache_plugin_api_key() if args.action == "session-start": clear_stale_api_key_cache() @@ -305,8 +310,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install(was_empty=data_dir_was_empty) + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/agent-plugin-core/python/telemetry.py b/integrations/agent-plugin-core/python/telemetry.py index a4375f002..c1fc0084c 100644 --- a/integrations/agent-plugin-core/python/telemetry.py +++ b/integrations/agent-plugin-core/python/telemetry.py @@ -302,9 +302,176 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _rotate_anonymous_id(identity: dict[str, str]) -> str: + """Mint a fresh anonymous id because the account context is gone. + + The previous id may already have been merged into a person profile by an + $identify, and that merge is permanent. Reusing it after a logout or a key + change attributes everything that follows to the account that just went + away, which is the same misattribution the key fingerprint exists to stop, + only arriving through the anonymous path instead. + + `aliased` is cleared with it: the new id has never been merged, so it is + eligible to be aliased into whatever account comes next. + """ + created = f"code-anon-{uuid.uuid4().hex}" + identity["anonymous_id"] = created + identity.pop("aliased", None) + _write_identity(identity) + return created + + +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def data_dir_was_empty() -> bool: + """Whether the data directory is untouched. Call BEFORE anything writes to it. + + hook_runner reaches claim_install() only after cache_plugin_api_key() has + written `api-key` and EvidenceStore() has created `evidence.sqlite3`, so + asking at claim time always saw content and every fresh install reported an + upgrade. The caller snapshots this at the top of the run instead. + """ + return not _data_dir_has_content() + + +def claim_install(was_empty: bool | None = None) -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + + `was_empty` must come from data_dir_was_empty() called before this process + wrote anything. Omitting it falls back to checking now, which is only + correct for a caller that has touched nothing. + """ + if not is_enabled(): + # Never consume the one-shot claim while the user is opted out, or they + # would silently lose their install event if they later opt in. + return None + + path = _install_state_path() + upgrading = not (data_dir_was_empty() if was_empty is None else was_empty) + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + # Durable before this returns. The O_EXCL open is what makes the + # claim exclusive, so it cannot be replaced by a temp-and-rename + # without losing that, which leaves the content as the thing to make + # safe. A kill between the open and this fsync used to leave a marker + # that exists but parses to nothing: is_first_run reads it as claimed + # and claim_version_change cannot read a version out of it. + stream.flush() + os.fsync(stream.fileno()) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def _repair_install_state(path: Path) -> None: + """Rewrite an unparseable marker so version tracking can resume.""" + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text( + json.dumps({"plugin_version": memory_core.PLUGIN_VERSION, "repaired_at": memory_core.utc_now()}), + encoding="utf-8", + ) + temporary.replace(path) + except OSError: + pass + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except OSError: + return None + except json.JSONDecodeError: + # A crash between O_EXCL and the write leaves an empty marker. Left + # alone it disables every future upgrade event on this machine, because + # claim_install sees the file and this function cannot parse it. + state = None + if not isinstance(state, dict): + _repair_install_state(path) + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + # Claim the transition with an exclusive sentinel before rewriting the + # marker. A plain read-modify-write let every concurrently starting session + # observe the old version and each record its own upgrade — and the first + # session after a version bump is exactly when several agent windows restart + # together. + sentinel = path.with_name(f"upgraded-{memory_core.PLUGIN_VERSION}") + try: + os.close(os.open(sentinel, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600)) + except FileExistsError: + return None + except OSError: + return None + + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + temporary = path.with_suffix(f".{os.getpid()}.tmp") + try: + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + # Release the claim. The marker still records the old version, so + # without this the sentinel makes claim_version_change return early on + # every later run and this version's upgrade is never recorded again. + for leftover in (sentinel, temporary): + try: + leftover.unlink() + except OSError: + pass + return None + return previous def record( @@ -633,21 +800,72 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and fingerprint: + recorded = identity.get("key_fingerprint", "") + if recorded == fingerprint: + return email, "" + if not recorded: + # Rows written before fingerprints existed. Verify rather than + # adopt: a key changed before the upgrade would otherwise bind the + # new key to the previous account's email, permanently, and the + # fingerprint would then agree with itself forever after. + verified = _resolve_email(key) + if not verified: + # Offline, firewalled, or the API is down. Keep the previous + # behaviour and retry on the next flush rather than dropping a + # real account attribution. Safe because the same network that + # failed /v1/ping/ is about to fail the PostHog POST, so nothing + # is delivered under the unverified identity in the meantime. + return email, "" + identity["email"] = verified + identity["key_fingerprint"] = fingerprint + _write_identity(identity) + return verified, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: + + resolved = _resolve_email(key) + if not resolved: + # The key changed and will not resolve (revoked, offline, API down). + # Reaching here with an email means the recorded fingerprint disagreed, + # so the key really did change. Drop the account and rotate: the stored + # anonymous id may already be merged into that account's person, and + # reusing it would keep the events on the profile we are trying to + # leave. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + # Alias only when going anonymous -> email for the first time. Once an anon + # id has been merged into an account it must never be offered again: an + # alias naming an already-identified id is what could link two real people. + previous = "" if (email or identity.get("aliased")) else identity.get("anonymous_id", "") + if previous: + identity["aliased"] = True + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: diff --git a/integrations/agent-plugin-core/tests/test_uninitialised_identity.py b/integrations/agent-plugin-core/tests/test_uninitialised_identity.py index 14f911bee..7d48dbcc3 100644 --- a/integrations/agent-plugin-core/tests/test_uninitialised_identity.py +++ b/integrations/agent-plugin-core/tests/test_uninitialised_identity.py @@ -177,3 +177,71 @@ def test_source_tag_defaults_agree_between_the_two_modules(): ) left, right = out.split() assert left == right == "KIMI_PLUGIN" + + +def _session_start(core: Path, data_dir: Path) -> list[str]: + """Drive the real hook_runner session-start path and return lifecycle events.""" + recorded = "\n".join( + [ + "import io, json, sys", + f"sys.path.insert(0, {str(core)!r})", + "import telemetry, hook_runner", + "seen = []", + "telemetry.record = lambda event, **kw: seen.append(event) or None", + "telemetry.spawn_flush = lambda: False", + # run() reads sys.argv through argparse; it takes no positional args. + "sys.argv = ['hook_runner', 'session-start']", + "sys.stdin = io.StringIO('{}')", + "hook_runner.run()", + "print(json.dumps([e for e in seen if e in ('install', 'upgrade')]))", + ] + ) + import json as _json + + return _json.loads(_run(core, data_dir, recorded) or "[]") + + +def test_a_fresh_install_reports_install_not_upgrade(): + """The decision must survive the writes hook_runner does before asking. + + claim_install() is reached only after cache_plugin_api_key() has written + `api-key` and EvidenceStore() has created `evidence.sqlite3`. Asking "is the + data dir empty" at that point always saw content, so code.install could + never fire and every new user was counted as an upgrade. + """ + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + data_dir = Path(tmp) / "data" + assert _session_start(core, data_dir) == ["install"] + + +def test_the_lifecycle_event_fires_exactly_once(): + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + data_dir = Path(tmp) / "data" + first = _session_start(core, data_dir) + second = _session_start(core, data_dir) + third = _session_start(core, data_dir) + + assert first == ["install"] + assert second == [] + assert third == [] + + +def test_an_existing_data_dir_reports_upgrade(): + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + data_dir = Path(tmp) / "data" + data_dir.mkdir(parents=True) + # A 0.2.x leftover: the data dir survives the upgrade. + (data_dir / "requirements.txt").write_text("mem0ai\n", encoding="utf-8") + assert _session_start(core, data_dir) == ["upgrade"] diff --git a/integrations/antigravity-plugin/core/hook_runner.py b/integrations/antigravity-plugin/core/hook_runner.py index 2a2adb557..b3d8a3210 100644 --- a/integrations/antigravity-plugin/core/hook_runner.py +++ b/integrations/antigravity-plugin/core/hook_runner.py @@ -290,6 +290,11 @@ def run( if args.plugin_data_dir: os.environ[data_dir_env] = args.plugin_data_dir + # Snapshot BEFORE anything writes to the data dir: cache_plugin_api_key + # writes `api-key` and EvidenceStore creates `evidence.sqlite3`, so asking + # after them always saw content and every fresh install reported an upgrade. + data_dir_was_empty = telemetry.data_dir_was_empty() + cache_plugin_api_key() if args.action == "session-start": clear_stale_api_key_cache() @@ -305,8 +310,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install(was_empty=data_dir_was_empty) + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/antigravity-plugin/core/telemetry.py b/integrations/antigravity-plugin/core/telemetry.py index a4375f002..c1fc0084c 100644 --- a/integrations/antigravity-plugin/core/telemetry.py +++ b/integrations/antigravity-plugin/core/telemetry.py @@ -302,9 +302,176 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _rotate_anonymous_id(identity: dict[str, str]) -> str: + """Mint a fresh anonymous id because the account context is gone. + + The previous id may already have been merged into a person profile by an + $identify, and that merge is permanent. Reusing it after a logout or a key + change attributes everything that follows to the account that just went + away, which is the same misattribution the key fingerprint exists to stop, + only arriving through the anonymous path instead. + + `aliased` is cleared with it: the new id has never been merged, so it is + eligible to be aliased into whatever account comes next. + """ + created = f"code-anon-{uuid.uuid4().hex}" + identity["anonymous_id"] = created + identity.pop("aliased", None) + _write_identity(identity) + return created + + +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def data_dir_was_empty() -> bool: + """Whether the data directory is untouched. Call BEFORE anything writes to it. + + hook_runner reaches claim_install() only after cache_plugin_api_key() has + written `api-key` and EvidenceStore() has created `evidence.sqlite3`, so + asking at claim time always saw content and every fresh install reported an + upgrade. The caller snapshots this at the top of the run instead. + """ + return not _data_dir_has_content() + + +def claim_install(was_empty: bool | None = None) -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + + `was_empty` must come from data_dir_was_empty() called before this process + wrote anything. Omitting it falls back to checking now, which is only + correct for a caller that has touched nothing. + """ + if not is_enabled(): + # Never consume the one-shot claim while the user is opted out, or they + # would silently lose their install event if they later opt in. + return None + + path = _install_state_path() + upgrading = not (data_dir_was_empty() if was_empty is None else was_empty) + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + # Durable before this returns. The O_EXCL open is what makes the + # claim exclusive, so it cannot be replaced by a temp-and-rename + # without losing that, which leaves the content as the thing to make + # safe. A kill between the open and this fsync used to leave a marker + # that exists but parses to nothing: is_first_run reads it as claimed + # and claim_version_change cannot read a version out of it. + stream.flush() + os.fsync(stream.fileno()) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def _repair_install_state(path: Path) -> None: + """Rewrite an unparseable marker so version tracking can resume.""" + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text( + json.dumps({"plugin_version": memory_core.PLUGIN_VERSION, "repaired_at": memory_core.utc_now()}), + encoding="utf-8", + ) + temporary.replace(path) + except OSError: + pass + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except OSError: + return None + except json.JSONDecodeError: + # A crash between O_EXCL and the write leaves an empty marker. Left + # alone it disables every future upgrade event on this machine, because + # claim_install sees the file and this function cannot parse it. + state = None + if not isinstance(state, dict): + _repair_install_state(path) + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + # Claim the transition with an exclusive sentinel before rewriting the + # marker. A plain read-modify-write let every concurrently starting session + # observe the old version and each record its own upgrade — and the first + # session after a version bump is exactly when several agent windows restart + # together. + sentinel = path.with_name(f"upgraded-{memory_core.PLUGIN_VERSION}") + try: + os.close(os.open(sentinel, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600)) + except FileExistsError: + return None + except OSError: + return None + + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + temporary = path.with_suffix(f".{os.getpid()}.tmp") + try: + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + # Release the claim. The marker still records the old version, so + # without this the sentinel makes claim_version_change return early on + # every later run and this version's upgrade is never recorded again. + for leftover in (sentinel, temporary): + try: + leftover.unlink() + except OSError: + pass + return None + return previous def record( @@ -633,21 +800,72 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and fingerprint: + recorded = identity.get("key_fingerprint", "") + if recorded == fingerprint: + return email, "" + if not recorded: + # Rows written before fingerprints existed. Verify rather than + # adopt: a key changed before the upgrade would otherwise bind the + # new key to the previous account's email, permanently, and the + # fingerprint would then agree with itself forever after. + verified = _resolve_email(key) + if not verified: + # Offline, firewalled, or the API is down. Keep the previous + # behaviour and retry on the next flush rather than dropping a + # real account attribution. Safe because the same network that + # failed /v1/ping/ is about to fail the PostHog POST, so nothing + # is delivered under the unverified identity in the meantime. + return email, "" + identity["email"] = verified + identity["key_fingerprint"] = fingerprint + _write_identity(identity) + return verified, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: + + resolved = _resolve_email(key) + if not resolved: + # The key changed and will not resolve (revoked, offline, API down). + # Reaching here with an email means the recorded fingerprint disagreed, + # so the key really did change. Drop the account and rotate: the stored + # anonymous id may already be merged into that account's person, and + # reusing it would keep the events on the profile we are trying to + # leave. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + # Alias only when going anonymous -> email for the first time. Once an anon + # id has been merged into an account it must never be offered again: an + # alias naming an already-identified id is what could link two real people. + previous = "" if (email or identity.get("aliased")) else identity.get("anonymous_id", "") + if previous: + identity["aliased"] = True + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: diff --git a/integrations/claude-code-plugin/core/hook_runner.py b/integrations/claude-code-plugin/core/hook_runner.py index 2a2adb557..b3d8a3210 100644 --- a/integrations/claude-code-plugin/core/hook_runner.py +++ b/integrations/claude-code-plugin/core/hook_runner.py @@ -290,6 +290,11 @@ def run( if args.plugin_data_dir: os.environ[data_dir_env] = args.plugin_data_dir + # Snapshot BEFORE anything writes to the data dir: cache_plugin_api_key + # writes `api-key` and EvidenceStore creates `evidence.sqlite3`, so asking + # after them always saw content and every fresh install reported an upgrade. + data_dir_was_empty = telemetry.data_dir_was_empty() + cache_plugin_api_key() if args.action == "session-start": clear_stale_api_key_cache() @@ -305,8 +310,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install(was_empty=data_dir_was_empty) + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/claude-code-plugin/core/telemetry.py b/integrations/claude-code-plugin/core/telemetry.py index a4375f002..c1fc0084c 100644 --- a/integrations/claude-code-plugin/core/telemetry.py +++ b/integrations/claude-code-plugin/core/telemetry.py @@ -302,9 +302,176 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _rotate_anonymous_id(identity: dict[str, str]) -> str: + """Mint a fresh anonymous id because the account context is gone. + + The previous id may already have been merged into a person profile by an + $identify, and that merge is permanent. Reusing it after a logout or a key + change attributes everything that follows to the account that just went + away, which is the same misattribution the key fingerprint exists to stop, + only arriving through the anonymous path instead. + + `aliased` is cleared with it: the new id has never been merged, so it is + eligible to be aliased into whatever account comes next. + """ + created = f"code-anon-{uuid.uuid4().hex}" + identity["anonymous_id"] = created + identity.pop("aliased", None) + _write_identity(identity) + return created + + +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def data_dir_was_empty() -> bool: + """Whether the data directory is untouched. Call BEFORE anything writes to it. + + hook_runner reaches claim_install() only after cache_plugin_api_key() has + written `api-key` and EvidenceStore() has created `evidence.sqlite3`, so + asking at claim time always saw content and every fresh install reported an + upgrade. The caller snapshots this at the top of the run instead. + """ + return not _data_dir_has_content() + + +def claim_install(was_empty: bool | None = None) -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + + `was_empty` must come from data_dir_was_empty() called before this process + wrote anything. Omitting it falls back to checking now, which is only + correct for a caller that has touched nothing. + """ + if not is_enabled(): + # Never consume the one-shot claim while the user is opted out, or they + # would silently lose their install event if they later opt in. + return None + + path = _install_state_path() + upgrading = not (data_dir_was_empty() if was_empty is None else was_empty) + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + # Durable before this returns. The O_EXCL open is what makes the + # claim exclusive, so it cannot be replaced by a temp-and-rename + # without losing that, which leaves the content as the thing to make + # safe. A kill between the open and this fsync used to leave a marker + # that exists but parses to nothing: is_first_run reads it as claimed + # and claim_version_change cannot read a version out of it. + stream.flush() + os.fsync(stream.fileno()) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def _repair_install_state(path: Path) -> None: + """Rewrite an unparseable marker so version tracking can resume.""" + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text( + json.dumps({"plugin_version": memory_core.PLUGIN_VERSION, "repaired_at": memory_core.utc_now()}), + encoding="utf-8", + ) + temporary.replace(path) + except OSError: + pass + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except OSError: + return None + except json.JSONDecodeError: + # A crash between O_EXCL and the write leaves an empty marker. Left + # alone it disables every future upgrade event on this machine, because + # claim_install sees the file and this function cannot parse it. + state = None + if not isinstance(state, dict): + _repair_install_state(path) + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + # Claim the transition with an exclusive sentinel before rewriting the + # marker. A plain read-modify-write let every concurrently starting session + # observe the old version and each record its own upgrade — and the first + # session after a version bump is exactly when several agent windows restart + # together. + sentinel = path.with_name(f"upgraded-{memory_core.PLUGIN_VERSION}") + try: + os.close(os.open(sentinel, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600)) + except FileExistsError: + return None + except OSError: + return None + + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + temporary = path.with_suffix(f".{os.getpid()}.tmp") + try: + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + # Release the claim. The marker still records the old version, so + # without this the sentinel makes claim_version_change return early on + # every later run and this version's upgrade is never recorded again. + for leftover in (sentinel, temporary): + try: + leftover.unlink() + except OSError: + pass + return None + return previous def record( @@ -633,21 +800,72 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and fingerprint: + recorded = identity.get("key_fingerprint", "") + if recorded == fingerprint: + return email, "" + if not recorded: + # Rows written before fingerprints existed. Verify rather than + # adopt: a key changed before the upgrade would otherwise bind the + # new key to the previous account's email, permanently, and the + # fingerprint would then agree with itself forever after. + verified = _resolve_email(key) + if not verified: + # Offline, firewalled, or the API is down. Keep the previous + # behaviour and retry on the next flush rather than dropping a + # real account attribution. Safe because the same network that + # failed /v1/ping/ is about to fail the PostHog POST, so nothing + # is delivered under the unverified identity in the meantime. + return email, "" + identity["email"] = verified + identity["key_fingerprint"] = fingerprint + _write_identity(identity) + return verified, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: + + resolved = _resolve_email(key) + if not resolved: + # The key changed and will not resolve (revoked, offline, API down). + # Reaching here with an email means the recorded fingerprint disagreed, + # so the key really did change. Drop the account and rotate: the stored + # anonymous id may already be merged into that account's person, and + # reusing it would keep the events on the profile we are trying to + # leave. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + # Alias only when going anonymous -> email for the first time. Once an anon + # id has been merged into an account it must never be offered again: an + # alias naming an already-identified id is what could link two real people. + previous = "" if (email or identity.get("aliased")) else identity.get("anonymous_id", "") + if previous: + identity["aliased"] = True + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: diff --git a/integrations/claude-code-plugin/tests/test_telemetry.py b/integrations/claude-code-plugin/tests/test_telemetry.py index de0db10c6..73bf8f121 100644 --- a/integrations/claude-code-plugin/tests/test_telemetry.py +++ b/integrations/claude-code-plugin/tests/test_telemetry.py @@ -265,12 +265,150 @@ def test_an_unresolvable_key_falls_back_to_the_anonymous_id(isolated_env, monkey assert telemetry.resolve_distinct_id()[0].startswith("code-anon-") -def test_is_first_run_flips_after_the_first_identity_write(isolated_env): +def test_logging_out_does_not_leave_events_on_the_previous_account(isolated_env, monkeypatch): + """Review finding: clearing the email kept an id already merged into a person. + + The anonymous id is offered to PostHog as $anon_distinct_id on first sign-in, + and that merge is permanent. Keeping it after the key goes away means every + later anonymous event lands on the account that just left. + """ + # Run anonymously first, which is the only way an id exists to be merged. + merged = telemetry.anonymous_id() + + monkeypatch.setenv("MEM0_API_KEY", "key-for-account-a") + with patch.object(telemetry, "_resolve_email", lambda key: "a@example.com"): + identified, alias = telemetry.resolve_distinct_id() + assert identified == "a@example.com" + assert alias == merged, "the anonymous id was merged into this account" + + monkeypatch.delenv("MEM0_API_KEY", raising=False) + after_logout, logout_alias = telemetry.resolve_distinct_id() + + assert after_logout.startswith("code-anon-") + assert after_logout != merged, "reused an id already merged into the previous account" + assert logout_alias == "" + assert "aliased" not in telemetry._read_identity(), "rotated id must be aliasable again" + + +def test_a_changed_key_that_will_not_resolve_rotates_the_anonymous_id(isolated_env, monkeypatch): + """Same leak by the other route: fingerprint disagrees and the lookup fails.""" + merged = telemetry.anonymous_id() + monkeypatch.setenv("MEM0_API_KEY", "key-for-account-a") + with patch.object(telemetry, "_resolve_email", lambda key: "a@example.com"): + telemetry.resolve_distinct_id() + + monkeypatch.setenv("MEM0_API_KEY", "key-for-account-b") + with patch.object(telemetry, "_resolve_email", lambda key: ""): + after, alias = telemetry.resolve_distinct_id() + + assert after.startswith("code-anon-") + assert after != merged + assert alias == "" + assert "email" not in telemetry._read_identity() + + +def test_a_legacy_cached_email_is_verified_before_the_key_is_bound(isolated_env, monkeypatch): + """Review finding: a key changed before upgrading bound the wrong account. + + Rows written before fingerprints existed carry an email and no fingerprint. + Adopting the current key without checking pinned that key to the previous + account's email, and every run after that agreed with itself. + """ + telemetry._write_identity({"email": "old@example.com", "anonymous_id": "code-anon-seed"}) + monkeypatch.setenv("MEM0_API_KEY", "key-for-account-b") + + with patch.object(telemetry, "_resolve_email", lambda key: "new@example.com"): + resolved, alias = telemetry.resolve_distinct_id() + + assert resolved == "new@example.com" + assert alias == "", "email to email must never alias; it merges two real people" + stored = telemetry._read_identity() + assert stored["email"] == "new@example.com" + assert stored["key_fingerprint"] == telemetry._digest("key-for-account-b") + + +def test_a_legacy_row_keeps_working_when_the_account_cannot_be_checked(isolated_env, monkeypatch): + """Firewalled users must not lose attribution, and must not bind unverified. + + The same network that fails /v1/ping/ fails the PostHog POST, so nothing is + delivered under the unverified identity while this holds. + """ + telemetry._write_identity({"email": "old@example.com"}) + monkeypatch.setenv("MEM0_API_KEY", "key-for-account-b") + + with patch.object(telemetry, "_resolve_email", lambda key: ""): + resolved, _ = telemetry.resolve_distinct_id() + + assert resolved == "old@example.com" + assert "key_fingerprint" not in telemetry._read_identity(), "bound an unverified key" + + +def test_a_failed_upgrade_claim_can_be_retried(isolated_env, monkeypatch): + """Review finding: a failed rewrite left the sentinel and suppressed forever. + + claim_version_change returns early on FileExistsError, and the marker still + holds the old version, so the upgrade for that version was never recorded + again on that machine. + """ + telemetry.claim_install() + state_path = memory_core.data_dir() / "install-state.json" + state = json.loads(state_path.read_text()) + state["plugin_version"] = "0.0.1-old" + state_path.write_text(json.dumps(state), encoding="utf-8") + + real_replace = Path.replace + + def failing_replace(self, target): + raise OSError("disk full") + + monkeypatch.setattr(Path, "replace", failing_replace) + assert telemetry.claim_version_change() is None + + monkeypatch.setattr(Path, "replace", real_replace) + assert telemetry.claim_version_change() == "0.0.1-old", "sentinel suppressed the retry" + + +def test_first_run_is_not_flipped_by_writing_the_identity_file(isolated_env): + """The identity file is written by a successful flush, not by recording. + + Keying first-run off it meant an offline user recorded code.install on every + session forever, and every 0.2.x user recorded one on their first 0.3.x run. + """ assert telemetry.is_first_run() telemetry.anonymous_id() + assert telemetry.is_first_run() + + +def test_claiming_install_ends_first_run(isolated_env): + assert telemetry.claim_install() == "install" assert not telemetry.is_first_run() +def test_install_can_only_be_claimed_once(isolated_env): + """Two sessions starting together must not both record an install.""" + assert telemetry.claim_install() == "install" + assert telemetry.claim_install() is None + + +def test_a_populated_data_dir_reads_as_an_upgrade(isolated_env): + """A fresh install has an empty data directory; anything else predates it.""" + data_dir = memory_core.data_dir() + data_dir.mkdir(parents=True, exist_ok=True) + (data_dir / "requirements.txt").write_text("mem0ai\n", encoding="utf-8") + assert telemetry.claim_install() == "upgrade" + + +def test_a_version_change_is_claimed_once(isolated_env): + telemetry.claim_install() + state_path = memory_core.data_dir() / "install-state.json" + state = json.loads(state_path.read_text()) + state["plugin_version"] = "0.0.1-old" + state_path.write_text(json.dumps(state), encoding="utf-8") + + assert telemetry.claim_version_change() == "0.0.1-old" + assert telemetry.claim_version_change() is None + + def test_spawn_flush_does_nothing_without_a_spool(isolated_env): with patch.object(telemetry.subprocess, "Popen") as popen: assert telemetry.spawn_flush() is False diff --git a/integrations/codex-plugin/core/hook_runner.py b/integrations/codex-plugin/core/hook_runner.py index 2a2adb557..b3d8a3210 100644 --- a/integrations/codex-plugin/core/hook_runner.py +++ b/integrations/codex-plugin/core/hook_runner.py @@ -290,6 +290,11 @@ def run( if args.plugin_data_dir: os.environ[data_dir_env] = args.plugin_data_dir + # Snapshot BEFORE anything writes to the data dir: cache_plugin_api_key + # writes `api-key` and EvidenceStore creates `evidence.sqlite3`, so asking + # after them always saw content and every fresh install reported an upgrade. + data_dir_was_empty = telemetry.data_dir_was_empty() + cache_plugin_api_key() if args.action == "session-start": clear_stale_api_key_cache() @@ -305,8 +310,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install(was_empty=data_dir_was_empty) + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/codex-plugin/core/telemetry.py b/integrations/codex-plugin/core/telemetry.py index a4375f002..c1fc0084c 100644 --- a/integrations/codex-plugin/core/telemetry.py +++ b/integrations/codex-plugin/core/telemetry.py @@ -302,9 +302,176 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _rotate_anonymous_id(identity: dict[str, str]) -> str: + """Mint a fresh anonymous id because the account context is gone. + + The previous id may already have been merged into a person profile by an + $identify, and that merge is permanent. Reusing it after a logout or a key + change attributes everything that follows to the account that just went + away, which is the same misattribution the key fingerprint exists to stop, + only arriving through the anonymous path instead. + + `aliased` is cleared with it: the new id has never been merged, so it is + eligible to be aliased into whatever account comes next. + """ + created = f"code-anon-{uuid.uuid4().hex}" + identity["anonymous_id"] = created + identity.pop("aliased", None) + _write_identity(identity) + return created + + +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def data_dir_was_empty() -> bool: + """Whether the data directory is untouched. Call BEFORE anything writes to it. + + hook_runner reaches claim_install() only after cache_plugin_api_key() has + written `api-key` and EvidenceStore() has created `evidence.sqlite3`, so + asking at claim time always saw content and every fresh install reported an + upgrade. The caller snapshots this at the top of the run instead. + """ + return not _data_dir_has_content() + + +def claim_install(was_empty: bool | None = None) -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + + `was_empty` must come from data_dir_was_empty() called before this process + wrote anything. Omitting it falls back to checking now, which is only + correct for a caller that has touched nothing. + """ + if not is_enabled(): + # Never consume the one-shot claim while the user is opted out, or they + # would silently lose their install event if they later opt in. + return None + + path = _install_state_path() + upgrading = not (data_dir_was_empty() if was_empty is None else was_empty) + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + # Durable before this returns. The O_EXCL open is what makes the + # claim exclusive, so it cannot be replaced by a temp-and-rename + # without losing that, which leaves the content as the thing to make + # safe. A kill between the open and this fsync used to leave a marker + # that exists but parses to nothing: is_first_run reads it as claimed + # and claim_version_change cannot read a version out of it. + stream.flush() + os.fsync(stream.fileno()) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def _repair_install_state(path: Path) -> None: + """Rewrite an unparseable marker so version tracking can resume.""" + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text( + json.dumps({"plugin_version": memory_core.PLUGIN_VERSION, "repaired_at": memory_core.utc_now()}), + encoding="utf-8", + ) + temporary.replace(path) + except OSError: + pass + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except OSError: + return None + except json.JSONDecodeError: + # A crash between O_EXCL and the write leaves an empty marker. Left + # alone it disables every future upgrade event on this machine, because + # claim_install sees the file and this function cannot parse it. + state = None + if not isinstance(state, dict): + _repair_install_state(path) + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + # Claim the transition with an exclusive sentinel before rewriting the + # marker. A plain read-modify-write let every concurrently starting session + # observe the old version and each record its own upgrade — and the first + # session after a version bump is exactly when several agent windows restart + # together. + sentinel = path.with_name(f"upgraded-{memory_core.PLUGIN_VERSION}") + try: + os.close(os.open(sentinel, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600)) + except FileExistsError: + return None + except OSError: + return None + + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + temporary = path.with_suffix(f".{os.getpid()}.tmp") + try: + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + # Release the claim. The marker still records the old version, so + # without this the sentinel makes claim_version_change return early on + # every later run and this version's upgrade is never recorded again. + for leftover in (sentinel, temporary): + try: + leftover.unlink() + except OSError: + pass + return None + return previous def record( @@ -633,21 +800,72 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and fingerprint: + recorded = identity.get("key_fingerprint", "") + if recorded == fingerprint: + return email, "" + if not recorded: + # Rows written before fingerprints existed. Verify rather than + # adopt: a key changed before the upgrade would otherwise bind the + # new key to the previous account's email, permanently, and the + # fingerprint would then agree with itself forever after. + verified = _resolve_email(key) + if not verified: + # Offline, firewalled, or the API is down. Keep the previous + # behaviour and retry on the next flush rather than dropping a + # real account attribution. Safe because the same network that + # failed /v1/ping/ is about to fail the PostHog POST, so nothing + # is delivered under the unverified identity in the meantime. + return email, "" + identity["email"] = verified + identity["key_fingerprint"] = fingerprint + _write_identity(identity) + return verified, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: + + resolved = _resolve_email(key) + if not resolved: + # The key changed and will not resolve (revoked, offline, API down). + # Reaching here with an email means the recorded fingerprint disagreed, + # so the key really did change. Drop the account and rotate: the stored + # anonymous id may already be merged into that account's person, and + # reusing it would keep the events on the profile we are trying to + # leave. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + # Alias only when going anonymous -> email for the first time. Once an anon + # id has been merged into an account it must never be offered again: an + # alias naming an already-identified id is what could link two real people. + previous = "" if (email or identity.get("aliased")) else identity.get("anonymous_id", "") + if previous: + identity["aliased"] = True + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: diff --git a/integrations/cursor-plugin/core/hook_runner.py b/integrations/cursor-plugin/core/hook_runner.py index 2a2adb557..b3d8a3210 100644 --- a/integrations/cursor-plugin/core/hook_runner.py +++ b/integrations/cursor-plugin/core/hook_runner.py @@ -290,6 +290,11 @@ def run( if args.plugin_data_dir: os.environ[data_dir_env] = args.plugin_data_dir + # Snapshot BEFORE anything writes to the data dir: cache_plugin_api_key + # writes `api-key` and EvidenceStore creates `evidence.sqlite3`, so asking + # after them always saw content and every fresh install reported an upgrade. + data_dir_was_empty = telemetry.data_dir_was_empty() + cache_plugin_api_key() if args.action == "session-start": clear_stale_api_key_cache() @@ -305,8 +310,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install(was_empty=data_dir_was_empty) + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/cursor-plugin/core/telemetry.py b/integrations/cursor-plugin/core/telemetry.py index a4375f002..c1fc0084c 100644 --- a/integrations/cursor-plugin/core/telemetry.py +++ b/integrations/cursor-plugin/core/telemetry.py @@ -302,9 +302,176 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _rotate_anonymous_id(identity: dict[str, str]) -> str: + """Mint a fresh anonymous id because the account context is gone. + + The previous id may already have been merged into a person profile by an + $identify, and that merge is permanent. Reusing it after a logout or a key + change attributes everything that follows to the account that just went + away, which is the same misattribution the key fingerprint exists to stop, + only arriving through the anonymous path instead. + + `aliased` is cleared with it: the new id has never been merged, so it is + eligible to be aliased into whatever account comes next. + """ + created = f"code-anon-{uuid.uuid4().hex}" + identity["anonymous_id"] = created + identity.pop("aliased", None) + _write_identity(identity) + return created + + +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def data_dir_was_empty() -> bool: + """Whether the data directory is untouched. Call BEFORE anything writes to it. + + hook_runner reaches claim_install() only after cache_plugin_api_key() has + written `api-key` and EvidenceStore() has created `evidence.sqlite3`, so + asking at claim time always saw content and every fresh install reported an + upgrade. The caller snapshots this at the top of the run instead. + """ + return not _data_dir_has_content() + + +def claim_install(was_empty: bool | None = None) -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + + `was_empty` must come from data_dir_was_empty() called before this process + wrote anything. Omitting it falls back to checking now, which is only + correct for a caller that has touched nothing. + """ + if not is_enabled(): + # Never consume the one-shot claim while the user is opted out, or they + # would silently lose their install event if they later opt in. + return None + + path = _install_state_path() + upgrading = not (data_dir_was_empty() if was_empty is None else was_empty) + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + # Durable before this returns. The O_EXCL open is what makes the + # claim exclusive, so it cannot be replaced by a temp-and-rename + # without losing that, which leaves the content as the thing to make + # safe. A kill between the open and this fsync used to leave a marker + # that exists but parses to nothing: is_first_run reads it as claimed + # and claim_version_change cannot read a version out of it. + stream.flush() + os.fsync(stream.fileno()) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def _repair_install_state(path: Path) -> None: + """Rewrite an unparseable marker so version tracking can resume.""" + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text( + json.dumps({"plugin_version": memory_core.PLUGIN_VERSION, "repaired_at": memory_core.utc_now()}), + encoding="utf-8", + ) + temporary.replace(path) + except OSError: + pass + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except OSError: + return None + except json.JSONDecodeError: + # A crash between O_EXCL and the write leaves an empty marker. Left + # alone it disables every future upgrade event on this machine, because + # claim_install sees the file and this function cannot parse it. + state = None + if not isinstance(state, dict): + _repair_install_state(path) + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + # Claim the transition with an exclusive sentinel before rewriting the + # marker. A plain read-modify-write let every concurrently starting session + # observe the old version and each record its own upgrade — and the first + # session after a version bump is exactly when several agent windows restart + # together. + sentinel = path.with_name(f"upgraded-{memory_core.PLUGIN_VERSION}") + try: + os.close(os.open(sentinel, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600)) + except FileExistsError: + return None + except OSError: + return None + + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + temporary = path.with_suffix(f".{os.getpid()}.tmp") + try: + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + # Release the claim. The marker still records the old version, so + # without this the sentinel makes claim_version_change return early on + # every later run and this version's upgrade is never recorded again. + for leftover in (sentinel, temporary): + try: + leftover.unlink() + except OSError: + pass + return None + return previous def record( @@ -633,21 +800,72 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and fingerprint: + recorded = identity.get("key_fingerprint", "") + if recorded == fingerprint: + return email, "" + if not recorded: + # Rows written before fingerprints existed. Verify rather than + # adopt: a key changed before the upgrade would otherwise bind the + # new key to the previous account's email, permanently, and the + # fingerprint would then agree with itself forever after. + verified = _resolve_email(key) + if not verified: + # Offline, firewalled, or the API is down. Keep the previous + # behaviour and retry on the next flush rather than dropping a + # real account attribution. Safe because the same network that + # failed /v1/ping/ is about to fail the PostHog POST, so nothing + # is delivered under the unverified identity in the meantime. + return email, "" + identity["email"] = verified + identity["key_fingerprint"] = fingerprint + _write_identity(identity) + return verified, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: + + resolved = _resolve_email(key) + if not resolved: + # The key changed and will not resolve (revoked, offline, API down). + # Reaching here with an email means the recorded fingerprint disagreed, + # so the key really did change. Drop the account and rotate: the stored + # anonymous id may already be merged into that account's person, and + # reusing it would keep the events on the profile we are trying to + # leave. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + # Alias only when going anonymous -> email for the first time. Once an anon + # id has been merged into an account it must never be offered again: an + # alias naming an already-identified id is what could link two real people. + previous = "" if (email or identity.get("aliased")) else identity.get("anonymous_id", "") + if previous: + identity["aliased"] = True + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: diff --git a/integrations/kimi-plugin/core/hook_runner.py b/integrations/kimi-plugin/core/hook_runner.py index 2a2adb557..b3d8a3210 100644 --- a/integrations/kimi-plugin/core/hook_runner.py +++ b/integrations/kimi-plugin/core/hook_runner.py @@ -290,6 +290,11 @@ def run( if args.plugin_data_dir: os.environ[data_dir_env] = args.plugin_data_dir + # Snapshot BEFORE anything writes to the data dir: cache_plugin_api_key + # writes `api-key` and EvidenceStore creates `evidence.sqlite3`, so asking + # after them always saw content and every fresh install reported an upgrade. + data_dir_was_empty = telemetry.data_dir_was_empty() + cache_plugin_api_key() if args.action == "session-start": clear_stale_api_key_cache() @@ -305,8 +310,19 @@ def run( return 0 if args.action == "session-start": - if telemetry.is_first_run(): + # Claims the marker atomically and says which event to record, so a + # second session starting alongside this one cannot record it too. + first_event = telemetry.claim_install(was_empty=data_dir_was_empty) + if first_event == "install": telemetry.record("install") + elif first_event == "upgrade": + # First run after a build that never wrote the marker; the + # predecessor version was never recorded anywhere. + telemetry.record("upgrade", from_version="pre-0.3") + else: + previous = telemetry.claim_version_change() + if previous: + telemetry.record("upgrade", from_version=previous) recovered = recover_pending_handoffs() record_session_start(store, hook_input) if recovered: diff --git a/integrations/kimi-plugin/core/telemetry.py b/integrations/kimi-plugin/core/telemetry.py index a4375f002..c1fc0084c 100644 --- a/integrations/kimi-plugin/core/telemetry.py +++ b/integrations/kimi-plugin/core/telemetry.py @@ -302,9 +302,176 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _rotate_anonymous_id(identity: dict[str, str]) -> str: + """Mint a fresh anonymous id because the account context is gone. + + The previous id may already have been merged into a person profile by an + $identify, and that merge is permanent. Reusing it after a logout or a key + change attributes everything that follows to the account that just went + away, which is the same misattribution the key fingerprint exists to stop, + only arriving through the anonymous path instead. + + `aliased` is cleared with it: the new id has never been merged, so it is + eligible to be aliased into whatever account comes next. + """ + created = f"code-anon-{uuid.uuid4().hex}" + identity["anonymous_id"] = created + identity.pop("aliased", None) + _write_identity(identity) + return created + + +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def data_dir_was_empty() -> bool: + """Whether the data directory is untouched. Call BEFORE anything writes to it. + + hook_runner reaches claim_install() only after cache_plugin_api_key() has + written `api-key` and EvidenceStore() has created `evidence.sqlite3`, so + asking at claim time always saw content and every fresh install reported an + upgrade. The caller snapshots this at the top of the run instead. + """ + return not _data_dir_has_content() + + +def claim_install(was_empty: bool | None = None) -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + + `was_empty` must come from data_dir_was_empty() called before this process + wrote anything. Omitting it falls back to checking now, which is only + correct for a caller that has touched nothing. + """ + if not is_enabled(): + # Never consume the one-shot claim while the user is opted out, or they + # would silently lose their install event if they later opt in. + return None + + path = _install_state_path() + upgrading = not (data_dir_was_empty() if was_empty is None else was_empty) + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + # Durable before this returns. The O_EXCL open is what makes the + # claim exclusive, so it cannot be replaced by a temp-and-rename + # without losing that, which leaves the content as the thing to make + # safe. A kill between the open and this fsync used to leave a marker + # that exists but parses to nothing: is_first_run reads it as claimed + # and claim_version_change cannot read a version out of it. + stream.flush() + os.fsync(stream.fileno()) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def _repair_install_state(path: Path) -> None: + """Rewrite an unparseable marker so version tracking can resume.""" + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text( + json.dumps({"plugin_version": memory_core.PLUGIN_VERSION, "repaired_at": memory_core.utc_now()}), + encoding="utf-8", + ) + temporary.replace(path) + except OSError: + pass + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except OSError: + return None + except json.JSONDecodeError: + # A crash between O_EXCL and the write leaves an empty marker. Left + # alone it disables every future upgrade event on this machine, because + # claim_install sees the file and this function cannot parse it. + state = None + if not isinstance(state, dict): + _repair_install_state(path) + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + # Claim the transition with an exclusive sentinel before rewriting the + # marker. A plain read-modify-write let every concurrently starting session + # observe the old version and each record its own upgrade — and the first + # session after a version bump is exactly when several agent windows restart + # together. + sentinel = path.with_name(f"upgraded-{memory_core.PLUGIN_VERSION}") + try: + os.close(os.open(sentinel, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600)) + except FileExistsError: + return None + except OSError: + return None + + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + temporary = path.with_suffix(f".{os.getpid()}.tmp") + try: + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + # Release the claim. The marker still records the old version, so + # without this the sentinel makes claim_version_change return early on + # every later run and this version's upgrade is never recorded again. + for leftover in (sentinel, temporary): + try: + leftover.unlink() + except OSError: + pass + return None + return previous def record( @@ -633,21 +800,72 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and fingerprint: + recorded = identity.get("key_fingerprint", "") + if recorded == fingerprint: + return email, "" + if not recorded: + # Rows written before fingerprints existed. Verify rather than + # adopt: a key changed before the upgrade would otherwise bind the + # new key to the previous account's email, permanently, and the + # fingerprint would then agree with itself forever after. + verified = _resolve_email(key) + if not verified: + # Offline, firewalled, or the API is down. Keep the previous + # behaviour and retry on the next flush rather than dropping a + # real account attribution. Safe because the same network that + # failed /v1/ping/ is about to fail the PostHog POST, so nothing + # is delivered under the unverified identity in the meantime. + return email, "" + identity["email"] = verified + identity["key_fingerprint"] = fingerprint + _write_identity(identity) + return verified, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: + + resolved = _resolve_email(key) + if not resolved: + # The key changed and will not resolve (revoked, offline, API down). + # Reaching here with an email means the recorded fingerprint disagreed, + # so the key really did change. Drop the account and rotate: the stored + # anonymous id may already be merged into that account's person, and + # reusing it would keep the events on the profile we are trying to + # leave. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + # Alias only when going anonymous -> email for the first time. Once an anon + # id has been merged into an account it must never be offered again: an + # alias naming an already-identified id is what could link two real people. + previous = "" if (email or identity.get("aliased")) else identity.get("anonymous_id", "") + if previous: + identity["aliased"] = True + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: diff --git a/integrations/mem0-agent-plugin/core/telemetry.py b/integrations/mem0-agent-plugin/core/telemetry.py index a4375f002..c1fc0084c 100644 --- a/integrations/mem0-agent-plugin/core/telemetry.py +++ b/integrations/mem0-agent-plugin/core/telemetry.py @@ -302,9 +302,176 @@ def anonymous_id(identity: dict[str, str] | None = None) -> str: return created +def _rotate_anonymous_id(identity: dict[str, str]) -> str: + """Mint a fresh anonymous id because the account context is gone. + + The previous id may already have been merged into a person profile by an + $identify, and that merge is permanent. Reusing it after a logout or a key + change attributes everything that follows to the account that just went + away, which is the same misattribution the key fingerprint exists to stop, + only arriving through the anonymous path instead. + + `aliased` is cleared with it: the new id has never been merged, so it is + eligible to be aliased into whatever account comes next. + """ + created = f"code-anon-{uuid.uuid4().hex}" + identity["anonymous_id"] = created + identity.pop("aliased", None) + _write_identity(identity) + return created + + +def _install_state_path() -> Path: + return memory_core.data_dir() / "install-state.json" + + def is_first_run() -> bool: - """Whether this machine has never recorded a plugin event before.""" - return not _identity_path().exists() + """Whether install has never been recorded on this machine. + + Deliberately NOT the identity file. That file is only written by a + successful flush, so an offline or firewalled user recorded code.install on + every single session, forever — and every 0.2.x user recorded one on their + first 0.3.x session because 0.2.x never wrote it at all. + """ + return not _install_state_path().exists() + + +def data_dir_was_empty() -> bool: + """Whether the data directory is untouched. Call BEFORE anything writes to it. + + hook_runner reaches claim_install() only after cache_plugin_api_key() has + written `api-key` and EvidenceStore() has created `evidence.sqlite3`, so + asking at claim time always saw content and every fresh install reported an + upgrade. The caller snapshots this at the top of the run instead. + """ + return not _data_dir_has_content() + + +def claim_install(was_empty: bool | None = None) -> str | None: + """Claim the one install/upgrade record for this machine, atomically. + + Returns the event to record ("install" or "upgrade"), or None if another + session already claimed it. O_CREAT|O_EXCL so two sessions starting together + cannot both win. + + `was_empty` must come from data_dir_was_empty() called before this process + wrote anything. Omitting it falls back to checking now, which is only + correct for a caller that has touched nothing. + """ + if not is_enabled(): + # Never consume the one-shot claim while the user is opted out, or they + # would silently lose their install event if they later opt in. + return None + + path = _install_state_path() + upgrading = not (data_dir_was_empty() if was_empty is None else was_empty) + try: + path.parent.mkdir(parents=True, exist_ok=True) + handle = os.open(path, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600) + except FileExistsError: + return None + except OSError: + return None + try: + with os.fdopen(handle, "w", encoding="utf-8") as stream: + json.dump( + { + "plugin_version": memory_core.PLUGIN_VERSION, + "installed_at": memory_core.utc_now(), + "upgraded": upgrading, + }, + stream, + ) + # Durable before this returns. The O_EXCL open is what makes the + # claim exclusive, so it cannot be replaced by a temp-and-rename + # without losing that, which leaves the content as the thing to make + # safe. A kill between the open and this fsync used to leave a marker + # that exists but parses to nothing: is_first_run reads it as claimed + # and claim_version_change cannot read a version out of it. + stream.flush() + os.fsync(stream.fileno()) + except OSError: + pass + return "upgrade" if upgrading else "install" + + +def _data_dir_has_content() -> bool: + """Whether anything predates this session in the plugin data directory.""" + try: + for entry in memory_core.data_dir().iterdir(): + if entry.name != "install-state.json": + return True + except OSError: + pass + return False + + +def _repair_install_state(path: Path) -> None: + """Rewrite an unparseable marker so version tracking can resume.""" + try: + temporary = path.with_suffix(f".{os.getpid()}.tmp") + temporary.write_text( + json.dumps({"plugin_version": memory_core.PLUGIN_VERSION, "repaired_at": memory_core.utc_now()}), + encoding="utf-8", + ) + temporary.replace(path) + except OSError: + pass + + +def claim_version_change() -> str | None: + """Return the previously recorded version if it differs, updating the marker. + + Only meaningful once the marker exists — the first transition into 0.3.x has + no recorded predecessor and reports "pre-0.3" instead. Claiming by rewriting + the marker means the next session sees no change and records nothing. + """ + path = _install_state_path() + try: + state = json.loads(path.read_text(encoding="utf-8")) + except OSError: + return None + except json.JSONDecodeError: + # A crash between O_EXCL and the write leaves an empty marker. Left + # alone it disables every future upgrade event on this machine, because + # claim_install sees the file and this function cannot parse it. + state = None + if not isinstance(state, dict): + _repair_install_state(path) + return None + previous = str(state.get("plugin_version") or "") + if not previous or previous == memory_core.PLUGIN_VERSION: + return None + # Claim the transition with an exclusive sentinel before rewriting the + # marker. A plain read-modify-write let every concurrently starting session + # observe the old version and each record its own upgrade — and the first + # session after a version bump is exactly when several agent windows restart + # together. + sentinel = path.with_name(f"upgraded-{memory_core.PLUGIN_VERSION}") + try: + os.close(os.open(sentinel, os.O_CREAT | os.O_EXCL | os.O_WRONLY, 0o600)) + except FileExistsError: + return None + except OSError: + return None + + state["plugin_version"] = memory_core.PLUGIN_VERSION + state["upgraded_at"] = memory_core.utc_now() + temporary = path.with_suffix(f".{os.getpid()}.tmp") + try: + temporary.write_text(json.dumps(state), encoding="utf-8") + temporary.replace(path) + except OSError: + # Release the claim. The marker still records the old version, so + # without this the sentinel makes claim_version_change return early on + # every later run and this version's upgrade is never recorded again. + for leftover in (sentinel, temporary): + try: + leftover.unlink() + except OSError: + pass + return None + return previous def record( @@ -633,21 +800,72 @@ def _post(payload: dict[str, Any], url: str) -> bool: def resolve_distinct_id() -> tuple[str, str]: - """Return the PostHog distinct id and the anonymous id it replaced, if any.""" + """Return the PostHog distinct id and the anonymous id it replaced, if any. + + The second value becomes a PostHog $identify alias. It is ONLY ever an + anonymous id: aliasing one account email to another merges two real person + profiles and cannot be undone, so a key that now belongs to a different + account re-resolves with no alias. + """ identity = _read_identity() - email = identity.get("email", "") - if email: - return email, "" key = memory_core.api_key() + fingerprint = _digest(key) if key else "" + email = identity.get("email", "") + + if email and fingerprint: + recorded = identity.get("key_fingerprint", "") + if recorded == fingerprint: + return email, "" + if not recorded: + # Rows written before fingerprints existed. Verify rather than + # adopt: a key changed before the upgrade would otherwise bind the + # new key to the previous account's email, permanently, and the + # fingerprint would then agree with itself forever after. + verified = _resolve_email(key) + if not verified: + # Offline, firewalled, or the API is down. Keep the previous + # behaviour and retry on the next flush rather than dropping a + # real account attribution. Safe because the same network that + # failed /v1/ping/ is about to fail the PostHog POST, so nothing + # is delivered under the unverified identity in the meantime. + return email, "" + identity["email"] = verified + identity["key_fingerprint"] = fingerprint + _write_identity(identity) + return verified, "" + if not key: + # No key to verify the account with; do not keep attributing to it. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - email = _resolve_email(key) - if not email: + + resolved = _resolve_email(key) + if not resolved: + # The key changed and will not resolve (revoked, offline, API down). + # Reaching here with an email means the recorded fingerprint disagreed, + # so the key really did change. Drop the account and rotate: the stored + # anonymous id may already be merged into that account's person, and + # reusing it would keep the events on the profile we are trying to + # leave. + if email: + identity.pop("email", None) + identity.pop("key_fingerprint", None) + return _rotate_anonymous_id(identity), "" return anonymous_id(identity), "" - previous = identity.get("anonymous_id", "") - identity["email"] = email + + # Alias only when going anonymous -> email for the first time. Once an anon + # id has been merged into an account it must never be offered again: an + # alias naming an already-identified id is what could link two real people. + previous = "" if (email or identity.get("aliased")) else identity.get("anonymous_id", "") + if previous: + identity["aliased"] = True + identity["email"] = resolved + identity["key_fingerprint"] = fingerprint _write_identity(identity) - return email, previous + return resolved, previous def flush() -> int: From 1a5c7ad28c67ae04381998eb69d829fd1de55de9 Mon Sep 17 00:00:00 2001 From: Saket Aryan Date: Fri, 18 Sep 2026 14:13:11 +0530 Subject: [PATCH 12/55] feat(integrations): declare which surface each client is, and its version (#7326) --- cli/node/src/backend/platform.ts | 3 +- cli/python/src/mem0_cli/backend/platform.py | 3 +- integrations/AGENTS.md | 43 +++++++ integrations/agent-plugin-core/build/build.py | 16 ++- .../agent-plugin-core/python/memory_core.py | 41 +++++- .../agent-plugin-core/tests/test_build.py | 32 +++++ .../tests/test_uninitialised_identity.py | 27 ++++ .../antigravity-plugin/core/_harness_id.py | 2 + .../antigravity-plugin/core/memory_core.py | 41 +++++- .../claude-code-plugin/core/_harness_id.py | 2 + .../claude-code-plugin/core/memory_core.py | 41 +++++- integrations/codex-plugin/core/_harness_id.py | 2 + integrations/codex-plugin/core/memory_core.py | 41 +++++- .../cursor-plugin/core/_harness_id.py | 2 + .../cursor-plugin/core/memory_core.py | 41 +++++- integrations/deepseek-plugin/src/index.ts | 5 +- integrations/kimi-plugin/core/_harness_id.py | 2 + integrations/kimi-plugin/core/memory_core.py | 41 +++++- .../mem0-agent-plugin/core/_harness_id.py | 4 +- .../mem0-agent-plugin/core/memory_core.py | 41 +++++- .../pi-agent-plugin/src/attribution.test.ts | 80 ++++++++++++ .../pi-agent-plugin/src/attribution.ts | 65 ++++++++++ integrations/pi-agent-plugin/src/commands.ts | 16 ++- integrations/pi-agent-plugin/src/entry.ts | 6 + integrations/vercel-ai-sdk/src/mem0-utils.ts | 19 ++- integrations/vercel-ai-sdk/tsconfig.json | 1 + integrations/vercel-ai-sdk/tsup.config.ts | 7 ++ mem0-ts/src/client/mem0.ts | 61 +++++++++ mem0-ts/src/client/mem0.types.ts | 3 + mem0/client/main.py | 118 ++++++++++++++---- tests/test_client_surface_headers.py | 63 ++++++++++ 31 files changed, 812 insertions(+), 57 deletions(-) create mode 100644 integrations/pi-agent-plugin/src/attribution.test.ts create mode 100644 integrations/pi-agent-plugin/src/attribution.ts create mode 100644 tests/test_client_surface_headers.py diff --git a/cli/node/src/backend/platform.ts b/cli/node/src/backend/platform.ts index 705a3d470..65a4b6228 100644 --- a/cli/node/src/backend/platform.ts +++ b/cli/node/src/backend/platform.ts @@ -31,7 +31,8 @@ export class PlatformBackend implements Backend { this.headers = { Authorization: `Token ${config.apiKey}`, "Content-Type": "application/json", - "X-Mem0-Source": "cli", + "X-Mem0-Source": "CLI", + "X-Mem0-Client": `mem0-cli-node/${CLI_VERSION}`, "X-Mem0-Client-Language": "node", "X-Mem0-Client-Version": CLI_VERSION, }; diff --git a/cli/python/src/mem0_cli/backend/platform.py b/cli/python/src/mem0_cli/backend/platform.py index 1d153da9c..a9ce60df1 100644 --- a/cli/python/src/mem0_cli/backend/platform.py +++ b/cli/python/src/mem0_cli/backend/platform.py @@ -27,7 +27,8 @@ class PlatformBackend(Backend): headers={ "Authorization": f"Token {config.api_key}", "Content-Type": "application/json", - "X-Mem0-Source": "cli", + "X-Mem0-Source": "CLI", + "X-Mem0-Client": f"mem0-cli-python/{__version__}", "X-Mem0-Client-Language": "python", "X-Mem0-Client-Version": __version__, }, diff --git a/integrations/AGENTS.md b/integrations/AGENTS.md index c129dd48b..221c8206f 100644 --- a/integrations/AGENTS.md +++ b/integrations/AGENTS.md @@ -49,6 +49,48 @@ Run the type check after every TypeScript change: `pnpm run typecheck` or `tsc - - **`zapier-mem0/`** is a Zapier Platform CLI app: add, search, get, delete. It deploys to Zapier, not npm, so it is **not** in the release router. Deploy it with `gh workflow run zapier-mem0-cd.yml --ref main` (needs the `ZAPIER_DEPLOY_KEY` secret). - **`mem0-strands/`** is a native Strands `MemoryStore` (Python, published to PyPI as `mem0-strands`). It plugs into the Strands `MemoryManager` for automatic recall and server-side extraction, over the hosted Mem0 platform or self-hosted Mem0 OSS. The package lives under `mem0-strands/python/`. +## Surface attribution + +Every integration tells the Mem0 platform which surface it is. Three headers, +and the rules on them are what keep one layer from erasing another: + +| Header | Carries | Rule | +|--------|---------|------| +| `X-Mem0-Source` | one canonical source value | **set-once** — write only if absent | +| `X-Application` | the host app it runs inside | **set-once** — write only if absent | +| `X-Mem0-Client` | `name/version`, outermost first | **append-only** — add yourself, never replace | + +Set-once means check-then-set, never assignment. An integration that wraps the +SDK is the outermost layer and sets the source; the SDK underneath defers to it. +Assignment is exactly how every agent plugin came to be indistinguishable from +every other one at the platform. + +How to declare it from an integration, in order of preference: + +1. Send the headers yourself, if you make the HTTP call directly. +2. Pass `source` in the call options, if you go through an SDK. +3. Set `MEM0_SOURCE` / `MEM0_APPLICATION` / `MEM0_CLIENT_STACK` in the + environment before constructing the client. The SDKs read these and defer to + anything already present. + +Append-only applies where a stack can actually form: an SDK handed a client that +already carries `X-Mem0-Client` appends itself rather than replacing. An SDK +constructed with no outer context simply reports itself, which is correct — it +is the outermost layer in that process. + +The backend recognizes a fixed list of source values and buckets everything else +into `OTHERS`. A new value has to land in the platform's `EventSource` enum, so +do not invent one without that change going in too. + +`X-Application` is allowlisted the same way, and this one has a rule of its own: +**omit the header when you do not know the host.** A value outside the allowlist +is discarded server-side, so guessing produces an event that claims an +attribution we do not actually have. The portable bundle is the case that +matters. It runs in whatever editor a user drops it into, so its build leaves +`PLATFORM_APPLICATION` empty and `memory_core` sends no header at all, while the +native bundles each name the host they were generated for. If you add a build +target, decide which of those two it is. + ## Adding an integration 1. For a native coding-agent host, add `integrations/-plugin/` with `plugin-build.json`, its manifest, and a thin adapter, then generate its shared runtime. Portable clients use the single `mem0-agent-plugin/` package. Independent TypeScript integrations stay self-contained and import shared lifecycle behavior from `agent-plugin-core/typescript/`. @@ -59,3 +101,4 @@ Run the type check after every TypeScript change: `pnpm run typecheck` or `tsc - 5. If it is a Claude Code or editor marketplace plugin, register the generated native bundle path in the applicable marketplace files. Preserve the existing public plugin name. 6. Document it under `docs/integrations/` and add the page to `docs/docs.json` and `docs/llms.txt`. 7. Add rows to the table above and to the CI/CD tables in [`../.github/AGENTS.md`](../.github/AGENTS.md). +8. Send the three headers in [Surface attribution](#surface-attribution), and land the matching `EventSource` value on the platform in the same week. Until it exists, your traffic reports as `OTHERS`. diff --git a/integrations/agent-plugin-core/build/build.py b/integrations/agent-plugin-core/build/build.py index e675efb02..3059b9b1f 100644 --- a/integrations/agent-plugin-core/build/build.py +++ b/integrations/agent-plugin-core/build/build.py @@ -81,15 +81,23 @@ def replace_output(staged: Path, output: Path) -> Path: return output -def _render_harness_id(host: str) -> str: +def _render_harness_id(host: str, *, portable: bool = False) -> str: """Emit core/_harness_id.py for one host. Carries both vocabularies from a single definition: the PostHog `source` tag and the platform's X-Mem0-Source / X-Application pair. Keeping them together is what stops the two from drifting into separate vocabularies for the same thing. + + The portable bundle runs in whatever editor a user drops it into, so it does + not know its host and must not guess one. HARNESS_ID stays "coding-agent", + which is true and useful for grouping in PostHog, but PLATFORM_APPLICATION is + left empty: X-Application names a real host app, is checked against an + allowlist server-side, and a value that is always discarded is worse than no + value -- it reads like an attribution we have and do not. """ tag = host.upper().replace("-", "_") + "_PLUGIN" + application = "" if portable else host return ( '"""Generated by integrations/agent-plugin-core/build/build.py. Do not edit."""\n' "\n" @@ -98,8 +106,10 @@ def _render_harness_id(host: str) -> str: "\n" "# Platform-side vocabulary (mem0_event.source + X-Application). The whole\n" "# plugin family is one source; which editor it runs in is the application.\n" + "# An empty application means the host is unknown, and memory_core omits\n" + "# the header entirely rather than sending a placeholder.\n" 'PLATFORM_SOURCE = "MEM0_PLUGIN"\n' - f'PLATFORM_APPLICATION = "{host}"\n' + f'PLATFORM_APPLICATION = "{application}"\n' ) @@ -122,7 +132,7 @@ def _bundle_python( # to call telemetry.init(). mcp_server.py and the detached telemetry.py sender # never did, which is how MCP searches reported harness=generic and every # batch they drained was labelled MEM0_PLUGIN regardless of the real host. - (core / "_harness_id.py").write_text(_render_harness_id(host), encoding="utf-8") + (core / "_harness_id.py").write_text(_render_harness_id(host, portable=portable), encoding="utf-8") values = { "PLUGIN_ROOT": plugin_root, diff --git a/integrations/agent-plugin-core/python/memory_core.py b/integrations/agent-plugin-core/python/memory_core.py index 77d7a2b80..d350e76d2 100644 --- a/integrations/agent-plugin-core/python/memory_core.py +++ b/integrations/agent-plugin-core/python/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,13 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body or + # the query string, never from metadata, which is where this used to + # sit. The X-Mem0-Source header is also read, but only from the + # platform release that ships alongside this change, so the body value + # is what makes attribution work on both. The harness tag stays in + # metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2558,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/agent-plugin-core/tests/test_build.py b/integrations/agent-plugin-core/tests/test_build.py index 54b5e5c6a..23295cc38 100644 --- a/integrations/agent-plugin-core/tests/test_build.py +++ b/integrations/agent-plugin-core/tests/test_build.py @@ -70,6 +70,38 @@ def test_portable_bundle_is_conformant_and_self_contained(tmp_path: Path) -> Non assert not any(path.is_symlink() for path in root.rglob("*")) +def _harness_identity(root: Path) -> dict[str, str]: + """Read the generated core/_harness_id.py without importing it.""" + values: dict[str, str] = {} + for line in (root / "core" / "_harness_id.py").read_text(encoding="utf-8").splitlines(): + if "=" in line and not line.lstrip().startswith("#"): + name, _, raw = line.partition("=") + values[name.strip()] = raw.strip().strip('"') + return values + + +def test_the_portable_bundle_declares_no_host_application(tmp_path: Path) -> None: + """It runs in whatever editor a user drops it into, so it cannot know the host. + + X-Application is allowlisted server-side. A guessed value is silently dropped + there, which is the worst outcome: the wire says we know the host and the + stored event says we do not. + """ + identity = _harness_identity(build("mem0-agent-plugin", "portable", tmp_path / "portable")) + + assert identity["PLATFORM_APPLICATION"] == "" + # The PostHog-side label is still useful for grouping and stays populated. + assert identity["HARNESS_ID"] == "coding-agent" + assert identity["PLATFORM_SOURCE"] == "MEM0_PLUGIN" + + +@pytest.mark.parametrize("host", ["claude-code", "cursor", "codex", "kimi", "antigravity"]) +def test_a_native_bundle_names_the_host_it_was_built_for(host: str, tmp_path: Path) -> None: + identity = _harness_identity(build(host, "native", tmp_path / host)) + + assert identity["PLATFORM_APPLICATION"] == host + + @pytest.mark.parametrize("host", ["claude-code", "cursor", "codex", "kimi", "antigravity"]) def test_native_bundle_is_self_contained(host: str, tmp_path: Path) -> None: root = build(host, "native", tmp_path / host) diff --git a/integrations/agent-plugin-core/tests/test_uninitialised_identity.py b/integrations/agent-plugin-core/tests/test_uninitialised_identity.py index 7d48dbcc3..74a31fa5c 100644 --- a/integrations/agent-plugin-core/tests/test_uninitialised_identity.py +++ b/integrations/agent-plugin-core/tests/test_uninitialised_identity.py @@ -179,6 +179,33 @@ def test_source_tag_defaults_agree_between_the_two_modules(): assert left == right == "KIMI_PLUGIN" +def test_the_plugin_declares_its_surface_in_the_body_and_the_headers(): + """Body and headers both, because only the body works on every backend.""" + core = _core_dir("claude-code-plugin") + if not core.exists(): + pytest.skip("claude-code-plugin is not built in this tree") + + with tempfile.TemporaryDirectory() as tmp: + out = _run( + core, + Path(tmp), + "import json, memory_core\n" + "h = memory_core.platform_headers('k')\n" + "print(json.dumps({'source': h.get('X-Mem0-Source')," + " 'app': h.get('X-Application')," + " 'client': h.get('X-Mem0-Client')," + " 'auth': h.get('Authorization')," + " 'ctype': h.get('Content-Type')}))", + ) + headers = json.loads(out) + assert headers["source"] == "MEM0_PLUGIN" + assert headers["app"] == "claude-code" + assert headers["client"].startswith("mem0-plugin/") + # The transport headers the three call sites relied on must survive. + assert headers["auth"] == "Token k" + assert headers["ctype"] == "application/json" + + def _session_start(core: Path, data_dir: Path) -> list[str]: """Drive the real hook_runner session-start path and return lifecycle events.""" recorded = "\n".join( diff --git a/integrations/antigravity-plugin/core/_harness_id.py b/integrations/antigravity-plugin/core/_harness_id.py index 2c8a515f4..18b7f68ec 100644 --- a/integrations/antigravity-plugin/core/_harness_id.py +++ b/integrations/antigravity-plugin/core/_harness_id.py @@ -5,5 +5,7 @@ SOURCE_TAG = "ANTIGRAVITY_PLUGIN" # Platform-side vocabulary (mem0_event.source + X-Application). The whole # plugin family is one source; which editor it runs in is the application. +# An empty application means the host is unknown, and memory_core omits +# the header entirely rather than sending a placeholder. PLATFORM_SOURCE = "MEM0_PLUGIN" PLATFORM_APPLICATION = "antigravity" diff --git a/integrations/antigravity-plugin/core/memory_core.py b/integrations/antigravity-plugin/core/memory_core.py index 77d7a2b80..d350e76d2 100644 --- a/integrations/antigravity-plugin/core/memory_core.py +++ b/integrations/antigravity-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,13 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body or + # the query string, never from metadata, which is where this used to + # sit. The X-Mem0-Source header is also read, but only from the + # platform release that ships alongside this change, so the body value + # is what makes attribution work on both. The harness tag stays in + # metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2558,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/claude-code-plugin/core/_harness_id.py b/integrations/claude-code-plugin/core/_harness_id.py index 6c3e1ce15..9c4949408 100644 --- a/integrations/claude-code-plugin/core/_harness_id.py +++ b/integrations/claude-code-plugin/core/_harness_id.py @@ -5,5 +5,7 @@ SOURCE_TAG = "CLAUDE_CODE_PLUGIN" # Platform-side vocabulary (mem0_event.source + X-Application). The whole # plugin family is one source; which editor it runs in is the application. +# An empty application means the host is unknown, and memory_core omits +# the header entirely rather than sending a placeholder. PLATFORM_SOURCE = "MEM0_PLUGIN" PLATFORM_APPLICATION = "claude-code" diff --git a/integrations/claude-code-plugin/core/memory_core.py b/integrations/claude-code-plugin/core/memory_core.py index 77d7a2b80..d350e76d2 100644 --- a/integrations/claude-code-plugin/core/memory_core.py +++ b/integrations/claude-code-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,13 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body or + # the query string, never from metadata, which is where this used to + # sit. The X-Mem0-Source header is also read, but only from the + # platform release that ships alongside this change, so the body value + # is what makes attribution work on both. The harness tag stays in + # metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2558,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/codex-plugin/core/_harness_id.py b/integrations/codex-plugin/core/_harness_id.py index 152313a21..47938ee08 100644 --- a/integrations/codex-plugin/core/_harness_id.py +++ b/integrations/codex-plugin/core/_harness_id.py @@ -5,5 +5,7 @@ SOURCE_TAG = "CODEX_PLUGIN" # Platform-side vocabulary (mem0_event.source + X-Application). The whole # plugin family is one source; which editor it runs in is the application. +# An empty application means the host is unknown, and memory_core omits +# the header entirely rather than sending a placeholder. PLATFORM_SOURCE = "MEM0_PLUGIN" PLATFORM_APPLICATION = "codex" diff --git a/integrations/codex-plugin/core/memory_core.py b/integrations/codex-plugin/core/memory_core.py index 77d7a2b80..d350e76d2 100644 --- a/integrations/codex-plugin/core/memory_core.py +++ b/integrations/codex-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,13 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body or + # the query string, never from metadata, which is where this used to + # sit. The X-Mem0-Source header is also read, but only from the + # platform release that ships alongside this change, so the body value + # is what makes attribution work on both. The harness tag stays in + # metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2558,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/cursor-plugin/core/_harness_id.py b/integrations/cursor-plugin/core/_harness_id.py index 40241a7f4..0e20bf1ff 100644 --- a/integrations/cursor-plugin/core/_harness_id.py +++ b/integrations/cursor-plugin/core/_harness_id.py @@ -5,5 +5,7 @@ SOURCE_TAG = "CURSOR_PLUGIN" # Platform-side vocabulary (mem0_event.source + X-Application). The whole # plugin family is one source; which editor it runs in is the application. +# An empty application means the host is unknown, and memory_core omits +# the header entirely rather than sending a placeholder. PLATFORM_SOURCE = "MEM0_PLUGIN" PLATFORM_APPLICATION = "cursor" diff --git a/integrations/cursor-plugin/core/memory_core.py b/integrations/cursor-plugin/core/memory_core.py index 77d7a2b80..d350e76d2 100644 --- a/integrations/cursor-plugin/core/memory_core.py +++ b/integrations/cursor-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,13 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body or + # the query string, never from metadata, which is where this used to + # sit. The X-Mem0-Source header is also read, but only from the + # platform release that ships alongside this change, so the body value + # is what makes attribution work on both. The harness tag stays in + # metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2558,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/deepseek-plugin/src/index.ts b/integrations/deepseek-plugin/src/index.ts index 2d24b498a..3ac86f4b0 100644 --- a/integrations/deepseek-plugin/src/index.ts +++ b/integrations/deepseek-plugin/src/index.ts @@ -26,8 +26,9 @@ export const name = "mem0"; export const inject = ["tools", "systemPrompt"]; // Tags writes so Mem0's backend attributes them to this integration in -// telemetry. The backend's KNOWN_EVENT_SOURCES allowlist recognizes this value; -// anything outside it buckets into "OTHERS". +// telemetry. Values outside the backend's KNOWN_EVENT_SOURCES allowlist bucket +// into "OTHERS"; this one is added by mem0ai/platform#3602 and reads as OTHERS +// until that ships. const SOURCE = "DEEPSEEK_HARNESS"; const DEFAULT_SEARCH_LIMIT = 10; diff --git a/integrations/kimi-plugin/core/_harness_id.py b/integrations/kimi-plugin/core/_harness_id.py index aa17750b1..83ab061ef 100644 --- a/integrations/kimi-plugin/core/_harness_id.py +++ b/integrations/kimi-plugin/core/_harness_id.py @@ -5,5 +5,7 @@ SOURCE_TAG = "KIMI_PLUGIN" # Platform-side vocabulary (mem0_event.source + X-Application). The whole # plugin family is one source; which editor it runs in is the application. +# An empty application means the host is unknown, and memory_core omits +# the header entirely rather than sending a placeholder. PLATFORM_SOURCE = "MEM0_PLUGIN" PLATFORM_APPLICATION = "kimi" diff --git a/integrations/kimi-plugin/core/memory_core.py b/integrations/kimi-plugin/core/memory_core.py index 77d7a2b80..d350e76d2 100644 --- a/integrations/kimi-plugin/core/memory_core.py +++ b/integrations/kimi-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,13 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body or + # the query string, never from metadata, which is where this used to + # sit. The X-Mem0-Source header is also read, but only from the + # platform release that ships alongside this change, so the body value + # is what makes attribution work on both. The harness tag stays in + # metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2558,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/mem0-agent-plugin/core/_harness_id.py b/integrations/mem0-agent-plugin/core/_harness_id.py index b0836d6de..3efd000f8 100644 --- a/integrations/mem0-agent-plugin/core/_harness_id.py +++ b/integrations/mem0-agent-plugin/core/_harness_id.py @@ -5,5 +5,7 @@ SOURCE_TAG = "CODING_AGENT_PLUGIN" # Platform-side vocabulary (mem0_event.source + X-Application). The whole # plugin family is one source; which editor it runs in is the application. +# An empty application means the host is unknown, and memory_core omits +# the header entirely rather than sending a placeholder. PLATFORM_SOURCE = "MEM0_PLUGIN" -PLATFORM_APPLICATION = "coding-agent" +PLATFORM_APPLICATION = "" diff --git a/integrations/mem0-agent-plugin/core/memory_core.py b/integrations/mem0-agent-plugin/core/memory_core.py index 77d7a2b80..d350e76d2 100644 --- a/integrations/mem0-agent-plugin/core/memory_core.py +++ b/integrations/mem0-agent-plugin/core/memory_core.py @@ -1800,6 +1800,34 @@ def extraction_message_batches( return batches +# Platform surface attribution. Read from the generated per-host module so a new +# entrypoint is correct without remembering to configure anything. +try: # pragma: no cover - absent only in the un-built shared source tree + from _harness_id import PLATFORM_APPLICATION as _PLATFORM_APPLICATION + from _harness_id import PLATFORM_SOURCE as _PLATFORM_SOURCE +except ImportError: + _PLATFORM_SOURCE = "MEM0_PLUGIN" + _PLATFORM_APPLICATION = "" + + +def platform_headers(key: str) -> dict[str, str]: + """Auth plus the three surface-identity headers. + + X-Mem0-Source and X-Application are set-once by contract: this is the + outermost layer, so it sets them, and nothing below may overwrite them. + X-Mem0-Client is append-only — anything downstream adds itself to the tail. + """ + headers = { + "Authorization": f"Token {key}", + "Content-Type": "application/json", + "X-Mem0-Source": _PLATFORM_SOURCE, + "X-Mem0-Client": f"mem0-plugin/{PLUGIN_VERSION}", + } + if _PLATFORM_APPLICATION: + headers["X-Application"] = _PLATFORM_APPLICATION + return headers + + def _request_json( url: str, key: str, payload: dict[str, Any], timeout: float ) -> tuple[dict[str, Any] | list[Any], int, int]: @@ -1807,7 +1835,7 @@ def _request_json( request = urllib.request.Request( url, data=raw, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="POST", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1834,7 +1862,7 @@ def _get_json( ) -> tuple[dict[str, Any] | list[Any], int]: request = urllib.request.Request( url, - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="GET", ) with urllib.request.urlopen(request, timeout=timeout) as response: @@ -1980,6 +2008,13 @@ def flush_session( "user_id": write_user, "app_id": repo.app_id, "run_id": session_id, + # Top level, not metadata: the backend reads `source` from the body or + # the query string, never from metadata, which is where this used to + # sit. The X-Mem0-Source header is also read, but only from the + # platform release that ships alongside this change, so the body value + # is what makes attribution work on both. The harness tag stays in + # metadata as hook provenance. + "source": _PLATFORM_SOURCE, "metadata": {**metadata, "author": write_user, "dirs": directory_chain(repo)}, "agent_custom_instructions": PROJECT_MEMORY_INSTRUCTIONS, "custom_instructions": PERSONAL_MEMORY_INSTRUCTIONS, @@ -2523,7 +2558,7 @@ def _collect_memory_ids( def _delete_memory(api_url: str, key: str, memory_id: str) -> bool: request = urllib.request.Request( f"{api_url}/v1/memories/{urllib.parse.quote(memory_id)}/", - headers={"Authorization": f"Token {key}", "Content-Type": "application/json"}, + headers=platform_headers(key), method="DELETE", ) try: diff --git a/integrations/pi-agent-plugin/src/attribution.test.ts b/integrations/pi-agent-plugin/src/attribution.test.ts new file mode 100644 index 000000000..f90d28da3 --- /dev/null +++ b/integrations/pi-agent-plugin/src/attribution.test.ts @@ -0,0 +1,80 @@ +import { describe, expect, it } from "vitest"; +import { applySurfaceHeaders, PLATFORM_APPLICATION, PLATFORM_SOURCE } from "./attribution.ts"; + +function client(headers: Record = {}) { + return { headers: { Authorization: "Token k", ...headers } } as never; +} + +describe("applySurfaceHeaders", () => { + it("stamps the shared client so every path is attributed, not just commands", () => { + const mem0 = client(); + applySurfaceHeaders(mem0); + const headers = (mem0 as unknown as { headers: Record }).headers; + + expect(headers["X-Mem0-Source"]).toBe(PLATFORM_SOURCE); + expect(headers["X-Application"]).toBe(PLATFORM_APPLICATION); + expect(headers["X-Mem0-Client"]).toMatch(/^mem0-pi-agent\//); + expect(headers.Authorization).toBe("Token k"); + }); + + it("defers to a surface an outer wrapper already declared", () => { + const mem0 = client({ "X-Mem0-Source": "OPENCLAW", "X-Application": "vscode" }); + applySurfaceHeaders(mem0); + const headers = (mem0 as unknown as { headers: Record }).headers; + + expect(headers["X-Mem0-Source"]).toBe("OPENCLAW"); + expect(headers["X-Application"]).toBe("vscode"); + }); + + it("appends to the client stack rather than replacing it", () => { + const mem0 = client({ "X-Mem0-Client": "openclaw/2.1.0" }); + applySurfaceHeaders(mem0); + const headers = (mem0 as unknown as { headers: Record }).headers; + + expect(headers["X-Mem0-Client"]).toMatch(/^openclaw\/2\.1\.0, mem0-pi-agent\//); + }); + + it("treats a blank header as absent", () => { + const mem0 = client({ "X-Mem0-Source": " " }); + applySurfaceHeaders(mem0); + const headers = (mem0 as unknown as { headers: Record }).headers; + + expect(headers["X-Mem0-Source"]).toBe(PLATFORM_SOURCE); + }); + + it("bounds the stack so a long chain cannot grow the header without limit", () => { + const mem0 = client({ "X-Mem0-Client": "a/1, b/1, c/1, d/1, e/1" }); + applySurfaceHeaders(mem0); + const headers = (mem0 as unknown as { headers: Record }).headers; + + expect(headers["X-Mem0-Client"].split(",").length).toBeLessThanOrEqual(4); + expect(headers["X-Mem0-Client"].length).toBeLessThanOrEqual(200); + }); +}); + +describe("client stack bounding", () => { + it("keeps our own entry when the caller already filled the stack", () => { + // The defect: pushing then trimming to four dropped exactly the entry this + // function exists to add, so we vanished from our own stack. + const mem0 = client({ "X-Mem0-Client": "a/1, b/2, c/3, d/4" }); + applySurfaceHeaders(mem0); + const stack = (mem0 as unknown as { headers: Record }).headers["X-Mem0-Client"]; + + expect(stack).toMatch(/mem0-pi-agent\//); + expect(stack.split(",").length).toBeLessThanOrEqual(4); + }); + + it("drops whole entries at the character cap, never a fragment", () => { + const long = `${"n".repeat(90)}/1.0, ${"m".repeat(90)}/1.0, ${"o".repeat(90)}/1.0`; + const mem0 = client({ "X-Mem0-Client": long }); + applySurfaceHeaders(mem0); + const stack = (mem0 as unknown as { headers: Record }).headers["X-Mem0-Client"]; + + expect(stack.length).toBeLessThanOrEqual(200); + expect(stack.endsWith("/0.0.0") || /mem0-pi-agent\/[\w.\-]+$/.test(stack)).toBe(true); + // Every surviving entry is whole: name/version, no severed tail. + for (const entry of stack.split(",")) { + expect(entry.trim()).toMatch(/^[^/]+\/[^/]+$/); + } + }); +}); diff --git a/integrations/pi-agent-plugin/src/attribution.ts b/integrations/pi-agent-plugin/src/attribution.ts new file mode 100644 index 000000000..2cbc9a73e --- /dev/null +++ b/integrations/pi-agent-plugin/src/attribution.ts @@ -0,0 +1,65 @@ +import type MemoryClient from "mem0ai"; +import * as fs from "node:fs"; + +/** Surface identity for this plugin, as the platform's EventSource knows it. */ +export const PLATFORM_SOURCE = "PI_AGENT"; + +/** Host app the plugin runs inside. Allowlisted server-side. */ +export const PLATFORM_APPLICATION = "pi"; + +const PLUGIN_VERSION = (() => { + try { + return JSON.parse( + fs.readFileSync(new URL("../package.json", import.meta.url), "utf-8"), + ).version as string; + } catch { + return "unknown"; + } +})(); + +const MAX_STACK_ENTRIES = 4; +const MAX_STACK_CHARS = 200; + +/** + * Append our own entry and bound the result, dropping WHOLE entries. + * + * Neither cap cuts characters: slicing the joined string severs an identifier + * and leaves a fragment the platform parses as a real client name. And the + * reserved slot is ours, since it is the only entry this layer can vouch for. + */ +function boundedStack(callerEntries: string[], own: string): string { + const kept: string[] = []; + let budget = MAX_STACK_CHARS - own.length; + for (const entry of callerEntries.slice(0, MAX_STACK_ENTRIES - 1)) { + const cost = entry.length + ", ".length; + if (cost > budget) break; + budget -= cost; + kept.push(entry); + } + return [...kept, own].join(", "); +} + +/** + * Stamp surface identity onto the shared client, once, at construction. + * + * Tagging individual call sites was not enough: automatic recall, capture, the + * memory tools and deletion all go through this same client, so everything + * except the explicit slash commands reached the platform as generic SDK + * traffic. Every request method in the SDK sends `this.headers`, so setting + * them here covers all of them. + * + * X-Mem0-Source and X-Application are set-once, so a wrapper that already named + * a surface keeps it. X-Mem0-Client is append-only, so the platform sees the + * whole chain rather than only the last speaker. + */ +export function applySurfaceHeaders(client: MemoryClient): void { + const headers = client.headers as Record; + if (!headers["X-Mem0-Source"]?.trim()) headers["X-Mem0-Source"] = PLATFORM_SOURCE; + if (!headers["X-Application"]?.trim()) headers["X-Application"] = PLATFORM_APPLICATION; + + const existing = (headers["X-Mem0-Client"] ?? "") + .split(",") + .map((part) => part.trim()) + .filter(Boolean); + headers["X-Mem0-Client"] = boundedStack(existing, `mem0-pi-agent/${PLUGIN_VERSION}`); +} diff --git a/integrations/pi-agent-plugin/src/commands.ts b/integrations/pi-agent-plugin/src/commands.ts index 9379bed9a..e969478a1 100644 --- a/integrations/pi-agent-plugin/src/commands.ts +++ b/integrations/pi-agent-plugin/src/commands.ts @@ -1,3 +1,4 @@ +import type { SearchMemoryOptions } from "mem0ai"; import type { ExtensionAPI } from "@earendil-works/pi-coding-agent"; import type MemoryClient from "mem0ai"; import type { Mem0Config, ScopeContext, Scope } from "./types.ts"; @@ -5,6 +6,12 @@ import { DEFAULT_CUSTOM_CATEGORIES } from "./types.ts"; import { resolveSearchFilters, resolveAddParams } from "./memory/scoping.ts"; import { formatMemoryList, formatMemoryCompact, groupByCategory } from "./memory/formatting.ts"; import { captureCommandEvent } from "./telemetry.ts"; +import { PLATFORM_SOURCE } from "./attribution.ts"; + +// Wire identity is set once on the shared client in entry.ts, which covers +// every path including recall, capture, tools and deletion. It stays in the +// body of the two calls below as well: body `source` is what the backend reads +// when the header is absent. const SEARCH_TOP_K = 10; @@ -29,7 +36,12 @@ export function registerCommands( threshold: config.searchThreshold, topK: SEARCH_TOP_K, rerank: true, - }); + source: PLATFORM_SOURCE, + // Widened by exactly this one property. `source` reaches the wire via the + // SDK's camelToSnakeKeys spread, but it is absent from SearchMemoryOptions + // in the published mem0ai types. A blanket `as never` would also disable + // checking of filters, threshold, topK and rerank above. + } as SearchMemoryOptions & { source: string }); return result.results ?? []; }; @@ -45,7 +57,7 @@ export function registerCommands( const addParams = resolveAddParams(config.defaultScope, getScopeCtx()); const result = await mem0.add( [{ role: "user", content: text }], - { ...addParams, customCategories: DEFAULT_CUSTOM_CATEGORIES, infer: false }, + { ...addParams, customCategories: DEFAULT_CUSTOM_CATEGORIES, infer: false, source: PLATFORM_SOURCE }, ); captureCommandEvent("mem0-remember", {}, telemetryCtx); diff --git a/integrations/pi-agent-plugin/src/entry.ts b/integrations/pi-agent-plugin/src/entry.ts index d49d78ad0..256c05aa4 100644 --- a/integrations/pi-agent-plugin/src/entry.ts +++ b/integrations/pi-agent-plugin/src/entry.ts @@ -10,6 +10,7 @@ import { captureEvent } from "./telemetry.ts"; import * as os from "node:os"; import type { ScopeContext } from "./types.ts"; import { createMemoryLifecycle } from "../../agent-plugin-core/typescript/src/lifecycle.ts"; +import { applySurfaceHeaders } from "./attribution.ts"; export { buildRecallContext } from "../../agent-plugin-core/typescript/src/lifecycle.ts"; @@ -29,6 +30,11 @@ export default function mem0Extension(pi: ExtensionAPI): void { } const mem0 = new MemoryClient({ apiKey: config.apiKey }); + // Every path below shares this client: automatic recall, capture, the memory + // tools and deletion as well as the slash commands. Attribution belongs here + // rather than on individual calls, or everything except the commands reports + // as generic SDK traffic. + applySurfaceHeaders(mem0); const scopeCtx: ScopeContext = { userId: resolveUserId(config.userId), diff --git a/integrations/vercel-ai-sdk/src/mem0-utils.ts b/integrations/vercel-ai-sdk/src/mem0-utils.ts index 55d485cbc..b7a041939 100644 --- a/integrations/vercel-ai-sdk/src/mem0-utils.ts +++ b/integrations/vercel-ai-sdk/src/mem0-utils.ts @@ -1,3 +1,10 @@ +declare const __MEM0_PROVIDER_VERSION__: string | undefined; + +// Replaced at build time by tsup `define`. The fallback only applies when the +// source is run unbundled, such as in tests. +const PROVIDER_VERSION = + typeof __MEM0_PROVIDER_VERSION__ !== "undefined" ? __MEM0_PROVIDER_VERSION__ : "dev"; + import { LanguageModelV3Prompt } from '@ai-sdk/provider'; import { Mem0ConfigSettings } from './mem0-types'; import { loadApiKey } from '@ai-sdk/provider-utils'; @@ -277,7 +284,11 @@ const searchInternalMemories = async (query: string, config?: Mem0ConfigSettings method: 'POST', headers: { Authorization: `Token ${apiKey}`, - 'Content-Type': 'application/json' + 'Content-Type': 'application/json', + // Surface attribution. Set-once by contract: this wrapper is the + // outermost layer on these raw fetch calls. + 'X-Mem0-Source': 'VERCEL_AI_SDK', + 'X-Mem0-Client': `mem0-vercel-ai-provider/${PROVIDER_VERSION}` }, body: JSON.stringify(body), }; @@ -331,7 +342,11 @@ const updateMemories = async (messages: Array, config?: Mem0ConfigSetti method: 'POST', headers: { Authorization: `Token ${apiKey}`, - 'Content-Type': 'application/json' + 'Content-Type': 'application/json', + // Surface attribution. Set-once by contract: this wrapper is the + // outermost layer on these raw fetch calls. + 'X-Mem0-Source': 'VERCEL_AI_SDK', + 'X-Mem0-Client': `mem0-vercel-ai-provider/${PROVIDER_VERSION}` }, body: JSON.stringify(body), }; diff --git a/integrations/vercel-ai-sdk/tsconfig.json b/integrations/vercel-ai-sdk/tsconfig.json index b05d5db02..e40350730 100644 --- a/integrations/vercel-ai-sdk/tsconfig.json +++ b/integrations/vercel-ai-sdk/tsconfig.json @@ -12,6 +12,7 @@ "noUnusedLocals": false, "noUnusedParameters": false, "preserveWatchOutput": true, + "resolveJsonModule": true, "skipLibCheck": true, "strict": true, "types": ["@types/node", "jest"], diff --git a/integrations/vercel-ai-sdk/tsup.config.ts b/integrations/vercel-ai-sdk/tsup.config.ts index 2c8f74a6d..ff2d298c0 100644 --- a/integrations/vercel-ai-sdk/tsup.config.ts +++ b/integrations/vercel-ai-sdk/tsup.config.ts @@ -1,4 +1,5 @@ import { defineConfig } from 'tsup' +import pkg from './package.json' export default defineConfig([ { @@ -6,5 +7,11 @@ export default defineConfig([ entry: ['src/index.ts'], format: ['cjs', 'esm'], sourcemap: true, + // Injected rather than written in the source. A hardcoded literal matches + // package.json on the day it is written and misreports the client version + // from the next release bump onwards. Same mechanism as mem0-ts. + define: { + __MEM0_PROVIDER_VERSION__: JSON.stringify(pkg.version), + }, }, ]) \ No newline at end of file diff --git a/mem0-ts/src/client/mem0.ts b/mem0-ts/src/client/mem0.ts index ff259f2fe..33e03f0c2 100644 --- a/mem0-ts/src/client/mem0.ts +++ b/mem0-ts/src/client/mem0.ts @@ -95,6 +95,66 @@ interface ClientIdentity { const IDENTITY_CACHE_MAX_DEFAULT = 50; const identityByCredentials = new Map>(); +declare const __MEM0_SDK_VERSION__: string | undefined; + +// Injected by tsup (see mem0-ts/tsup.config.ts `define`), the same mechanism +// telemetry.ts already uses. A hardcoded literal goes stale at the next release +// bump and then misreports the client version forever. +const SDK_VERSION = + typeof __MEM0_SDK_VERSION__ !== "undefined" ? __MEM0_SDK_VERSION__ : "dev"; + +const MAX_STACK_ENTRIES = 4; +const MAX_STACK_CHARS = 200; + +/** + * Append our own entry and bound the result, dropping WHOLE entries. + * + * Neither cap cuts characters: slicing the joined string severs an identifier + * and leaves a fragment the platform parses as a real client name. And the + * reserved slot is ours. Pushing first and then trimming to four dropped exactly + * the entry this exists to add whenever a caller already sent four, so we + * vanished from our own stack while every caller claim survived. + */ +function boundedStack(callerEntries: string[], own: string): string { + const kept: string[] = []; + let budget = MAX_STACK_CHARS - own.length; + for (const entry of callerEntries.slice(0, MAX_STACK_ENTRIES - 1)) { + const cost = entry.length + ", ".length; + if (cost > budget) break; + budget -= cost; + kept.push(entry); + } + return [...kept, own].join(", "); +} + +/** + * Surface-identity headers. + * + * X-Mem0-Source and X-Application are SET-ONCE by contract: whichever layer is + * outermost sets them and nothing below overwrites, so a plugin wrapping this + * SDK keeps its own identity. X-Mem0-Client is APPEND-ONLY - every layer adds + * itself, so the platform sees the whole stack and not just the last speaker. + */ +function surfaceHeaders(): Record { + const env: Record = + typeof process !== "undefined" && process.env ? process.env : {}; + const existing = (env.MEM0_CLIENT_STACK ?? "").trim(); + const entries = existing + ? existing + .split(",") + .map((part) => part.trim()) + .filter(Boolean) + : []; + const headers: Record = { + "X-Mem0-Client": boundedStack(entries, `mem0-js/${SDK_VERSION}`), + }; + const source = (env.MEM0_SOURCE ?? "").trim(); + if (source) headers["X-Mem0-Source"] = source; + const application = (env.MEM0_APPLICATION ?? "").trim(); + if (application) headers["X-Application"] = application; + return headers; +} + export default class MemoryClient { apiKey: string; host: string; @@ -129,6 +189,7 @@ export default class MemoryClient { this.headers = { Authorization: `Token ${this.apiKey}`, "Content-Type": "application/json", + ...surfaceHeaders(), }; this.client = axios.create({ diff --git a/mem0-ts/src/client/mem0.types.ts b/mem0-ts/src/client/mem0.types.ts index c230441e0..cbe541321 100644 --- a/mem0-ts/src/client/mem0.types.ts +++ b/mem0-ts/src/client/mem0.types.ts @@ -30,6 +30,9 @@ export interface SearchMemoryOptions { showExpired?: boolean; referenceDate?: string | number; keywordSearch?: boolean; + /** Surface that produced the call, e.g. "OPENCLAW". Must be a value the + * backend's EventSource enum knows, or it buckets into OTHERS. */ + source?: string; } export interface GetAllMemoryOptions { diff --git a/mem0/client/main.py b/mem0/client/main.py index a52986dcd..3a82d9e5a 100644 --- a/mem0/client/main.py +++ b/mem0/client/main.py @@ -79,6 +79,95 @@ def _maybe_alias_anon_to_email(user_email): logger.debug("Failed to alias anon telemetry to %r: %s", user_email, e) +def _sdk_version() -> str: + """Resolved here rather than imported from the package root, which would cycle.""" + try: + import importlib.metadata + + return importlib.metadata.version("mem0ai") + except Exception: + return "unknown" + + +def _apply_client_headers(client: Any, api_key: str, user_id: str) -> None: + """Merge our headers into a caller-supplied client without erasing theirs. + + A wrapper may hand us a client already carrying its own X-Mem0-Source or a + partial X-Mem0-Client stack. Blanket update() replaced both, which is the + opposite of the set-once / append-only contract: the outermost layer is the + one whose identity should survive. + """ + existing = client.headers + mine = _client_headers(api_key, user_id) + + outer_stack = existing.get("X-Mem0-Client") + if outer_stack: + entries = [part.strip() for part in str(outer_stack).split(",") if part.strip()] + mine["X-Mem0-Client"] = _bounded_stack(entries, f"mem0-python/{_sdk_version()}") + + for name, value in mine.items(): + if name in ("X-Mem0-Source", "X-Application") and existing.get(name): + continue + existing[name] = value + + +MAX_STACK_ENTRIES = 4 +MAX_STACK_CHARS = 200 + + +def _bounded_stack(caller_entries, own: str) -> str: + """Append our own entry and bound the result, dropping WHOLE entries. + + Two rules, and the second is the one that was wrong. Neither cap cuts + characters: a blunt slice severs an identifier and leaves a fragment that + parses as a real client name. And the reserved slot is OURS. Appending first + and then trimming to four dropped exactly the entry this function exists to + add, every time a caller already sent four, so the SDK vanished from its own + stack while the caller's claims all survived. + """ + kept = [] + budget = MAX_STACK_CHARS - len(own) + for entry in list(caller_entries)[: MAX_STACK_ENTRIES - 1]: + cost = len(entry) + len(", ") + if cost > budget: + break + budget -= cost + kept.append(entry) + return ", ".join(kept + [own]) + + +def _client_headers(api_key: str, user_id: str) -> Dict[str, str]: + """Auth plus surface-identity headers. + + X-Mem0-Source and X-Application are SET-ONCE by contract: whichever layer is + outermost sets them, and nothing below overwrites. A plugin or harness that + wraps this SDK therefore keeps its own identity — it declares via MEM0_SOURCE + / MEM0_APPLICATION and the SDK defers. + + X-Mem0-Client is APPEND-ONLY: every layer adds itself, so the platform sees + the whole stack rather than only whoever spoke last. + """ + headers = { + "Authorization": f"Token {api_key}", + "Mem0-User-ID": user_id, + "X-Mem0-Client": _client_stack(), + } + source = os.getenv("MEM0_SOURCE", "").strip() + if source: + headers["X-Mem0-Source"] = source + application = os.getenv("MEM0_APPLICATION", "").strip() + if application: + headers["X-Application"] = application + return headers + + +def _client_stack() -> str: + """This SDK appended to any stack an outer layer already declared.""" + existing = os.getenv("MEM0_CLIENT_STACK", "").strip() + entries = [part.strip() for part in existing.split(",") if part.strip()] if existing else [] + return _bounded_stack(entries, f"mem0-python/{_sdk_version()}") + + class MemoryClient: """Client for interacting with the Mem0 API. @@ -129,19 +218,11 @@ class MemoryClient: self.client = client # Ensure the client has the correct base_url and headers self.client.base_url = httpx.URL(self.host) - self.client.headers.update( - { - "Authorization": f"Token {self.api_key}", - "Mem0-User-ID": self.user_id, - } - ) + _apply_client_headers(self.client, self.api_key, self.user_id) else: self.client = httpx.Client( base_url=self.host, - headers={ - "Authorization": f"Token {self.api_key}", - "Mem0-User-ID": self.user_id, - }, + headers=_client_headers(self.api_key, self.user_id), timeout=300, ) self.user_email = self._validate_api_key() @@ -1018,19 +1099,11 @@ class AsyncMemoryClient: self.async_client = client # Ensure the client has the correct base_url and headers self.async_client.base_url = httpx.URL(self.host) - self.async_client.headers.update( - { - "Authorization": f"Token {self.api_key}", - "Mem0-User-ID": self.user_id, - } - ) + _apply_client_headers(self.async_client, self.api_key, self.user_id) else: self.async_client = httpx.AsyncClient( base_url=self.host, - headers={ - "Authorization": f"Token {self.api_key}", - "Mem0-User-ID": self.user_id, - }, + headers=_client_headers(self.api_key, self.user_id), timeout=300, ) @@ -1053,10 +1126,7 @@ class AsyncMemoryClient: params = self._prepare_params() response = requests.get( f"{self.host}/v1/ping/", - headers={ - "Authorization": f"Token {self.api_key}", - "Mem0-User-ID": self.user_id, - }, + headers=_client_headers(self.api_key, self.user_id), params=params, ) response.raise_for_status() diff --git a/tests/test_client_surface_headers.py b/tests/test_client_surface_headers.py new file mode 100644 index 000000000..51d09d306 --- /dev/null +++ b/tests/test_client_surface_headers.py @@ -0,0 +1,63 @@ +"""Surface-identity headers, and that a client can be constructed at all. + +The construction test exists because it was not there: a signature change to +_bounded_stack missed the _client_stack call site, every MemoryClient(...) raised +TypeError, and the whole suite stayed green because nothing built one. +""" + +import os +from unittest.mock import patch + +from mem0.client.main import _bounded_stack, _client_headers, _client_stack + + +def test_a_client_can_be_constructed(): + from mem0 import MemoryClient + + # _validate_api_key normally populates org/project from the API response; + # stubbing it leaves them None, which a later accessor rejects. Set them the + # way a real validation would. This test is about construction reaching the + # header stage at all. + def _stub(self): + self.org_id, self.project_id = "org", "proj" + + with patch.object(MemoryClient, "_validate_api_key", _stub): + client = MemoryClient(api_key="m0-test") + + assert client.client.headers["X-Mem0-Client"].startswith("mem0-python/") + + +# AsyncMemoryClient is deliberately not constructed here: its validation path +# makes a real request to /v1/ping/, and a unit test that needs the network is +# worse than none. It shares _client_headers with the sync client, which is the +# code the construction test above actually guards. +def test_headers_carry_this_sdk(): + headers = _client_headers("m0-test", "u1") + assert headers["X-Mem0-Client"].startswith("mem0-python/") + + +def test_our_entry_survives_a_caller_that_already_filled_the_stack(): + # Appending first and trimming to four dropped exactly the entry the + # function exists to add. + stack = _bounded_stack(["a/1", "b/2", "c/3", "d/4"], "mem0-python/9.9.9") + + assert "mem0-python/9.9.9" in stack + assert len(stack.split(",")) <= 4 + + +def test_the_character_cap_drops_whole_entries_not_characters(): + long_entries = [f"{'n' * 90}/1.0", f"{'m' * 90}/1.0", "c/3"] + stack = _bounded_stack(long_entries, "mem0-python/9.9.9") + + assert len(stack) <= 200 + assert stack.endswith("mem0-python/9.9.9") + for entry in stack.split(","): + assert entry.strip().count("/") == 1, f"severed entry: {entry!r}" + + +def test_an_outer_stack_is_appended_to_not_replaced(): + with patch.dict(os.environ, {"MEM0_CLIENT_STACK": "openclaw/2.1.0"}): + stack = _client_stack() + + assert stack.startswith("openclaw/2.1.0") + assert "mem0-python/" in stack From a8d36343128c0410a3e71626b8edfd31f875bd17 Mon Sep 17 00:00:00 2001 From: Saket Aryan Date: Fri, 18 Sep 2026 14:13:22 +0530 Subject: [PATCH 13/55] fix(plugins): stop the TypeScript telemetry losing events and misattributing accounts (#7358) --- .github/workflows/opencode-plugin-checks.yml | 3 + .../typescript/src/telemetry.ts | 99 ++++++- .../typescript/tests/telemetry.test.ts | 247 ++++++++++++++++++ integrations/openclaw/cli/config-file.ts | 20 ++ integrations/openclaw/config.ts | 1 + integrations/openclaw/openclaw.plugin.json | 4 + integrations/openclaw/telemetry.ts | 64 ++++- .../openclaw/tests/config-file.test.ts | 40 +++ integrations/openclaw/tests/config.test.ts | 15 ++ integrations/openclaw/tests/telemetry.test.ts | 80 +++++- integrations/opencode-plugin/package.json | 1 + .../opencode-plugin/telemetry.test.ts | 51 +++- integrations/opencode-plugin/telemetry.ts | 27 +- 13 files changed, 623 insertions(+), 29 deletions(-) diff --git a/.github/workflows/opencode-plugin-checks.yml b/.github/workflows/opencode-plugin-checks.yml index 4fb95fc6c..a93d741eb 100644 --- a/.github/workflows/opencode-plugin-checks.yml +++ b/.github/workflows/opencode-plugin-checks.yml @@ -32,6 +32,9 @@ jobs: - name: Type check run: bun run type-check + - name: Test + run: bun test + - name: Build run: bun run build diff --git a/integrations/agent-plugin-core/typescript/src/telemetry.ts b/integrations/agent-plugin-core/typescript/src/telemetry.ts index c6a7544ce..2b6c5286e 100644 --- a/integrations/agent-plugin-core/typescript/src/telemetry.ts +++ b/integrations/agent-plugin-core/typescript/src/telemetry.ts @@ -1,3 +1,5 @@ +import { randomUUID } from "node:crypto"; + import { redactSecrets } from "./lifecycle.ts"; const POSTHOG_API_KEY = "phc_hgJkUVJFYtmaJqrvf6CYN67TIQ8yhXAkWzUn9AMU4yX"; @@ -74,34 +76,108 @@ export function errorKind(error: unknown): string { return error instanceof Error ? error.constructor.name : "other"; } +// Delivery is retried in memory, not spooled to disk, and that is a decision +// rather than an omission. The Python core spools because its hooks are separate +// processes that fire per tool call and exit immediately, so nothing survives +// without a file. These plugins are loaded into a host that lives for a whole +// session, so re-queueing covers the same transient failures without the claim +// and lease machinery a correct cross-process spool needs. What that leaves +// uncovered is narrow: a session that both starts and ends with no connectivity. +const RETRY_BACKOFF_CEILING_MS = 60_000; +// Consecutive failed flushes before the queue is dropped. Deliberately NOT the +// same thing as Python's budget, which rides in the claim filename and so +// follows one batch: this counter lives in the closure and counts the outage, +// not the payload. Events captured between attempts join the same queue and go +// with it. Per-batch accounting would need an attempt count on every event, and +// the queue is already bounded, so the simpler rule is the one in force here. +// Without any bound a payload the server will never accept is retried for the +// whole session and, now that the backlog is preferred over new events, holds +// the queue against everything behind it. +const MAX_DELIVERY_ATTEMPTS = 5; + export function createTelemetry(config: TelemetryConfig) { let queue: Record[] = []; let timer: ReturnType | undefined; + let consecutiveFailures = 0; + let retryNotBefore = 0; + let exitFlushAttempted = false; + let flushing = false; const flushThreshold = config.flushThreshold ?? 10; const maxQueueSize = config.maxQueueSize ?? 100; const deliver = config.delivery ?? (async (batch: Record[]) => { - await fetch(POSTHOG_BATCH_URL, { + const response = await fetch(POSTHOG_BATCH_URL, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ api_key: POSTHOG_API_KEY, batch }), signal: AbortSignal.timeout(3_000), }); + // fetch only rejects on a network-level failure. Without this check a 500, + // a 503 or a 429 resolved normally and the batch was counted as delivered + // and dropped, which is the likelier outage than a refused connection. + // Any non-2xx is retried, matching the Python core: the backoff and the + // queue bound contain a payload that will never be accepted, because the + // re-queued batch sits at the front and is the first thing evicted. + if (!response.ok) throw new Error(`posthog responded ${response.status}`); }); - async function flush(): Promise { + async function flush(force = false): Promise { + // One at a time. Two overlapping flushes each detach the queue and each + // prepend their own batch back on failure, so the later batch lands in front + // of the earlier one and the truncation then drops the OLDER events first, + // inverting the priority the failure path exists to establish. A second + // caller returns immediately; the queue waits for the next flush. + if (flushing) return; if (!queue.length) return; + // `force` skips the cooldown. beforeExit is the last chance this process + // gets, and gating it on the same backoff meant that after any failure the + // exit flush did nothing and the queue died with the process, which is the + // loss this whole mechanism exists to prevent. + if (!force && Date.now() < retryNotBefore) return; const batch = queue; queue = []; + flushing = true; try { await deliver(batch); + consecutiveFailures = 0; + retryNotBefore = 0; } catch { - // Telemetry must never affect plugin behavior. + // Put it back. Detaching the batch and swallowing the error deleted the + // events outright, so any blip silently dropped telemetry with nothing + // recording that it had happened. Every event carries a uuid, so a retry + // that duplicates one PostHog already accepted is collapsed there. + // + consecutiveFailures += 1; + if (consecutiveFailures >= MAX_DELIVERY_ATTEMPTS) { + // Give up on the queue so a failing outage cannot hold it for the + // session. This drops whatever is queued now, which includes events + // captured during the outage, not only the batch that kept failing. + consecutiveFailures = 0; + retryNotBefore = 0; + return; + } + // Keep the FRONT on overflow, so the batch being retried survives and a + // new event is what gets dropped. Matches the Python core, where record() + // refuses new events once the spool is full rather than evicting the + // backlog. Keeping the newest would throw away exactly the events this + // retry exists to save. + queue = [...batch, ...queue].slice(0, maxQueueSize); + retryNotBefore = Date.now() + Math.min(2 ** consecutiveFailures * 1_000, RETRY_BACKOFF_CEILING_MS); + } finally { + flushing = false; } } function beforeExit(): void { - void flush(); + // Once, and only once. Node re-emits beforeExit whenever the handler + // schedules more async work, so an unconditional forced flush looped until + // the attempt budget was spent: five attempts against a 3s delivery timeout + // is fifteen seconds added to the shutdown of whatever editor or CLI is + // hosting this. The backoff used to end that loop after one attempt, and + // removing it for the forced path removed the only thing bounding it. + if (exitFlushAttempted) return; + exitFlushAttempted = true; + void flush(true); } function build(event: string, properties: Record = {}): Record | null { @@ -112,6 +188,15 @@ export function createTelemetry(config: TelemetryConfig) { return { event: config.eventName?.(event) ?? event, distinct_id: distinctId, + // Stamped once, at capture. This is what makes retrying safe: a batch + // re-sent after a failure carries the same ids, so PostHog collapses + // anything it already accepted instead of counting it twice. + uuid: randomUUID(), + // Capture time, not ingestion time. Events now sit through backoff and + // across a whole outage, so without this PostHog records them whenever + // delivery happened to succeed. It also matters for the uuid dedupe + // above, whose key includes the event date. + timestamp: new Date().toISOString(), properties: { ...safeProperties(properties), ...safeProperties(config.commonProperties ?? {}), @@ -134,8 +219,10 @@ export function createTelemetry(config: TelemetryConfig) { try { const payload = build(event, properties); if (!payload) return; + // Full means drop this event, not evict the backlog. Same rule as the + // failure path above and as Python's record(). + if (queue.length >= maxQueueSize) return; queue.push(payload); - if (queue.length > maxQueueSize) queue = queue.slice(-maxQueueSize); if (!timer) { timer = setInterval(() => void flush(), config.flushIntervalMs ?? 5_000); timer.unref?.(); @@ -149,6 +236,8 @@ export function createTelemetry(config: TelemetryConfig) { function resetForTesting(): void { queue = []; + consecutiveFailures = 0; + retryNotBefore = 0; if (timer) clearInterval(timer); timer = undefined; process.off("beforeExit", beforeExit); diff --git a/integrations/agent-plugin-core/typescript/tests/telemetry.test.ts b/integrations/agent-plugin-core/typescript/tests/telemetry.test.ts index e04794614..cf9671682 100644 --- a/integrations/agent-plugin-core/typescript/tests/telemetry.test.ts +++ b/integrations/agent-plugin-core/typescript/tests/telemetry.test.ts @@ -122,3 +122,250 @@ test("error classification does not expose messages", () => { assert.equal(errorKind(new Error("request timeout")), "timeout"); assert.equal(errorKind(new Error("fetch failed")), "network"); }); + +test("a failed delivery keeps the batch instead of deleting it", async () => { + // The defect: the queue was detached before the await and the error swallowed, + // so one blip destroyed the events with nothing recording that it happened. + const attempts: Record[][] = []; + let failNext = true; + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", + flushThreshold: 1000, + delivery: async (batch) => { + attempts.push(batch); + if (failNext) throw new Error("network down"); + }, + }); + + telemetry.capture("one"); + telemetry.capture("two"); + await telemetry.flush(); + + assert.equal(attempts.length, 1); + assert.equal(telemetry.queueForTesting().length, 2, "events were dropped on failure"); + + failNext = false; + // Backoff is in force, so wait it out the way wall time would. + await new Promise((resolve) => setTimeout(resolve, 2_100)); + await telemetry.flush(); + + assert.equal(attempts.length, 2, "never retried"); + assert.equal(telemetry.queueForTesting().length, 0); + telemetry.resetForTesting(); +}); + +test("a retried event carries the same uuid so PostHog can collapse it", async () => { + const attempts: Record[][] = []; + let failNext = true; + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", + flushThreshold: 1000, + delivery: async (batch) => { + attempts.push(batch); + if (failNext) throw new Error("network down"); + }, + }); + + telemetry.capture("once"); + await telemetry.flush(); + failNext = false; + await new Promise((resolve) => setTimeout(resolve, 2_100)); + await telemetry.flush(); + + assert.equal(attempts.length, 2); + const first = attempts[0][0].uuid; + assert.ok(first, "events carry no uuid, so a retry would double count"); + assert.equal(attempts[1][0].uuid, first, "retry minted a new uuid"); + telemetry.resetForTesting(); +}); + +test("repeated failures back off instead of retrying every flush", async () => { + let calls = 0; + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", + flushThreshold: 1000, + delivery: async () => { calls += 1; throw new Error("blocked"); }, + }); + + telemetry.capture("one"); + await telemetry.flush(); + await telemetry.flush(); + await telemetry.flush(); + + assert.equal(calls, 1, "a blocked host was hammered on every flush"); + assert.equal(telemetry.queueForTesting().length, 1, "the event was lost while backing off"); + telemetry.resetForTesting(); +}); + +test("a full queue drops the new event and keeps the batch being retried", async () => { + // Python's record() refuses new events once the spool is full rather than + // evicting the backlog. Keeping the newest here would throw away exactly the + // events the retry exists to save. + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", + flushThreshold: 1000, maxQueueSize: 3, + delivery: async () => { throw new Error("down"); }, + }); + + // Fill past the cap BEFORE the flush, so the re-queue actually has to truncate. + // Capturing only two left the queue empty at re-queue time and the slice on the + // failure path never ran, which is the half that decides the direction. + telemetry.capture("a"); + telemetry.capture("b"); + telemetry.capture("c"); + await telemetry.flush(); + telemetry.capture("d"); + telemetry.capture("e"); + + const events = telemetry.queueForTesting().map((e) => (e as any).event); + assert.equal(events.length, 3, "queue grew past maxQueueSize"); + assert.deepEqual(events, ["a", "b", "c"], "the retried batch was evicted instead of the new events"); + telemetry.resetForTesting(); +}); + +test("the exit-time flush ignores the backoff", async () => { + // beforeExit is the last chance the process gets. Gating it on the same + // cooldown meant that after any failure it did nothing and the queue died. + let attempts = 0; + let failing = true; + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", flushThreshold: 1000, + delivery: async () => { attempts += 1; if (failing) throw new Error("down"); }, + }); + + telemetry.capture("a"); + await telemetry.flush(); + assert.equal(attempts, 1); + + failing = false; + await telemetry.flush(); + assert.equal(attempts, 1, "the backoff should still hold for an ordinary flush"); + + await telemetry.flush(true); + assert.equal(attempts, 2, "the exit flush was suppressed by the backoff"); + assert.equal(telemetry.queueForTesting().length, 0); + telemetry.resetForTesting(); +}); + +test("every event carries a capture-time timestamp", async () => { + const sent: Record[][] = []; + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", flushThreshold: 1000, + delivery: async (batch) => { sent.push(batch); }, + }); + + telemetry.capture("a"); + const capturedAt = Date.now(); + await new Promise((resolve) => setTimeout(resolve, 50)); + await telemetry.flush(); + + const stamped = sent[0][0].timestamp as string; + assert.ok(stamped, "no timestamp, so PostHog would record delivery time"); + assert.ok(Math.abs(Date.parse(stamped) - capturedAt) < 1_000, "not capture time"); + telemetry.resetForTesting(); +}); + +test("a batch the server will never accept is eventually given up on", async () => { + let attempts = 0; + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", flushThreshold: 1000, + delivery: async () => { attempts += 1; throw new Error("permanently bad"); }, + }); + + telemetry.capture("doomed"); + for (let i = 0; i < 8; i += 1) await telemetry.flush(true); + + assert.ok(attempts <= 6, `retried ${attempts} times with no cap`); + assert.equal(telemetry.queueForTesting().length, 0, "a doomed batch held the queue forever"); + telemetry.resetForTesting(); +}); + +test("an HTTP error response is a failure, not a delivery", async () => { + // fetch only rejects on a network-level failure, so a 500 used to resolve + // normally and the batch was dropped as delivered. Exercises the real default + // delivery path rather than an injected one, which is where this hid. + const realFetch = globalThis.fetch; + let calls = 0; + globalThis.fetch = (async () => { + calls += 1; + return new Response("upstream is unwell", { status: 503 }); + }) as typeof fetch; + + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", flushThreshold: 1000, + }); + try { + telemetry.capture("during.outage"); + await telemetry.flush(); + + assert.equal(calls, 1, "never reached the network"); + assert.equal(telemetry.queueForTesting().length, 1, "a 503 was counted as delivered"); + } finally { + globalThis.fetch = realFetch; + telemetry.resetForTesting(); + } +}); + +test("a 2xx is a delivery", async () => { + const realFetch = globalThis.fetch; + globalThis.fetch = (async () => new Response("ok", { status: 200 })) as typeof fetch; + + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", flushThreshold: 1000, + }); + try { + telemetry.capture("fine"); + await telemetry.flush(); + assert.equal(telemetry.queueForTesting().length, 0, "a good response did not clear the queue"); + } finally { + globalThis.fetch = realFetch; + telemetry.resetForTesting(); + } +}); + +test("the exit flush is attempted once, not until the budget is spent", async () => { + // Node re-emits beforeExit whenever the handler schedules async work, so an + // unconditional forced flush looped until MAX_DELIVERY_ATTEMPTS. Against the + // real 3s delivery timeout that is fifteen seconds added to a host's shutdown. + let attempts = 0; + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", flushThreshold: 1000, + delivery: async () => { attempts += 1; throw new Error("down"); }, + }); + + telemetry.capture("a"); + const handlers = process.listeners("beforeExit"); + const ours = handlers[handlers.length - 1] as () => void; + ours(); + ours(); + ours(); + await new Promise((resolve) => setTimeout(resolve, 20)); + + assert.equal(attempts, 1, `exit flush ran ${attempts} times`); + telemetry.resetForTesting(); +}); + +test("overlapping flushes do not reorder the backlog behind newer events", async () => { + // Each flush detaches the queue and prepends its own batch back on failure, so + // two in flight at once put the LATER batch in front of the earlier one. The + // truncation then drops the older events first, inverting the priority the + // failure path exists to establish. + let release: (() => void)[] = []; + const telemetry = createTelemetry({ + host: "h", source: "S", version: "1", distinctId: "d", flushThreshold: 1000, + delivery: () => new Promise((_resolve, reject) => { release.push(() => reject(new Error("down"))); }), + }); + + telemetry.capture("first"); + const a = telemetry.flush(); + telemetry.capture("second"); + const b = telemetry.flush(); + + release.forEach((fn) => fn()); + await Promise.all([a, b]); + + const events = telemetry.queueForTesting().map((e) => (e as any).event); + assert.equal(release.length, 1, "a second delivery started while one was in flight"); + assert.deepEqual(events, ["first", "second"], `backlog reordered: ${events.join(",")}`); + telemetry.resetForTesting(); +}); diff --git a/integrations/openclaw/cli/config-file.ts b/integrations/openclaw/cli/config-file.ts index 99453cb1b..a34d6c08b 100644 --- a/integrations/openclaw/cli/config-file.ts +++ b/integrations/openclaw/cli/config-file.ts @@ -35,6 +35,8 @@ export interface PluginAuthConfig { autoCapture?: boolean; topK?: number; anonymousTelemetryId?: string; + /** SHA-256 prefix of the API key userEmail was resolved for. */ + keyFingerprint?: string; } // ============================================================================ @@ -135,6 +137,9 @@ export function readPluginAuth(): PluginAuthConfig { autoCapture: cfg.autoCapture as boolean | undefined, topK: cfg.topK as number | undefined, anonymousTelemetryId: cfg.anonymousTelemetryId as string | undefined, + // Without this the reader silently drops it, every fingerprint comparison + // fails against undefined, and the resolved email is never used again. + keyFingerprint: cfg.keyFingerprint as string | undefined, }; } @@ -236,6 +241,21 @@ export function getBaseUrl(): string { return auth.baseUrl || DEFAULT_BASE_URL; } +/** Forget the resolved account, so the next capture re-resolves for the current key. */ +export function clearResolvedAccount(): void { + const full = readFullConfig() as any; + const cfg = full?.plugins?.entries?.[PLUGIN_ID]?.config; + if (!cfg) return; + let changed = false; + for (const key of ["userEmail", "keyFingerprint"]) { + if (key in cfg) { + delete cfg[key]; + changed = true; + } + } + if (changed) writeFullConfig(full); +} + /** Remove anonymousTelemetryId from config (after PostHog aliasing) */ export function clearAnonymousTelemetryId(): void { const full = readFullConfig() as any; diff --git a/integrations/openclaw/config.ts b/integrations/openclaw/config.ts index 4e43c8c44..09dcbc837 100644 --- a/integrations/openclaw/config.ts +++ b/integrations/openclaw/config.ts @@ -148,6 +148,7 @@ const ALLOWED_KEYS = [ "mode", "apiKey", "anonymousTelemetryId", + "keyFingerprint", "baseUrl", "userId", "userEmail", diff --git a/integrations/openclaw/openclaw.plugin.json b/integrations/openclaw/openclaw.plugin.json index 2d9f46518..02d05be4b 100644 --- a/integrations/openclaw/openclaw.plugin.json +++ b/integrations/openclaw/openclaw.plugin.json @@ -209,6 +209,10 @@ "type": "string", "description": "Persistent anonymous telemetry identifier" }, + "keyFingerprint": { + "type": "string", + "description": "Digest of the API key userEmail was resolved for. Set automatically; a mismatch re-resolves the account." + }, "oss": { "type": "object", "properties": { diff --git a/integrations/openclaw/telemetry.ts b/integrations/openclaw/telemetry.ts index fc1c6b99d..bd77e1656 100644 --- a/integrations/openclaw/telemetry.ts +++ b/integrations/openclaw/telemetry.ts @@ -1,14 +1,20 @@ import { createHash, randomUUID } from "node:crypto"; import { createTelemetry } from "../agent-plugin-core/typescript/src/telemetry.ts"; -import { clearAnonymousTelemetryId, getBaseUrl, readPluginAuth, writePluginAuth } from "./cli/config-file.ts"; +import { + clearAnonymousTelemetryId, + clearResolvedAccount, + getBaseUrl, + readPluginAuth, + writePluginAuth, +} from "./cli/config-file.ts"; declare const __OPENCLAW_PLUGIN_VERSION__: string; export const PLUGIN_VERSION: string = __OPENCLAW_PLUGIN_VERSION__; let cachedAnonymousId: string | undefined; let aliasCheckDone = false; -let emailResolutionAttempted = false; +let resolutionAttemptedFor = ""; let currentDistinctId = ""; function enabled(): boolean { @@ -33,10 +39,35 @@ function anonymousId(): string { return (cachedAnonymousId = created); } +/** SHA-256 prefix of the key an account was resolved for. */ +function keyFingerprint(apiKey?: string): string { + return apiKey ? createHash("sha256").update(apiKey).digest("hex").slice(0, 16) : ""; +} + function distinctId(apiKey?: string): string { try { - const email = readPluginAuth().userEmail; - if (email) return createHash("sha256").update(email).digest("hex"); + const auth = readPluginAuth(); + if (auth.userEmail) { + // Only when it belongs to the key in hand. Without this check a cached + // email was used forever: switch to a different account and every event + // kept reporting under the previous one, with nothing to notice it by. + if (auth.keyFingerprint === keyFingerprint(apiKey)) { + return createHash("sha256").update(auth.userEmail).digest("hex"); + } + // Only a REAL key that disagrees means the account changed. Without the + // apiKey guard the comparison is `undefined === ""` for any call that + // simply omits the key, so a capture with no context wiped a perfectly + // good account out of openclaw.json. + // + // A row with an email and NO fingerprint is the legacy shape, from an + // install predating this field. Clearing it here deleted a real account + // before anything had replaced it, and if the re-resolve then failed + // because the user was offline the email was gone from disk for good. The + // Python core refuses the same trade: verify, and keep what you have until + // the verification succeeds. resolveEmail below overwrites both fields + // when it does, so there is nothing to clear first. + if (apiKey && auth.keyFingerprint) clearResolvedAccount(); + } } catch { // Fall through to the API key or anonymous identity. } @@ -66,8 +97,16 @@ function identifyAnonymous(id: string): void { } function resolveEmail(apiKey: string): void { - if (emailResolutionAttempted) return; - emailResolutionAttempted = true; + // Latched per key, not once per process. A single boolean meant a key changed + // mid-session was never looked up, so the fallback identity stuck until restart. + const fingerprint = keyFingerprint(apiKey); + if (resolutionAttemptedFor === fingerprint) return; + resolutionAttemptedFor = fingerprint; + const releaseLatch = () => { + // A failed lookup must not pin the fallback identity for the rest of the + // process. Released so the next capture tries again. + if (resolutionAttemptedFor === fingerprint) resolutionAttemptedFor = ""; + }; fetch(`${getBaseUrl().replace(/\/+$/, "")}/v1/ping/`, { method: "GET", headers: { Authorization: `Token ${apiKey}`, "Content-Type": "application/json" }, @@ -76,7 +115,7 @@ function resolveEmail(apiKey: string): void { .then((response) => response.json()) .then((data: any) => { if (!data?.user_email) return; - writePluginAuth({ userEmail: data.user_email }); + writePluginAuth({ userEmail: data.user_email, keyFingerprint: fingerprint }); const oldId = createHash("sha256").update(apiKey).digest("hex"); const newId = createHash("sha256").update(data.user_email).digest("hex"); for (const event of telemetry.queueForTesting()) { @@ -84,7 +123,8 @@ function resolveEmail(apiKey: string): void { } }) .catch(() => { - // The API-key hash remains a stable fallback. + // The API-key hash remains a stable fallback, and the next capture retries. + releaseLatch(); }); } @@ -96,13 +136,15 @@ export function captureEvent( if (!enabled()) return; try { currentDistinctId = distinctId(context?.apiKey); - let hasEmail = false; + let resolvedForThisKey = false; try { - hasEmail = Boolean(readPluginAuth().userEmail); + const auth = readPluginAuth(); + resolvedForThisKey = + Boolean(auth.userEmail) && auth.keyFingerprint === keyFingerprint(context?.apiKey); } catch { // Resolve it below when possible. } - if (context?.apiKey && !hasEmail) resolveEmail(context.apiKey); + if (context?.apiKey && !resolvedForThisKey) resolveEmail(context.apiKey); identifyAnonymous(currentDistinctId); telemetry.capture(eventName, { mode: context?.mode, diff --git a/integrations/openclaw/tests/config-file.test.ts b/integrations/openclaw/tests/config-file.test.ts index e059ddff3..ba63180cb 100644 --- a/integrations/openclaw/tests/config-file.test.ts +++ b/integrations/openclaw/tests/config-file.test.ts @@ -237,3 +237,43 @@ describe("getBaseUrl", () => { expect(getBaseUrl()).toBe(DEFAULT_BASE_URL); }); }); + +// --------------------------------------------------------------------------- +// keyFingerprint round trip +// --------------------------------------------------------------------------- + +describe("keyFingerprint survives a write and read", () => { + it("readPluginAuth returns a persisted keyFingerprint", () => { + // It did not. readPluginAuth builds its result field by field, and this one + // was missing, so every fingerprint comparison ran against undefined, the + // resolved email was never used again, and telemetry silently fell back to + // the API key hash. The telemetry tests could not see it because they mock + // this module and their mock returned the field the real reader dropped. + setConfigFile({ + plugins: { + entries: { + "openclaw-mem0": { + config: { + apiKey: "m0-test", + userEmail: "person@example.com", + keyFingerprint: "0123456789abcdef", + }, + }, + }, + }, + }); + + expect(readPluginAuth().keyFingerprint).toBe("0123456789abcdef"); + }); + + it("writePluginAuth persists it where readPluginAuth looks", () => { + setConfigFile({ plugins: { entries: { "openclaw-mem0": { config: {} } } } }); + + writePluginAuth({ userEmail: "person@example.com", keyFingerprint: "abc123" }); + + const written = JSON.parse(mockWriteText.mock.calls.at(-1)![1] as string); + const cfg = written.plugins.entries["openclaw-mem0"].config; + expect(cfg.keyFingerprint).toBe("abc123"); + expect(cfg.userEmail).toBe("person@example.com"); + }); +}); diff --git a/integrations/openclaw/tests/config.test.ts b/integrations/openclaw/tests/config.test.ts index 2c6dbac2e..334c064fb 100644 --- a/integrations/openclaw/tests/config.test.ts +++ b/integrations/openclaw/tests/config.test.ts @@ -485,3 +485,18 @@ describe("mem0ConfigSchema.parse() — apiKey edge cases", () => { expect(cfg.needsSetup).toBe(false); }); }); + +describe("telemetry fingerprint round trip", () => { + it("a config carrying keyFingerprint is accepted by the real schema", () => { + // What writePluginAuth persists after a successful lookup. It was not in + // ALLOWED_KEYS, and assertAllowedKeys throws, so the first successful + // resolve wrote a config that broke every subsequent load of the plugin. + const persisted = { + apiKey: "m0-test", + userEmail: "person@example.com", + keyFingerprint: "0123456789abcdef", + }; + + expect(() => mem0ConfigSchema.parse(persisted)).not.toThrow(); + }); +}); diff --git a/integrations/openclaw/tests/telemetry.test.ts b/integrations/openclaw/tests/telemetry.test.ts index 9a7bee716..ad7a9bbe0 100644 --- a/integrations/openclaw/tests/telemetry.test.ts +++ b/integrations/openclaw/tests/telemetry.test.ts @@ -3,15 +3,30 @@ import { describe, it, expect, vi, beforeEach, afterEach } from "vitest"; // Mock config-file before importing telemetry vi.mock("../cli/config-file.ts", () => ({ readPluginAuth: vi.fn().mockReturnValue({}), + writePluginAuth: vi.fn(), + clearAnonymousTelemetryId: vi.fn(), + clearResolvedAccount: vi.fn(), + getBaseUrl: vi.fn().mockReturnValue("https://api.mem0.ai"), })); import { captureEvent } from "../telemetry.ts"; -import { readPluginAuth } from "../cli/config-file.ts"; +import { clearResolvedAccount, readPluginAuth } from "../cli/config-file.ts"; + +/** sha256(key).slice(0, 16), the shape telemetry.ts stores. */ +async function fingerprintOf(apiKey: string): Promise { + const { createHash } = await import("node:crypto"); + return createHash("sha256").update(apiKey).digest("hex").slice(0, 16); +} describe("telemetry", () => { let fetchSpy: ReturnType; beforeEach(() => { + // Call history has to be cleared per test, not just restored: the mocks are + // module-level vi.fn()s, so without this one test's calls are visible to the + // next and assertions on "was not called" pass or fail by ordering. + vi.clearAllMocks(); + (readPluginAuth as ReturnType).mockReturnValue({}); // Reset telemetry enabled state (globalThis as any).__mem0_telemetry_override = undefined; fetchSpy = vi.fn().mockResolvedValue({ ok: true }); @@ -40,11 +55,31 @@ describe("telemetry", () => { expect(() => captureEvent("test_event")).not.toThrow(); }); - it("uses userEmail as distinct ID when available", () => { - (readPluginAuth as ReturnType).mockReturnValueOnce({ + it("uses userEmail as distinct ID when it belongs to the current key", async () => { + // Previously asserted only not.toThrow(), which passed whatever the identity + // turned out to be, and under the fingerprint gate the no-context path does + // not use the email at all. Pin the real condition instead. + (readPluginAuth as ReturnType).mockReturnValue({ userEmail: "test@example.com", + keyFingerprint: await fingerprintOf("key-a"), }); - expect(() => captureEvent("test_event")).not.toThrow(); + + captureEvent("test_event", {}, { apiKey: "key-a" }); + + expect(clearResolvedAccount).not.toHaveBeenCalled(); + }); + + it("a capture with no apiKey leaves a resolved account alone", async () => { + // `undefined === ""` made every keyless capture look like a key change, so + // one context-free call wiped a good account out of openclaw.json. + (readPluginAuth as ReturnType).mockReturnValue({ + userEmail: "test@example.com", + keyFingerprint: await fingerprintOf("key-a"), + }); + + captureEvent("test_event"); + + expect(clearResolvedAccount).not.toHaveBeenCalled(); }); it("falls back to a generated anonymous id when no apiKey", () => { @@ -52,6 +87,43 @@ describe("telemetry", () => { expect(() => captureEvent("test_event", {}, {})).not.toThrow(); }); + it("keeps using a cached email only while it belongs to the current key", async () => { + (readPluginAuth as ReturnType).mockReturnValue({ + userEmail: "person@example.com", + keyFingerprint: await fingerprintOf("key-a"), + }); + + captureEvent("test_event", {}, { apiKey: "key-a" }); + + expect(clearResolvedAccount).not.toHaveBeenCalled(); + }); + + it("forgets the account when the API key changes", async () => { + // The defect: the cached email was used forever, so events after an account + // switch kept reporting under the previous account. + (readPluginAuth as ReturnType).mockReturnValue({ + userEmail: "person@example.com", + keyFingerprint: await fingerprintOf("key-a"), + }); + + captureEvent("test_event", {}, { apiKey: "key-b" }); + + expect(clearResolvedAccount).toHaveBeenCalled(); + }); + + it("re-resolves for a key it has not looked up before", async () => { + (readPluginAuth as ReturnType).mockReturnValue({ + userEmail: "person@example.com", + keyFingerprint: await fingerprintOf("key-a"), + }); + + captureEvent("test_event", {}, { apiKey: "key-c" }); + + // The resolution latch is per key, not once per process, so a key changed + // mid-session is actually looked up instead of sticking to the fallback. + expect(fetchSpy).toHaveBeenCalled(); + }); + it("handles readPluginAuth errors gracefully", () => { (readPluginAuth as ReturnType).mockImplementationOnce(() => { throw new Error("config read failed"); diff --git a/integrations/opencode-plugin/package.json b/integrations/opencode-plugin/package.json index 79f68c4a8..acdbaf469 100644 --- a/integrations/opencode-plugin/package.json +++ b/integrations/opencode-plugin/package.json @@ -38,6 +38,7 @@ "build": "bun build opencode-mem0.ts --outdir dist --target bun --format esm --entry-naming index.[ext]", "dev": "bun build opencode-mem0.ts --outdir dist --target bun --format esm --entry-naming index.[ext] --watch", "type-check": "tsc --noEmit", + "test": "bun test", "prepack": "bun run build", "postpack": "" }, diff --git a/integrations/opencode-plugin/telemetry.test.ts b/integrations/opencode-plugin/telemetry.test.ts index 393150977..79dc3ffdb 100644 --- a/integrations/opencode-plugin/telemetry.test.ts +++ b/integrations/opencode-plugin/telemetry.test.ts @@ -1,3 +1,5 @@ +import { createHash } from "node:crypto"; + import { afterEach, describe, expect, test } from "bun:test"; import { buildEvent, captureEvent, isTelemetryEnabled } from "./telemetry"; @@ -13,7 +15,10 @@ describe("opencode telemetry", () => { expect(payload).not.toBeNull(); const props = payload!.properties as Record; expect(payload!.event).toBe("plugin.session_start"); - expect(props.source).toBe("plugin"); + // Was "plugin", which named no particular plugin and matched no vocabulary. + // Now shaped like every other surface. Any saved PostHog insight filtering + // source = "plugin" needs repointing; historical data is untouched. + expect(props.source).toBe("OPENCODE_PLUGIN"); expect(props.platform).toBe("opencode"); expect(props.memory_count).toBe(5); expect(props.$process_person_profile).toBe(false); @@ -30,7 +35,7 @@ describe("opencode telemetry", () => { const props = buildEvent("x", { platform: "HACK", source: "HACK" }, KEY)! .properties as Record; expect(props.platform).toBe("opencode"); - expect(props.source).toBe("plugin"); + expect(props.source).toBe("OPENCODE_PLUGIN"); }); test("returns null without an API key (no anonymous events)", () => { @@ -56,9 +61,12 @@ describe("opencode telemetry", () => { expect(typeof props.os_version).toBe("string"); }); - test("project_hash is sha256(projectId) when a project id is supplied", async () => { + test("project_hash is a salted digest of the project id", async () => { + // Previously asserted the bare sha256(projectId), which is the defect: that + // digest is reversible by anyone who can guess a project id. Salted with the + // API key, which is already in play here and is high entropy. const { createHash } = await import("node:crypto"); - const expected = createHash("sha256").update("acme-repo").digest("hex"); + const expected = createHash("sha256").update(`${KEY}:acme-repo`).digest("hex"); const props = buildEvent("session_start", {}, KEY, "acme-repo")! .properties as Record; expect(props.project_hash).toBe(expected); @@ -76,3 +84,38 @@ describe("opencode telemetry", () => { } }); }); + +describe("project_hash salting", () => { + const PROJECT = "my-project"; + + test("is not a bare digest of the project id", () => { + // The defect: an unsalted SHA-256 over a guessable identifier is reversible + // by anyone who can enumerate project ids. + const unsalted = createHash("sha256").update(PROJECT).digest("hex"); + const payload = buildEvent("session_start", {}, KEY, PROJECT) as Record; + + expect(payload.properties.project_hash).toBeDefined(); + expect(payload.properties.project_hash).not.toBe(unsalted); + }); + + test("differs per account for the same project", () => { + const a = buildEvent("session_start", {}, "m0-account-a", PROJECT) as Record; + const b = buildEvent("session_start", {}, "m0-account-b", PROJECT) as Record; + + expect(a.properties.project_hash).not.toBe(b.properties.project_hash); + }); + + test("is stable for one account, so joins still work", () => { + const first = buildEvent("session_start", {}, KEY, PROJECT) as Record; + const second = buildEvent("session_end", {}, KEY, PROJECT) as Record; + + expect(first.properties.project_hash).toBe(second.properties.project_hash); + }); + + test("is omitted rather than unsalted when there is no key", () => { + const payload = buildEvent("session_start", {}, undefined, PROJECT); + + // No key means no event at all, so there is no unsalted hash to leak. + expect(payload).toBeNull(); + }); +}); diff --git a/integrations/opencode-plugin/telemetry.ts b/integrations/opencode-plugin/telemetry.ts index 8d0861d97..e2316dd88 100644 --- a/integrations/opencode-plugin/telemetry.ts +++ b/integrations/opencode-plugin/telemetry.ts @@ -25,7 +25,9 @@ const PLUGIN_VERSION = (() => { let currentDistinctId = ""; const telemetry = createTelemetry({ host: "opencode", - source: "plugin", + // Shaped like the platform's EventSource values, as every other surface is. + // "plugin" said nothing about which plugin and matched no vocabulary. + source: "OPENCODE_PLUGIN", version: PLUGIN_VERSION, distinctId: () => currentDistinctId, eventName: (event) => `plugin.${event}`, @@ -40,8 +42,23 @@ function distinctId(apiKey: string): string { return createHash("sha256").update(apiKey).digest("hex").slice(0, 32); } -function projectHash(projectId?: string): Record { - return projectId ? { project_hash: createHash("sha256").update(projectId).digest("hex") } : {}; +/** + * Salted so the hash is not enumerable. + * + * An unsalted SHA-256 of a project id is reversible by anyone who can guess the + * id, which for a project identifier is a small space. The API key is the salt: + * it is already in play here (distinctId is a digest of it), it is high entropy, + * and using it needs no per-install file and so no write race to get wrong. The + * hash is therefore per account rather than per machine, which also keeps joins + * working for one user across machines. It resets when the key rotates, which is + * consistent, because distinctId resets with it. + * + * Both are omitted without a key. An event cannot be built without a distinctId + * anyway, so this costs nothing. + */ +function projectHash(projectId?: string, apiKey?: string): Record { + if (!projectId || !apiKey) return {}; + return { project_hash: createHash("sha256").update(`${apiKey}:${projectId}`).digest("hex") }; } export function buildEvent( @@ -51,7 +68,7 @@ export function buildEvent( projectId?: string, ): Record | null { currentDistinctId = apiKey ? distinctId(apiKey) : ""; - const event = telemetry.build(eventType, { ...properties, ...projectHash(projectId) }); + const event = telemetry.build(eventType, { ...properties, ...projectHash(projectId, apiKey) }); return event ? { api_key: POSTHOG_API_KEY, ...event } : null; } @@ -62,5 +79,5 @@ export function captureEvent( projectId?: string, ): void { currentDistinctId = apiKey ? distinctId(apiKey) : ""; - telemetry.capture(eventType, { ...properties, ...projectHash(projectId) }); + telemetry.capture(eventType, { ...properties, ...projectHash(projectId, apiKey) }); } From 19f713408273fb1d657daa38d7b82ccf496d36d5 Mon Sep 17 00:00:00 2001 From: Saket Aryan Date: Fri, 18 Sep 2026 16:28:55 +0530 Subject: [PATCH 14/55] chore(release): bump every package the telemetry attribution work changed (#7373) Co-authored-by: kartik-mem0 --- .claude-plugin/marketplace.json | 2 +- .cursor-plugin/marketplace.json | 2 +- .kimi-plugin/marketplace.json | 2 +- cli/node/package.json | 2 +- cli/python/pyproject.toml | 2 +- cli/python/src/mem0_cli/__init__.py | 2 +- docs/changelog/sdk.mdx | 131 +++++++++++++----- .../agent-plugin-core/python/memory_core.py | 2 +- .../antigravity-plugin/core/memory_core.py | 2 +- .../antigravity-plugin/plugin-build.json | 2 +- .../.claude-plugin/plugin.json | 2 +- .../claude-code-plugin/core/memory_core.py | 2 +- .../claude-code-plugin/plugin-build.json | 2 +- .../tests/test_memory_core.py | 8 +- .../codex-plugin/.codex-plugin/plugin.json | 2 +- integrations/codex-plugin/core/memory_core.py | 2 +- integrations/codex-plugin/plugin-build.json | 2 +- .../cursor-plugin/.cursor-plugin/plugin.json | 2 +- .../cursor-plugin/core/memory_core.py | 2 +- integrations/cursor-plugin/plugin-build.json | 2 +- integrations/deepseek-plugin/package.json | 2 +- integrations/kimi-plugin/core/memory_core.py | 2 +- integrations/kimi-plugin/kimi.plugin.json | 2 +- integrations/kimi-plugin/plugin-build.json | 2 +- .../mem0-agent-plugin/core/memory_core.py | 2 +- integrations/mem0-agent-plugin/plugin.json | 2 +- integrations/openclaw/openclaw.plugin.json | 2 +- integrations/openclaw/package.json | 2 +- integrations/opencode-plugin/package.json | 2 +- integrations/pi-agent-plugin/package.json | 2 +- integrations/vercel-ai-sdk/package.json | 2 +- marketplace.json | 2 +- mem0-ts/package.json | 2 +- pyproject.toml | 2 +- 34 files changed, 135 insertions(+), 68 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index d46a19e49..ccaa4dcea 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -12,7 +12,7 @@ "name": "mem0", "source": "./integrations/claude-code-plugin", "description": "Cross-session memory and token savings for coding agents.", - "version": "0.3.1" + "version": "0.3.2" } ] } diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 409b7d8fc..84f31855b 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -12,7 +12,7 @@ "name": "mem0", "source": "./integrations/cursor-plugin", "description": "Cross-session memory and token savings for coding agents.", - "version": "0.3.1" + "version": "0.3.2" } ] } diff --git a/.kimi-plugin/marketplace.json b/.kimi-plugin/marketplace.json index 8ff2134b4..0b8cbcac0 100644 --- a/.kimi-plugin/marketplace.json +++ b/.kimi-plugin/marketplace.json @@ -5,7 +5,7 @@ { "id": "mem0", "displayName": "Mem0", - "version": "0.3.1", + "version": "0.3.2", "description": "Cross-session memory and token savings for coding agents.", "homepage": "https://mem0.ai", "keywords": ["memory", "personalization", "mcp", "semantic-search"], diff --git a/cli/node/package.json b/cli/node/package.json index d078066e2..b2f57b09f 100644 --- a/cli/node/package.json +++ b/cli/node/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/cli", - "version": "0.2.13", + "version": "0.2.14", "description": "The official CLI for mem0 — the memory layer for AI agents", "type": "module", "bin": { diff --git a/cli/python/pyproject.toml b/cli/python/pyproject.toml index be7e72709..961d2b78d 100644 --- a/cli/python/pyproject.toml +++ b/cli/python/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "hatchling.build" [project] name = "mem0-cli" -version = "0.2.12" +version = "0.2.13" description = "The official CLI for mem0 — the memory layer for AI agents" readme = "README.md" license = "Apache-2.0" diff --git a/cli/python/src/mem0_cli/__init__.py b/cli/python/src/mem0_cli/__init__.py index 6d686291e..0aeb58270 100644 --- a/cli/python/src/mem0_cli/__init__.py +++ b/cli/python/src/mem0_cli/__init__.py @@ -1,3 +1,3 @@ """mem0 CLI — the command-line interface for the mem0 memory layer.""" -__version__ = "0.2.12" +__version__ = "0.2.13" diff --git a/docs/changelog/sdk.mdx b/docs/changelog/sdk.mdx index 71fb7e1d8..50922493e 100644 --- a/docs/changelog/sdk.mdx +++ b/docs/changelog/sdk.mdx @@ -7,6 +7,14 @@ mode: "wide" + + +**Improvements:** +- **Client:** Requests now carry three surface-identity headers so the platform can tell which product made a call. `X-Mem0-Source` names the surface and `X-Application` the host app it runs inside, both set-once so a wrapper that already declared its identity keeps it. `X-Mem0-Client` is append-only and carries `name/version` per layer, outermost first, so a plugin calling this SDK reports the whole chain rather than only the last speaker. `MEM0_SOURCE`, `MEM0_APPLICATION` and `MEM0_CLIENT_STACK` set them from the environment for wrappers that cannot pass options ([#7326](https://github.com/mem0ai/mem0/pull/7326)) +- **Client:** The client stack is bounded by dropping whole entries rather than slicing characters, and this SDK's own entry is the reserved one. Truncating the joined string could sever an identifier mid-name and the platform parsed the fragment as a real client ([#7326](https://github.com/mem0ai/mem0/pull/7326)) + + + **Improvements:** @@ -1227,6 +1235,14 @@ See the [OSS v2 to v3 migration guide](https://docs.mem0.ai/migration/oss-v2-to- + + +**Improvements:** +- **Client:** Requests now carry `X-Mem0-Source`, `X-Application` and `X-Mem0-Client`, matching the Python SDK. The first two are set-once so an outer wrapper keeps its identity; the third is append-only and reports the whole layer chain. Read from `MEM0_SOURCE`, `MEM0_APPLICATION` and `MEM0_CLIENT_STACK` when set ([#7326](https://github.com/mem0ai/mem0/pull/7326)) +- **Client:** The SDK version in `X-Mem0-Client` is injected at build time rather than hardcoded, so it cannot go stale at the next release ([#7326](https://github.com/mem0ai/mem0/pull/7326)) + + + **Improvements:** @@ -1864,6 +1880,13 @@ See the [OSS v2 to v3 migration guide](https://docs.mem0.ai/migration/oss-v2-to- + + +**Improvements:** +- **Client:** Requests now carry the three surface-identity headers (`X-Mem0-Source`, `X-Application`, `X-Mem0-Client`) introduced in the Python and TypeScript SDKs, so the platform can attribute calls made through the CLI to the correct surface and version ([#7326](https://github.com/mem0ai/mem0/pull/7326)) + + + **New Features:** @@ -2076,7 +2099,7 @@ A full-featured command-line interface for Mem0, available in both Python and No - New Git repository writes use a hash of the remote identity in `agent_id`. Search and explicit shared-memory deletion include both current and legacy repository IDs within the repository's `app_id`. Existing memories are not rewritten. Legacy IDs retain their original ambiguity for matching owner/repository names on different Git hosts. **Packaging:** -- Claude Code, Cursor, Codex, Kimi, Antigravity, and the portable Python bundle are versioned at `0.3.1`. OpenCode, Pi Agent, and DeepSeek Harness are `0.3.0`; OpenClaw is `1.1.0`. Each host's changes and upgrade considerations are listed in its tab. +- Claude Code, Cursor, Codex, Kimi, Antigravity, and the portable Python bundle are versioned at `0.3.1`. OpenCode and DeepSeek Harness are `0.3.0`; Pi Agent is `0.3.0`; OpenClaw is `1.1.0`. Each host's changes and upgrade considerations are listed in its tab. - Python and TypeScript CI run their respective runtime suites. Package checks build the installable artifacts, check generated-file consistency, and reject TypeScript output that still imports monorepo source. [#7203](https://github.com/mem0ai/mem0/pull/7203) @@ -2371,9 +2394,14 @@ Initial release of the Mem0 plugin for Claude Code and Cursor, followed by Codex - + -Sidekick is now available only in Claude Code, with Sonnet, worktree isolation, and parent memories. +**Improvements:** +- **Telemetry:** `PLUGIN_VERSION` bumped to `0.3.2`. The `mem0-plugin/` wire header and `plugin_version` telemetry field now reflect the fixes from #7322 through #7358 ([#7373](https://github.com/mem0ai/mem0/pull/7373)) +- **Telemetry:** Events are no longer delivered twice, no longer lose parked events on flush, and now attribute each event to the plugin that produced it ([#7323](https://github.com/mem0ai/mem0/pull/7323), [#7324](https://github.com/mem0ai/mem0/pull/7324), [#7358](https://github.com/mem0ai/mem0/pull/7358)) + +**Changes:** +- **Sidekick:** Sidekick is now available only in Claude Code, with Sonnet, worktree isolation, and parent memories. @@ -2396,9 +2424,14 @@ Sidekick is now available only in Claude Code, with Sonnet, worktree isolation, - + -Removes Sidekick and its start/stop hooks. Memory capture, search, and six skills remain available. +**Improvements:** +- **Telemetry:** `PLUGIN_VERSION` bumped to `0.3.2`. The `mem0-plugin/` wire header and `plugin_version` telemetry field now reflect the fixes from #7322 through #7358 ([#7373](https://github.com/mem0ai/mem0/pull/7373)) +- **Telemetry:** Events are no longer delivered twice, no longer lose parked events on flush, and now attribute each event to the plugin that produced it ([#7323](https://github.com/mem0ai/mem0/pull/7323), [#7324](https://github.com/mem0ai/mem0/pull/7324), [#7358](https://github.com/mem0ai/mem0/pull/7358)) + +**Changes:** +- **Sidekick:** Removes Sidekick and its start/stop hooks. Memory capture, search, and six skills remain available. @@ -2421,9 +2454,14 @@ Removes Sidekick and its start/stop hooks. Memory capture, search, and six skill - + -Renames shared tracking to use subagent terminology. Native subagent memory support remains available. +**Improvements:** +- **Telemetry:** `PLUGIN_VERSION` bumped to `0.3.2`. The `mem0-plugin/` wire header and `plugin_version` telemetry field now reflect the fixes from #7322 through #7358 ([#7373](https://github.com/mem0ai/mem0/pull/7373)) +- **Telemetry:** Events are no longer delivered twice, no longer lose parked events on flush, and now attribute each event to the plugin that produced it ([#7323](https://github.com/mem0ai/mem0/pull/7323), [#7324](https://github.com/mem0ai/mem0/pull/7324), [#7358](https://github.com/mem0ai/mem0/pull/7358)) + +**Changes:** +- **Sidekick:** Renames shared tracking to use subagent terminology. Native subagent memory support remains available. @@ -2443,32 +2481,16 @@ Renames shared tracking to use subagent terminology. Native subagent memory supp - - - - -Sidekick is available only in Claude Code, not in the portable package. - - - - - -**Added:** -- One portable package at `integrations/mem0-agent-plugin/`, using the Agent Plugins 1.0.0 root `plugin.json`, `mcp.json`, and fixed `skills/` locations. -- Ships a local, read-only `search_memories` server and the six shared memory skills. Uses `PLUGIN_ROOT` for bundled files and `PLUGIN_DATA` for persistent plugin state; all package files remain inside the installable directory. - -**Packaging:** -- Generated from the shared Python runtime and skill templates. Builds validate the manifest, MCP configuration, skills, and generated-file consistency. -- Host lifecycle hooks and native Sidekick declarations remain in the native plugin packages; the portable package does not provide automatic lifecycle capture or host-specific subagent isolation. Its bundled remember skill cannot persist a new memory on its own because the portable package has no capture hooks or write tool. - -[#7203](https://github.com/mem0ai/mem0/pull/7203) - - - - - + + +**Changes:** +- **Telemetry:** The PostHog `source` tag changed from the literal `"plugin"` to `OPENCODE_PLUGIN`, and `project_hash` is now salted. Saved PostHog insights filtering on `source = "plugin"` will stop matching new events; historical data is unaffected ([#7322](https://github.com/mem0ai/mem0/pull/7322)) +- **Config:** A new `keyFingerprint` key appears in the install-count deduplication logic; installs are now counted once per key rather than on every activation ([#7325](https://github.com/mem0ai/mem0/pull/7325)) + + + **Changed:** @@ -2567,9 +2589,14 @@ Sidekick is available only in Claude Code, not in the portable package. - + -Removes Sidekick. Memory capture, search, and six skills remain available. +**Improvements:** +- **Telemetry:** `PLUGIN_VERSION` bumped to `0.3.2`. The `mem0-plugin/` wire header and `plugin_version` telemetry field now reflect the fixes from #7322 through #7358 ([#7373](https://github.com/mem0ai/mem0/pull/7373)) +- **Telemetry:** Events are no longer delivered twice, no longer lose parked events on flush, and now attribute each event to the plugin that produced it ([#7323](https://github.com/mem0ai/mem0/pull/7323), [#7324](https://github.com/mem0ai/mem0/pull/7324), [#7358](https://github.com/mem0ai/mem0/pull/7358)) + +**Changes:** +- **Sidekick:** Removes Sidekick. Memory capture, search, and six skills remain available. @@ -2665,9 +2692,14 @@ Existing memories written by the previous versions are not rewritten. If your me - + -Removes Sidekick and its start/stop hooks. Memory capture, recall, and six skills remain available. +**Improvements:** +- **Telemetry:** `PLUGIN_VERSION` bumped to `0.3.2`. The `mem0-plugin/` wire header and `plugin_version` telemetry field now reflect the fixes from #7322 through #7358 ([#7373](https://github.com/mem0ai/mem0/pull/7373)) +- **Telemetry:** Events are no longer delivered twice, no longer lose parked events on flush, and now attribute each event to the plugin that produced it ([#7323](https://github.com/mem0ai/mem0/pull/7323), [#7324](https://github.com/mem0ai/mem0/pull/7324), [#7358](https://github.com/mem0ai/mem0/pull/7358)) + +**Changes:** +- **Sidekick:** Removes Sidekick and its start/stop hooks. Memory capture, recall, and six skills remain available. @@ -2705,6 +2737,14 @@ Removes Sidekick and its start/stop hooks. Memory capture, recall, and six skill + + +**Changes:** +- **Config:** Added `keyFingerprint` to the config schema for install-count deduplication; installs are now counted once per key rather than on every activation ([#7325](https://github.com/mem0ai/mem0/pull/7325)) +- **Telemetry:** Events are no longer delivered twice, and the `plugin_version` field now reflects the plugin that produced the event ([#7323](https://github.com/mem0ai/mem0/pull/7323), [#7324](https://github.com/mem0ai/mem0/pull/7324), [#7358](https://github.com/mem0ai/mem0/pull/7358)) + + + **Changed:** @@ -2993,6 +3033,13 @@ Removes Sidekick and its start/stop hooks. Memory capture, recall, and six skill + + +**Improvements:** +- **Telemetry:** Events are no longer delivered twice, no longer lose parked events, and now attribute each event to the plugin that produced it. The `plugin_version` wire field reflects the fixed release ([#7323](https://github.com/mem0ai/mem0/pull/7323), [#7324](https://github.com/mem0ai/mem0/pull/7324), [#7358](https://github.com/mem0ai/mem0/pull/7358)) + + + **Changed:** @@ -3106,6 +3153,13 @@ Removes Sidekick and its start/stop hooks. Memory capture, recall, and six skill + + +**Improvements:** +- **Telemetry:** Rebuild with the fixed shared telemetry core from `agent-plugin-core`. Events are no longer delivered twice, no longer lose parked events on flush, and now attribute each event to the plugin that produced it ([#7323](https://github.com/mem0ai/mem0/pull/7323), [#7324](https://github.com/mem0ai/mem0/pull/7324), [#7358](https://github.com/mem0ai/mem0/pull/7358)) + + + **Added:** @@ -3150,6 +3204,13 @@ Removes Sidekick and its start/stop hooks. Memory capture, recall, and six skill + + +**Improvements:** +- **Client:** Inherits the three surface-identity headers (`X-Mem0-Source`, `X-Application`, `X-Mem0-Client`) from the TypeScript SDK bump, so platform calls made through the Vercel AI SDK provider are now correctly attributed ([#7326](https://github.com/mem0ai/mem0/pull/7326)) + + + **Security:** diff --git a/integrations/agent-plugin-core/python/memory_core.py b/integrations/agent-plugin-core/python/memory_core.py index d350e76d2..ea2670dac 100644 --- a/integrations/agent-plugin-core/python/memory_core.py +++ b/integrations/agent-plugin-core/python/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.1" +PLUGIN_VERSION = "0.3.2" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" diff --git a/integrations/antigravity-plugin/core/memory_core.py b/integrations/antigravity-plugin/core/memory_core.py index d350e76d2..ea2670dac 100644 --- a/integrations/antigravity-plugin/core/memory_core.py +++ b/integrations/antigravity-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.1" +PLUGIN_VERSION = "0.3.2" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" diff --git a/integrations/antigravity-plugin/plugin-build.json b/integrations/antigravity-plugin/plugin-build.json index ac65c4bea..43b90d8cb 100644 --- a/integrations/antigravity-plugin/plugin-build.json +++ b/integrations/antigravity-plugin/plugin-build.json @@ -1,6 +1,6 @@ { "id": "mem0", - "version": "0.3.1", + "version": "0.3.2", "homepage": "https://docs.mem0.ai/integrations/antigravity", "native": { "pluginRoot": "${ANTIGRAVITY_PLUGIN_ROOT}", diff --git a/integrations/claude-code-plugin/.claude-plugin/plugin.json b/integrations/claude-code-plugin/.claude-plugin/plugin.json index 6f214cc14..0dd8298e9 100644 --- a/integrations/claude-code-plugin/.claude-plugin/plugin.json +++ b/integrations/claude-code-plugin/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "mem0", - "version": "0.3.1", + "version": "0.3.2", "description": "Cross-session memory and token savings for coding agents.", "author": { "name": "Mem0" diff --git a/integrations/claude-code-plugin/core/memory_core.py b/integrations/claude-code-plugin/core/memory_core.py index d350e76d2..ea2670dac 100644 --- a/integrations/claude-code-plugin/core/memory_core.py +++ b/integrations/claude-code-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.1" +PLUGIN_VERSION = "0.3.2" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" diff --git a/integrations/claude-code-plugin/plugin-build.json b/integrations/claude-code-plugin/plugin-build.json index 68d306fd6..4b98c2919 100644 --- a/integrations/claude-code-plugin/plugin-build.json +++ b/integrations/claude-code-plugin/plugin-build.json @@ -1,6 +1,6 @@ { "id": "mem0", - "version": "0.3.1", + "version": "0.3.2", "homepage": "https://docs.mem0.ai/integrations/claude-code", "native": { "pluginRoot": "${CLAUDE_PLUGIN_ROOT}", diff --git a/integrations/claude-code-plugin/tests/test_memory_core.py b/integrations/claude-code-plugin/tests/test_memory_core.py index 8c7017913..9aea939cf 100644 --- a/integrations/claude-code-plugin/tests/test_memory_core.py +++ b/integrations/claude-code-plugin/tests/test_memory_core.py @@ -1,6 +1,7 @@ from __future__ import annotations import json +import re import os import sqlite3 import subprocess @@ -3460,7 +3461,12 @@ def test_automatic_flush_can_be_disabled_for_external_harnesses(isolated_env): def test_version_is_single_sourced(): manifest = json.loads((PLUGIN_ROOT / ".claude-plugin" / "plugin.json").read_text()) assert manifest["name"] == "mem0" - assert manifest["version"] == memory_core.PLUGIN_VERSION == "0.3.1" + # Compared against PLUGIN_VERSION, never a literal. A hardcoded version here + # was one more place to edit on every release, inside the test asserting the + # version is single-sourced, and it caught nothing that the agreement checks + # below do not: fifteen places set to the same wrong value would still pass. + assert re.fullmatch(r"\d+\.\d+\.\d+", memory_core.PLUGIN_VERSION), memory_core.PLUGIN_VERSION + assert manifest["version"] == memory_core.PLUGIN_VERSION root = REPOSITORY_ROOT for mp in (root / "marketplace.json", root / ".claude-plugin" / "marketplace.json"): entry = next(p for p in json.loads(mp.read_text())["plugins"] if p["name"] == "mem0") diff --git a/integrations/codex-plugin/.codex-plugin/plugin.json b/integrations/codex-plugin/.codex-plugin/plugin.json index 916b72e66..0a80bf9e3 100644 --- a/integrations/codex-plugin/.codex-plugin/plugin.json +++ b/integrations/codex-plugin/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "mem0", - "version": "0.3.1", + "version": "0.3.2", "description": "Cross-session memory and token savings for coding agents.", "author": { "name": "Mem0", "email": "support@mem0.ai" }, "homepage": "https://docs.mem0.ai/integrations/codex", diff --git a/integrations/codex-plugin/core/memory_core.py b/integrations/codex-plugin/core/memory_core.py index d350e76d2..ea2670dac 100644 --- a/integrations/codex-plugin/core/memory_core.py +++ b/integrations/codex-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.1" +PLUGIN_VERSION = "0.3.2" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" diff --git a/integrations/codex-plugin/plugin-build.json b/integrations/codex-plugin/plugin-build.json index 8d4c51c07..7f5fc94f6 100644 --- a/integrations/codex-plugin/plugin-build.json +++ b/integrations/codex-plugin/plugin-build.json @@ -1,6 +1,6 @@ { "id": "mem0", - "version": "0.3.1", + "version": "0.3.2", "homepage": "https://docs.mem0.ai/integrations/codex", "native": { "pluginRoot": "${PLUGIN_ROOT}", diff --git a/integrations/cursor-plugin/.cursor-plugin/plugin.json b/integrations/cursor-plugin/.cursor-plugin/plugin.json index e33de76a2..a30f9ad9a 100644 --- a/integrations/cursor-plugin/.cursor-plugin/plugin.json +++ b/integrations/cursor-plugin/.cursor-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "mem0", - "version": "0.3.1", + "version": "0.3.2", "description": "Cross-session memory and token savings for coding agents.", "author": { "name": "Mem0", "email": "support@mem0.ai" }, "homepage": "https://docs.mem0.ai/integrations/cursor", diff --git a/integrations/cursor-plugin/core/memory_core.py b/integrations/cursor-plugin/core/memory_core.py index d350e76d2..ea2670dac 100644 --- a/integrations/cursor-plugin/core/memory_core.py +++ b/integrations/cursor-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.1" +PLUGIN_VERSION = "0.3.2" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" diff --git a/integrations/cursor-plugin/plugin-build.json b/integrations/cursor-plugin/plugin-build.json index 279b3178c..30024586e 100644 --- a/integrations/cursor-plugin/plugin-build.json +++ b/integrations/cursor-plugin/plugin-build.json @@ -1,6 +1,6 @@ { "id": "mem0", - "version": "0.3.1", + "version": "0.3.2", "homepage": "https://docs.mem0.ai/integrations/cursor", "native": { "pluginRoot": "${CURSOR_PLUGIN_ROOT}", diff --git a/integrations/deepseek-plugin/package.json b/integrations/deepseek-plugin/package.json index ea00bb9c5..2df84283c 100644 --- a/integrations/deepseek-plugin/package.json +++ b/integrations/deepseek-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/deepseek-plugin", - "version": "0.3.0", + "version": "0.3.1", "description": "Mem0 long-term memory as a native DeepSeek Harness (Cordis) plugin.", "type": "module", "license": "Apache-2.0", diff --git a/integrations/kimi-plugin/core/memory_core.py b/integrations/kimi-plugin/core/memory_core.py index d350e76d2..ea2670dac 100644 --- a/integrations/kimi-plugin/core/memory_core.py +++ b/integrations/kimi-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.1" +PLUGIN_VERSION = "0.3.2" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" diff --git a/integrations/kimi-plugin/kimi.plugin.json b/integrations/kimi-plugin/kimi.plugin.json index 0d63501fe..e58bec328 100644 --- a/integrations/kimi-plugin/kimi.plugin.json +++ b/integrations/kimi-plugin/kimi.plugin.json @@ -1,6 +1,6 @@ { "name": "mem0", - "version": "0.3.1", + "version": "0.3.2", "description": "Cross-session memory and token savings for coding agents.", "keywords": ["memory", "coding-agents", "continual-learning", "token-efficiency"], "author": { "name": "Mem0", "email": "support@mem0.ai" }, diff --git a/integrations/kimi-plugin/plugin-build.json b/integrations/kimi-plugin/plugin-build.json index 3926a57df..e73643eab 100644 --- a/integrations/kimi-plugin/plugin-build.json +++ b/integrations/kimi-plugin/plugin-build.json @@ -1,6 +1,6 @@ { "id": "mem0", - "version": "0.3.1", + "version": "0.3.2", "homepage": "https://docs.mem0.ai/integrations/kimi", "native": { "pluginRoot": "${KIMI_PLUGIN_ROOT}", diff --git a/integrations/mem0-agent-plugin/core/memory_core.py b/integrations/mem0-agent-plugin/core/memory_core.py index d350e76d2..ea2670dac 100644 --- a/integrations/mem0-agent-plugin/core/memory_core.py +++ b/integrations/mem0-agent-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.1" +PLUGIN_VERSION = "0.3.2" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" diff --git a/integrations/mem0-agent-plugin/plugin.json b/integrations/mem0-agent-plugin/plugin.json index 2cbaa99de..7a2baba80 100644 --- a/integrations/mem0-agent-plugin/plugin.json +++ b/integrations/mem0-agent-plugin/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "mem0", - "version": "0.3.1", + "version": "0.3.2", "description": "Cross-session memory and token savings for coding agents.", "author": { "name": "Mem0", diff --git a/integrations/openclaw/openclaw.plugin.json b/integrations/openclaw/openclaw.plugin.json index 02d05be4b..9d4cacaf8 100644 --- a/integrations/openclaw/openclaw.plugin.json +++ b/integrations/openclaw/openclaw.plugin.json @@ -2,7 +2,7 @@ "id": "openclaw-mem0", "name": "Memory (Mem0)", "description": "Mem0 memory backend for OpenClaw — platform (mem0.ai cloud) or self-hosted open-source. Auto-recall and auto-capture are opt-in (disabled by default). Supports OpenAI, Anthropic, Ollama (fully local), Qdrant, and PGVector providers.", - "version": "1.1.0", + "version": "1.2.0", "kind": "memory", "skills": ["skills"], "commandAliases": [ diff --git a/integrations/openclaw/package.json b/integrations/openclaw/package.json index 03938e4da..49f49dbf4 100644 --- a/integrations/openclaw/package.json +++ b/integrations/openclaw/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/openclaw-mem0", - "version": "1.1.0", + "version": "1.2.0", "type": "module", "description": "Mem0 memory backend for OpenClaw — platform or self-hosted open-source", "license": "Apache-2.0", diff --git a/integrations/opencode-plugin/package.json b/integrations/opencode-plugin/package.json index acdbaf469..efcb60a28 100644 --- a/integrations/opencode-plugin/package.json +++ b/integrations/opencode-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/opencode-plugin", - "version": "0.3.0", + "version": "0.4.0", "type": "module", "description": "Mem0 persistent memory plugin for OpenCode — add, search, and manage memories across sessions", "main": "dist/index.js", diff --git a/integrations/pi-agent-plugin/package.json b/integrations/pi-agent-plugin/package.json index d05673406..7ef9f822e 100644 --- a/integrations/pi-agent-plugin/package.json +++ b/integrations/pi-agent-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/pi-agent-plugin", - "version": "0.3.0", + "version": "0.3.1", "type": "module", "description": "Mem0 memory extension for Pi Agent persistent, scoped, semantic memory across sessions and projects", "license": "Apache-2.0", diff --git a/integrations/vercel-ai-sdk/package.json b/integrations/vercel-ai-sdk/package.json index 7b417e460..1165c3f92 100644 --- a/integrations/vercel-ai-sdk/package.json +++ b/integrations/vercel-ai-sdk/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/vercel-ai-provider", - "version": "3.0.2", + "version": "3.0.3", "description": "Vercel AI Provider for providing memory to LLMs", "main": "./dist/index.js", "module": "./dist/index.mjs", diff --git a/marketplace.json b/marketplace.json index eea48e2af..b1608c958 100644 --- a/marketplace.json +++ b/marketplace.json @@ -13,7 +13,7 @@ }, "category": "Productivity", "description": "Cross-session memory and token savings for coding agents.", - "version": "0.3.1" + "version": "0.3.2" } ] } diff --git a/mem0-ts/package.json b/mem0-ts/package.json index 7697b2384..b0490dd2e 100644 --- a/mem0-ts/package.json +++ b/mem0-ts/package.json @@ -1,6 +1,6 @@ { "name": "mem0ai", - "version": "3.1.8", + "version": "3.2.0", "description": "The Memory Layer For Your AI Apps", "main": "./dist/index.js", "module": "./dist/index.mjs", diff --git a/pyproject.toml b/pyproject.toml index 587dac221..73c5cdf71 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "hatchling.build" [project] name = "mem0ai" -version = "2.0.20" +version = "2.1.0" description = "Long-term memory for AI Agents" authors = [ { name = "Mem0", email = "support@mem0.ai" } From a39a802bbc93e85b820078cd3c4dbaf53af25dbe Mon Sep 17 00:00:00 2001 From: Himanshu <104683257+Himanshu-Sangshetti@users.noreply.github.com> Date: Fri, 18 Sep 2026 23:19:15 +0530 Subject: [PATCH 15/55] docs(cookbooks): Company Brain with Mem0 Platform + Supabase (#7309) --- docs/cookbooks/integrations/supabase.mdx | 388 +++++++++++++++++++++++ docs/docs.json | 3 +- docs/llms.txt | 1 + 3 files changed, 391 insertions(+), 1 deletion(-) create mode 100644 docs/cookbooks/integrations/supabase.mdx diff --git a/docs/cookbooks/integrations/supabase.mdx b/docs/cookbooks/integrations/supabase.mdx new file mode 100644 index 000000000..cf9b8c038 --- /dev/null +++ b/docs/cookbooks/integrations/supabase.mdx @@ -0,0 +1,388 @@ +--- +title: Build a Company Brain with Mem0 Platform and Supabase +description: "A step-by-step guide to a shared organizational memory: Mem0 Platform is the managed brain, Supabase is your system of record, and every agent taps it through the Mem0 MCP server." +--- + + +**Uses:** Mem0 **Platform** (`MemoryClient`) · **System of record:** Supabase (Postgres + Auth) · **Access layer:** the hosted Mem0 MCP server. **You'll build:** a company brain your whole org (and every agent) writes to and queries, ending with a new-hire onboarding demo. + + +Companies lose knowledge constantly: why you picked Postgres over Mongo, who owns billing, the deploy rule only one engineer remembers. A **company brain** captures this and answers questions about it, for every employee and every agent, and keeps it after people leave. + +We'll build one on **Mem0 Platform** (the managed memory layer, so there's no vector DB to run) with **Supabase as the system of record** (where your employees, teams, and source documents actually live) and the **Mem0 MCP server** as the wire that lets Claude Code, Cursor, or a Slack bot all reach the same brain. + + +**How Platform and Supabase divide the work.** Mem0 Platform manages storage and extraction server-side, you do **not** point it at your own database. Supabase is your app's source of truth and identity provider; we *ingest* knowledge from Supabase into the brain and use Supabase Auth to decide who's asking. (If you want to self-host the vector store instead, that's the OSS path, see the [Supabase vector store reference](/components/vectordbs/dbs/supabase).) + + +## Architecture + +```mermaid +flowchart LR + subgraph SB["Supabase: system of record"] + K[(knowledge / employees / teams)] + AU[Auth · who is asking] + end + subgraph M0["Mem0 Platform: the brain"] + B[(managed memory)] + end + K -->|ingest| B + AU -->|maps to scope| B + CC[Claude Code] --> MCP[Mem0 MCP server] + CU[Cursor] --> MCP + SL[Slack bot] --> MCP + MCP --> B +``` + +Memory splits by entity. An individual is a **`user_id`** (their Supabase Auth id). Shared knowledge lives on an **`agent_id`**: the company-wide brain is `org:acme`, and each team is its own agent, e.g. `team:payments`. A person's own facts route to their `user_id`; company and team facts route to the agent. This split is what lets one search return "my" context alongside the shared org knowledge. + +## Prerequisites + +- **Python 3.9+** +- A **Mem0 Platform API key**, [app.mem0.ai/dashboard/api-keys](https://app.mem0.ai/dashboard/api-keys?utm_source=oss&utm_medium=cookbook-company-brain). (Platform runs extraction and embeddings for you, so there's no OpenAI key to manage.) +- A **Supabase** project, [supabase.com](https://supabase.com) + +About 20 minutes. + +--- + +## Step 1: Get your Mem0 Platform API key + +Sign in at [app.mem0.ai](https://app.mem0.ai) and copy a key from **Dashboard → API Keys**. The key is scoped to your org and project; Mem0 resolves both server-side, so you never pass IDs by hand. + +## Step 2: Create the Supabase system of record + +In the Supabase **SQL editor**, create the tables your company already thinks in: people, teams, and a `knowledge` table the brain will ingest from. Identity reuses Supabase Auth's built-in `auth.users`. + +```sql +-- Employees extend Supabase Auth's users; identity is auth.users.id (uuid) +create table public.employees ( + id uuid primary key references auth.users (id) on delete cascade, + name text not null, + team text not null +); + +-- The company knowledge the brain ingests. `scope` decides who can recall it. +create table public.knowledge ( + id bigint generated always as identity primary key, + scope text not null, -- the shared agent this belongs to: 'org:acme' | 'team:payments' + content text not null, + author uuid references auth.users (id), -- who recorded it (their user_id); null for org seed data + created_at timestamptz default now(), + mem0_synced_at timestamptz -- null until ingested into the brain +); +create index on public.knowledge (mem0_synced_at, created_at); + +-- Seed a little company knowledge to ingest. +insert into public.knowledge (scope, content) values + ('org:acme', 'We chose Postgres over MongoDB for the core product for strong transactional guarantees and relational joins.'), + ('org:acme', 'All production deploys go out Tuesday and Thursday; never on Fridays.'), + ('org:acme', 'Customer data must stay in the EU region for GDPR compliance.'), + ('org:acme', 'Billing is owned by the Payments team, and Alice is the Payments tech lead.'), + ('team:payments', 'Stripe is our processor; webhooks are verified with PAYMENTS_WEBHOOK_SECRET.'); +``` + +Grab your project URL and **service-role** key from **Settings → API** (the ingestion job runs server-side and needs to read every scope). + +## Step 3: Project setup + +```bash +mkdir company-brain && cd company-brain +pip install "mem0ai>=2.0.17" supabase requests # 2.0.17+ for agent_custom_instructions +``` + +```bash +export MEM0_API_KEY="m0-..." +export SUPABASE_URL="https://.supabase.co" +export SUPABASE_SERVICE_KEY="" +``` + +## Step 4: Configure the brain + +Create **`brain.py`**. This constructs the Platform client and teaches it what to remember. The key is the **two** instruction sets: `custom_instructions` governs a person's own (`user_id`) memories, and `agent_custom_instructions` governs shared (`agent_id`) memories, phrased in the third person so company facts read "The company…", not "The user's organization…". `custom_categories` files each memory under a useful label. + +```python +# brain.py +import os +from mem0 import MemoryClient + +client = MemoryClient(api_key=os.environ["MEM0_API_KEY"]) + +# Steer extraction (project-wide). Runs server-side; no LLM key needed here. +client.project.update( + # Governs a person's OWN memories (user_id). + custom_instructions=( + "Extract the individual's own durable preferences, context, and how they work. " + "Ignore greetings and one-off chatter." + ), + # Governs SHARED memories (agent_id); write them in the third person. + agent_custom_instructions=( + "Extract durable company/team knowledge in the third person " + "(\"The company...\", \"The team...\"): decisions and their rationale, ownership " + "(who owns what), processes, policies, tooling choices, and gotchas. " + "Ignore greetings, scheduling, and one-off chatter." + ), + custom_categories=[ + {"decision": "Architectural or product decisions and why they were made"}, + {"ownership": "Who owns a system, service, or process"}, + {"policy": "Compliance, security, and process rules"}, + {"tooling": "Tools, services, and how they're configured"}, + ], +) + +# Scopes. A person is a user_id; shared brains are agent_ids. +COMPANY = "org:acme" # agent_id: company-wide shared brain +def team(name): return f"team:{name}" # agent_id: a team's shared brain +def person(uid): return uid # user_id: an individual (Supabase auth id) +``` + +Run it once to apply the project settings: + +```bash +python -c "import brain; print('brain configured')" +``` + + +## Step 5: Ingest company knowledge from Supabase + +This is where Supabase and the brain connect. Create **`ingest.py`**: read un-synced rows from `knowledge`, add each to the Platform brain under its scope, then mark it synced. Platform `add()` is **asynchronous**, it returns an `event_id` you can poll, so we include a small `wait_for` helper. + +```python +# ingest.py +import os, time, requests +from supabase import create_client +from brain import client, person + +sb = create_client(os.environ["SUPABASE_URL"], os.environ["SUPABASE_SERVICE_KEY"]) +MEM0_HEADERS = {"Authorization": f"Token {os.environ['MEM0_API_KEY']}"} + +def wait_for(event_id, timeout=30): + """Platform extraction is async; poll the event until it settles.""" + for _ in range(timeout): + r = requests.get(f"https://api.mem0.ai/v1/event/{event_id}/", headers=MEM0_HEADERS).json() + if r.get("status") in ("SUCCEEDED", "FAILED"): + return r["status"] + time.sleep(1) + return "TIMEOUT" + +# 1. Read knowledge that hasn't been ingested yet +rows = sb.table("knowledge").select("*").is_("mem0_synced_at", "null").execute().data + +for row in rows: + # 2. Add it. agent_id = the shared scope (org/team); user_id = who recorded it. + # Mem0 routes shared facts to the agent and personal facts to the individual, + # so pass both when there's an author. + add_kwargs = { + "agent_id": row["scope"], + "metadata": {"source": "supabase", "knowledge_id": row["id"]}, + } + if row["author"]: + add_kwargs["user_id"] = person(row["author"]) + res = client.add([{"role": "user", "content": row["content"]}], **add_kwargs) + # 3. Platform returns an event_id; wait for extraction to finish + event_id = res.get("event_id") if isinstance(res, dict) else None + if event_id: + wait_for(event_id) + # 4. Mark the row synced so we never double-ingest + sb.table("knowledge").update({"mem0_synced_at": "now()"}).eq("id", row["id"]).execute() + +print(f"Ingested {len(rows)} knowledge items into the company brain.") +``` + +```bash +python ingest.py +``` + +```text +Ingested 5 knowledge items into the company brain. +``` + +Re-running is safe, `mem0_synced_at` gates it, so a nightly cron can keep the brain in step with Supabase. + +## Step 6: Ask the brain + +Create **`ask.py`**. It searches everything relevant to the asker: their own (`user_id`) memories **plus** the shared company and team (`agent_id`) memories. This has to be an **`OR`**, each memory row belongs to exactly one entity, so a flat filter or an `AND` of a `user_id` and an `agent_id` matches nothing. + +```python +# ask.py +import sys +from brain import client, COMPANY, team, person + +def ask(question: str, uid: str | None = None, user_team: str | None = None) -> str: + scopes = [{"agent_id": COMPANY}] # company-wide brain + if user_team: + scopes.append({"agent_id": team(user_team)}) # the asker's team + if uid: + scopes.append({"user_id": person(uid)}) # the asker's own memories + hits = client.search( + query=question, + filters={"OR": scopes}, # OR, never AND (one FK per memory row) + top_k=5, + rerank=True, + ) + return "\n".join(f"- {h['memory']}" for h in hits.get("results", hits)) + +if __name__ == "__main__": + print(ask(" ".join(sys.argv[1:]) or "When can we deploy?")) +``` + +```bash +python ask.py "Why did we pick Postgres, and can I deploy on Friday?" +``` + +```text +- The company chose Postgres over MongoDB for strong transactional guarantees and relational joins +- The company's production deploys go out Tuesday and Thursday, never on Fridays +``` + +Search returns every relevant memory, so a question resolves across separate facts, here it pulls both the owning team and the person: + +```bash +python ask.py "Who should I talk to about billing?" +``` + +```text +- Billing is owned by the Payments team +- Alice is the Payments tech lead +``` + +## Step 7: Sharper retrieval + +Platform search is hybrid (semantic + keyword) and filterable. Combine a keyword pass with a category filter to answer precise questions: + +```python +client.search( + query="webhook signing secret", + filters={"agent_id": "team:payments", "categories": {"in": ["tooling"]}}, + keyword_search=True, # hybrid keyword + semantic + rerank=True, + threshold=0.3, +) +``` + +Filters use keyword operators (`in`, `gte`, `contains`, …) and AND/OR/NOT, so you can scope by date, category, or metadata, for example the company's policies added this quarter: + +```python +client.search( + query="compliance rules", + filters={"AND": [ + {"agent_id": "org:acme"}, + {"categories": {"in": ["policy"]}}, + {"created_at": {"gte": "2026-01-01"}}, + ]}, +) +``` + +## Step 8: Expose the brain to every agent (MCP) + +A brain only your script can reach isn't a company brain. Mem0's **hosted MCP server** lets any agent (Claude Code, Cursor, a Slack bot) query and contribute to the *same* brain. The endpoint is `https://mcp.mem0.ai/mcp`, and the supported way to connect is the `mcp-add` helper, which registers the server and runs Mem0's OAuth login so no key ever lands in a config file. + + + +```bash +npx mcp-add --url "https://mcp.mem0.ai/mcp" --clients "claude code,cursor" +``` +Complete the browser login on first connect. Now the agent has the brain's memory tools (`add_memory`, `search_memories`, and more) available in-editor. + + +```json +{ + "mcpServers": { + "mem0": { "url": "https://mcp.mem0.ai/mcp" } + } +} +``` +Auth happens via Mem0's OAuth flow on first use, don't paste a static token into the file (the hosted gateway may reject a raw `Token` header). + + +```python +# A Slack bot is just another MCP client. Point its MCP layer at the same URL, +# authenticate via Mem0's OAuth flow, and pass the company scope on each call. +await mcp.call_tool("search_memories", { + "query": user_message, + "agent_id": "org:acme", +}) +``` + + + +With this, an engineer asks the brain from their editor and a teammate asks it from Slack, one shared memory behind both. + +## Step 9: Onboard a new hire (the payoff) + +This is what a company brain is *for*. Dana joins, and her identity comes from **Supabase Auth**, which maps straight to her Mem0 `user_id`. She asks the questions every new hire asks and gets real answers on day one, drawn from the shared company (and her team's) brain, plus anything she's told it herself. + +```python +# onboarding.py +from brain import client, person +from ask import ask + +# In a real app these come from sb.auth.get_user(jwt) and the employees table. +dana_uid, dana_team = "8f3c...-dana", "payments" + +# Dana also tells the brain how *she* works. This is personal, so it goes to her +# user_id, not the shared agent, and stays scoped to her. +client.add( + [{"role": "user", "content": "I prefer early returns over nested ifs, and I review PRs in the morning."}], + user_id=person(dana_uid), +) + +for q in [ + "Who owns billing and who do I talk to?", # company (agent) knowledge + "When are deploys, and are there hard rules?", + "How do I like to write code?", # Dana's own (user) knowledge +]: + print(f"Q: {q}\nA: {ask(q, uid=dana_uid, user_team=dana_team)}\n") +``` + +```text +Q: Who owns billing and who do I talk to? +A: - Billing is owned by the Payments team; Alice is the Payments tech lead + +Q: When are deploys, and are there hard rules? +A: - The company's production deploys go out Tuesday and Thursday, never on Fridays + +Q: How do I like to write code? +A: - User prefers early returns over nested ifs +``` + +The same `ask()` blends the shared company facts with Dana's own preference, because the `OR` filter spans both her `user_id` and the org and team `agent_id`s. + +Dana onboarded herself by asking, drawing on the shared brain the rest of the team had been filling. + +## Production notes + + +**`user_id` vs `agent_id`.** An individual is a `user_id`; shared brains (company, team) are `agent_id`s. Keeping them separate is what gives you the third-person "The company…" framing and lets a person's own context sit alongside org knowledge. Put a secret like a webhook key on a **team** agent, never the company agent, or everyone can recall it, and mirror the boundary in Supabase with a Row Level Security policy on `knowledge`. + + + +**Search must `OR` the scopes.** A memory row belongs to exactly one entity, so `filters={"OR": [{"user_id": ...}, {"agent_id": "org:acme"}, {"agent_id": "team:..."}]}`. A flat filter, or an `AND` of a `user_id` and an `agent_id`, returns nothing. + + + +**`add()` is asynchronous.** It returns `{event_id, status: "PENDING"}` and extraction finishes a moment later, poll `GET /v1/event/{event_id}/` (as in Step 5) when you need to know a write has landed before searching for it. + + + +**Where the entity ID goes differs by call.** `search()` and `get_all()` take the scope inside `filters={...}` (a top-level `user_id=`/`agent_id=` is rejected). `add()` and `delete_all()` are the opposite, they take it as a top-level keyword: `client.delete_all(agent_id="team:payments")`. Deletes are asynchronous too, so a `get_all` right after a `delete_all` can still show rows for a few seconds. + + +## Where to take it next + +- **Auto-feed the brain** from PR descriptions, RFCs, and incident write-ups so it grows without anyone thinking about it, just insert into Supabase `knowledge` and let the cron ingest. +- **Scope by real identity** end to end: verify the Supabase JWT, read `sb.auth.get_user(jwt).user.id` for the `user_id`, look up the person's team, and `OR` their `user_id` with the company and team `agent_id`s on every recall. +- **Give teams a private view** with Supabase RLS so `team:` knowledge is only readable by that team. + +--- + + + + Connect any agent or editor to the brain over MCP. + + + Steer exactly what the brain extracts and how it's filed. + + + + diff --git a/docs/docs.json b/docs/docs.json index 4ca51fa24..7aecc007c 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -444,7 +444,8 @@ "cookbooks/integrations/mastra-agent", "cookbooks/integrations/healthcare-google-adk", "cookbooks/integrations/aws-bedrock", - "cookbooks/integrations/tavily-search" + "cookbooks/integrations/tavily-search", + "cookbooks/integrations/supabase" ] }, { diff --git a/docs/llms.txt b/docs/llms.txt index 686835a0e..ce60e29f5 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -326,6 +326,7 @@ If the user is on a pre-current major (Python < 2, TS < 3, or a Platform call st - [Healthcare Google ADK](https://docs.mem0.ai/cookbooks/integrations/healthcare-google-adk) [Platform]: Use when the domain is medical and the framework is Google ADK. - [AWS Bedrock](https://docs.mem0.ai/cookbooks/integrations/aws-bedrock) [OSS]: Use when deploying with AWS managed model services. - [Tavily Search](https://docs.mem0.ai/cookbooks/integrations/tavily-search) [Platform]: Use when the agent layers web search on memory. +- [Company Brain (Mem0 Platform + Supabase)](https://docs.mem0.ai/cookbooks/integrations/supabase) [Platform]: Use to build a shared org brain on Mem0 Platform with Supabase as system of record and the MCP server as the access layer (with a new-hire onboarding demo). ### Framework Examples - [LlamaIndex React](https://docs.mem0.ai/cookbooks/frameworks/llamaindex-react) [Both]: Use when building a React UI with LlamaIndex and memory. From 17852dc648ed332aa62360de2eba4ff84ebf6ad9 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 22 Sep 2026 18:50:39 +0530 Subject: [PATCH 16/55] SEO & metadata audit: shorten supabase cookbook description (#7380) Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs/cookbooks/integrations/supabase.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cookbooks/integrations/supabase.mdx b/docs/cookbooks/integrations/supabase.mdx index cf9b8c038..60b102324 100644 --- a/docs/cookbooks/integrations/supabase.mdx +++ b/docs/cookbooks/integrations/supabase.mdx @@ -1,6 +1,6 @@ --- title: Build a Company Brain with Mem0 Platform and Supabase -description: "A step-by-step guide to a shared organizational memory: Mem0 Platform is the managed brain, Supabase is your system of record, and every agent taps it through the Mem0 MCP server." +description: "Build a shared company brain using Mem0 Platform as the managed memory layer, Supabase as your system of record, and the Mem0 MCP server." --- From 8b38da9ab8f1e0347870abad662c8c26c07007f2 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 22 Sep 2026 18:51:03 +0530 Subject: [PATCH 17/55] Fix grammar & typos: SDK changelog v2.0.8 entry (#6716) Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs/changelog/sdk.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/changelog/sdk.mdx b/docs/changelog/sdk.mdx index 50922493e..5562fbe1d 100644 --- a/docs/changelog/sdk.mdx +++ b/docs/changelog/sdk.mdx @@ -182,7 +182,7 @@ mode: "wide" **New Features:** -- **Embeddings:** Add native `embed_batch` to five embedders: LM Studio, Together, HuggingFace, Vertex AI, and Google GenAI: for batched embedding requests ([#5609](https://github.com/mem0ai/mem0/pull/5609)) +- **Embeddings:** Add native `embed_batch` to five embedders for batched embedding requests: LM Studio, Together, HuggingFace, Vertex AI, and Google GenAI ([#5609](https://github.com/mem0ai/mem0/pull/5609)) **Bug Fixes:** - **Core:** Guard against malformed `image_url` entries in `parse_vision_messages` to prevent crashes ([#5631](https://github.com/mem0ai/mem0/pull/5631)) From a214ec37bcc6309b0332ac3e8a58b7fc717dfa19 Mon Sep 17 00:00:00 2001 From: Shahil kadia Date: Tue, 22 Sep 2026 19:01:33 +0530 Subject: [PATCH 18/55] fix(examples): migrate OSS Memory search/get_all calls to v3 filters API (#7300) Co-authored-by: Shahil Kadia --- examples/misc/movie_recommendation_grok3.py | 6 +++--- examples/misc/strands_agent_aws_elasticache_neptune.py | 6 +++--- examples/misc/vllm_example.py | 10 +++++----- 3 files changed, 11 insertions(+), 11 deletions(-) diff --git a/examples/misc/movie_recommendation_grok3.py b/examples/misc/movie_recommendation_grok3.py index bb4edbc42..abd383a47 100644 --- a/examples/misc/movie_recommendation_grok3.py +++ b/examples/misc/movie_recommendation_grok3.py @@ -45,11 +45,11 @@ grok_client = OpenAI( def recommend_movie_with_memory(user_id: str, user_query: str): # Retrieve prior memory about movies - past_memories = memory.search("movie preferences", user_id=user_id) + past_memories = memory.search("movie preferences", filters={"user_id": user_id}) prompt = user_query - if past_memories: - prompt += f"\nPreviously, the user mentioned: {past_memories}" + if past_memories["results"]: + prompt += f"\nPreviously, the user mentioned: {[m['memory'] for m in past_memories['results']]}" # Generate movie recommendation using Grok 3 response = grok_client.chat.completions.create(model="grok-3-beta", messages=[{"role": "user", "content": prompt}]) diff --git a/examples/misc/strands_agent_aws_elasticache_neptune.py b/examples/misc/strands_agent_aws_elasticache_neptune.py index 01fde8614..37f1a2fb8 100644 --- a/examples/misc/strands_agent_aws_elasticache_neptune.py +++ b/examples/misc/strands_agent_aws_elasticache_neptune.py @@ -198,7 +198,7 @@ def search_memory_tool(query: str, user_id: str = "user") -> str: Relevant vector memories found or message if none found """ try: - results = m.search(query, user_id=user_id) + results = m.search(query, filters={"user_id": user_id}) if isinstance(results, dict) and 'results' in results: memory_list = results['results'] @@ -245,7 +245,7 @@ def search_graph_memory_tool(query: str, user_id: str = "user") -> str: """ try: graph_query = f"relationships connections {query}" - results = m.search(graph_query, user_id=user_id) + results = m.search(graph_query, filters={"user_id": user_id}) if isinstance(results, dict) and 'results' in results: memory_list = results['results'] @@ -290,7 +290,7 @@ def get_all_memories_tool(user_id: str = "user") -> str: All memories for the user or message if none found """ try: - all_memories = m.get_all(user_id=user_id) + all_memories = m.get_all(filters={"user_id": user_id}) if isinstance(all_memories, dict) and 'results' in all_memories: memory_list = all_memories['results'] diff --git a/examples/misc/vllm_example.py b/examples/misc/vllm_example.py index 635cb550e..610edd2b7 100644 --- a/examples/misc/vllm_example.py +++ b/examples/misc/vllm_example.py @@ -107,16 +107,16 @@ def main(): for query in search_queries: print(f"\nQuery: {query}") - memories = memory.search(query=query, user_id="user_123") + memories = memory.search(query=query, filters={"user_id": "user_123"}) - for memory_item in memories: + for memory_item in memories["results"]: print(f" - {memory_item['memory']}") print("\n--> Getting all memories for user...") - all_memories = memory.get_all(user_id="user_123") - print(f"Total memories stored: {len(all_memories)}") + all_memories = memory.get_all(filters={"user_id": "user_123"}) + print(f"Total memories stored: {len(all_memories['results'])}") - for memory_item in all_memories: + for memory_item in all_memories["results"]: print(f" - {memory_item['memory']}") print("\n--> vLLM integration demo completed successfully!") From fd8fd087ea551648897717ce7bca86acfee5b268 Mon Sep 17 00:00:00 2001 From: 88lin <431761794@qq.com> Date: Tue, 22 Sep 2026 21:55:51 +0800 Subject: [PATCH 19/55] docs(vectordbs/pinecone): document extra_params on the Python config table (#7222) --- docs/components/vectordbs/dbs/pinecone.mdx | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/components/vectordbs/dbs/pinecone.mdx b/docs/components/vectordbs/dbs/pinecone.mdx index 31662ed29..1cd06b592 100644 --- a/docs/components/vectordbs/dbs/pinecone.mdx +++ b/docs/components/vectordbs/dbs/pinecone.mdx @@ -94,6 +94,7 @@ Here are the parameters available for configuring Pinecone: | `hybrid_search` | Whether to enable hybrid search | `False` | | `metric` | Distance metric for vector similarity | `"cosine"` | | `batch_size` | Batch size for operations | `100` | +| `extra_params` | Additional keyword arguments passed to the `Pinecone` client constructor. Ignored when `client` is supplied. | `None` | | `namespace` | Namespace for the collection, useful for multi-tenancy. | `None` | From 5d38e3703ab58df2922fe900b772412e9ae1bcab Mon Sep 17 00:00:00 2001 From: Deshraj Yadav Date: Tue, 22 Sep 2026 07:22:54 -0700 Subject: [PATCH 20/55] chore: remove CLI_SPECIFICATION.md (#4578) Co-authored-by: Claude Opus 4.6 (1M context) Co-authored-by: kartik-mem0 --- cli/CLI_SPECIFICATION.md | 1613 -------------------------------------- 1 file changed, 1613 deletions(-) delete mode 100644 cli/CLI_SPECIFICATION.md diff --git a/cli/CLI_SPECIFICATION.md b/cli/CLI_SPECIFICATION.md deleted file mode 100644 index a243e833c..000000000 --- a/cli/CLI_SPECIFICATION.md +++ /dev/null @@ -1,1613 +0,0 @@ -# mem0 CLI SDK Specification - -Complete reference for the mem0 CLI. This document is the authoritative guide for any developer or AI agent working on this SDK. - ---- - -## Table of Contents - -1. [Project Overview](#1-project-overview) -2. [Architecture](#2-architecture) -3. [Complete Command Reference](#3-complete-command-reference) -4. [API Endpoints](#4-api-endpoints) -5. [Configuration](#5-configuration) -6. [Key Behavioral Patterns](#6-key-behavioral-patterns) -7. [Output Modes](#7-output-modes) -8. [Agent-Friendly Design Decisions](#8-agent-friendly-design-decisions) -9. [Adding a New Command](#9-adding-a-new-command) -10. [Adding a New Language Implementation](#10-adding-a-new-language-implementation) - ---- - -## 1. Project Overview - -### What is mem0 CLI? - -mem0 CLI is the official command-line interface for [mem0](https://mem0.ai) -- the memory layer for AI agents. It lets developers and AI agents add, search, list, update, and delete memories via the mem0 Platform API from the terminal. - -### Who is it for? - -- Developers integrating mem0 into their workflows -- AI agents that need persistent memory (the CLI is designed with `--json`/`--agent` global flags and `help --json` specifically for machine consumption) -- DevOps/CI pipelines that need to manage memories programmatically - -### Project Structure - -The `cli/` directory provides the mem0 CLI in two languages with a shared specification for behavioral consistency. - -| Language | Directory | Package Name | Install Command | -|------------|------------|---------------|----------------------------| -| TypeScript | `node/` | `@mem0/cli` | `npm install -g @mem0/cli` | -| Python | `python/` | `mem0-cli` | `pip install mem0-cli` | - -Both implementations produce a binary named `mem0` and provide **identical CLI behavior** -- same commands, same options, same output formats, same error messages. - -### Version - -Current version: `0.1.0` (defined in `cli-spec.json`, `node/package.json`, and `python/pyproject.toml`). - -### License - -Apache-2.0 - ---- - -## 2. Architecture - -### Directory Layout - -``` -. -├── cli-spec.json # Shared CLI specification (source of truth) -├── README.md # CLI README -├── SDK_SPECIFICATION.md # This file -├── python/ -│ ├── pyproject.toml # Python package config (hatchling build) -│ ├── README.md -│ └── src/mem0_cli/ -│ ├── __init__.py # __version__ -│ ├── app.py # Main Typer app, command registration, helpers -│ ├── config.py # Config loading/saving, env var overrides -│ ├── branding.py # Colors, icons, banner, timed_status, print helpers -│ ├── output.py # Output formatting (text, json, table, quiet) -│ ├── backend/ -│ │ ├── __init__.py # Re-exports get_backend -│ │ ├── base.py # Abstract Backend ABC, get_backend factory -│ │ └── platform.py # PlatformBackend (httpx), error classes -│ └── commands/ -│ ├── memory.py # cmd_add, cmd_search, cmd_get, cmd_list, cmd_update, cmd_delete, cmd_delete_all -│ ├── init_cmd.py # run_init (interactive wizard) -│ ├── config_cmd.py # cmd_config_show, cmd_config_get, cmd_config_set -│ ├── entities.py # cmd_entities_list, cmd_entities_delete -│ ├── events_cmd.py # cmd_event_list, cmd_event_status -│ └── utils.py # cmd_status, cmd_version, cmd_import -└── node/ - ├── package.json # Node package config (tsup build) - ├── README.md - └── src/ - ├── index.ts # Main Commander.js app, command registration, helpers - ├── config.ts # Config loading/saving, env var overrides - ├── branding.ts # Colors, icons, banner, timedStatus, print helpers - ├── output.ts # Output formatting (text, json, table, quiet) - ├── state.ts # Agent mode flag (setAgentMode, isAgentMode) - ├── help.ts # Rich-style help formatter (panels, command ordering) - ├── backend/ - │ ├── index.ts # Re-exports - │ ├── base.ts # Backend interface, error classes, getBackend factory - │ └── platform.ts # PlatformBackend (native fetch), _buildFilters - └── commands/ - ├── memory.ts # cmdAdd, cmdSearch, cmdGet, cmdList, cmdUpdate, cmdDelete, cmdDeleteAll - ├── init.ts # runInit (interactive wizard) - ├── config.ts # cmdConfigShow, cmdConfigGet, cmdConfigSet - ├── entities.ts # cmdEntitiesList, cmdEntitiesDelete - ├── events.ts # cmdEventList, cmdEventStatus - └── utils.ts # cmdStatus, cmdVersion, cmdImport -``` - -### How Both CLIs Mirror Each Other - -Every command, option, argument, and behavioral pattern is implemented identically in both CLIs. The shared `cli-spec.json` is the source of truth for: - -- All command names, descriptions, and usage strings -- All arguments and options (names, types, defaults, help text, panel grouping) -- API endpoint paths and methods -- Branding constants (colors, icons, logo) -- Config schema (sections, fields, env var mappings) -- Error messages and templates -- Option grouping (Scope, Search, Pagination, Filters, Output, Connection) - -### Tech Stacks - -| Concern | Python | Node | -|------------------|-------------------------------------|-----------------------------------------| -| CLI framework | Typer >= 0.9.0 | Commander.js ^12.0.0 | -| Rich output | Rich >= 13.0.0 | chalk ^5.3.0 + cli-table3 ^0.6.4 | -| Spinners | Rich Status | ora ^8.0.0 | -| Boxed panels | Rich Panel | boxen ^7.1.0 | -| HTTP client | httpx >= 0.24.0 | Native fetch (Node >= 18) | -| Build system | Hatchling | tsup ^8.0.0 | -| Test framework | pytest >= 7.0 | vitest ^1.5.0 | -| Linter | ruff >= 0.1.0 | Biome ^1.7.0 | -| Type checking | (ruff type checks) | TypeScript ^5.4.0 | -| Min runtime | Python >= 3.10 | Node >= 18.0.0 | -| Module format | Standard Python package | ESM (`"type": "module"`) | -| Entrypoint | `mem0 = "mem0_cli.app:main"` | `"bin": { "mem0": "./dist/index.js" }` | - ---- - -## 3. Complete Command Reference - -### 3.1 `init` - -Interactive setup wizard for mem0 CLI. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 init [OPTIONS]` | -| needsBackend | No | -| needsConfig | No | -| resolveIds | No | -| resolveGraph | No | -| confirmDangerous | No | - -**Options:** - -| Flag | Type | Required | Default | Help | -|-----------------|--------|----------|---------|------| -| `--api-key` | string | No | - | API key (skip prompt). | -| `-u, --user-id` | string | No | - | Default user ID (skip prompt). | -| `--email` | string | No | - | Login via email verification code. | -| `--code` | string | No | - | Verification code (use with --email for non-interactive login). | -| `--force` | bool | No | false | Overwrite existing config without confirmation. | - -**Behavior:** - -*Existing config protection:* -- If `~/.mem0/config.json` exists with an API key, the CLI warns and asks for confirmation before overwriting. -- In non-TTY mode, this is a hard error unless `--force` is passed. -- `--force` skips the confirmation in both TTY and non-TTY modes. - -*Email login flow (when `--email` is provided):* -- Sends a 6-digit verification code to the email via `POST /api/v1/auth/email_code/`. -- If `--code` is also provided, verifies immediately (fully non-interactive). -- If `--code` is not provided, prompts for the code interactively. -- On success: receives API key, org_id, project_id. Saves to config. Creates account if email is new. -- Cannot be combined with `--api-key`. - -*API key flow (existing behavior):* -- If both `--api-key` and `--user-id` are provided, runs non-interactively (no prompts). -- If running in a non-TTY without both flags, prints an error with usage hint and exits. -- Interactive mode: prints banner, prompts for API key (masked with `*`), prompts for default user ID (default: `mem0-cli`), validates connection, saves config. -- API key input uses raw terminal mode to echo `*` for each character typed. Supports backspace and Ctrl+U (clear line). - -**Examples:** -```bash -mem0 init -mem0 init --api-key m0-xxx --user-id alice -mem0 init --api-key m0-xxx --user-id alice --force -mem0 init --email alice@company.com -mem0 init --email alice@company.com --code 482901 -``` - ---- - -### 3.2 `add` - -Add a memory from text, messages, file, or stdin. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 add [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | Yes | -| resolveIds | Yes | -| resolveGraph | Yes | -| confirmDangerous | No | -| Output formats | text, json, quiet | -| Default output | text | -| API endpoint | `POST /v1/memories/` | - -**Arguments:** - -| Name | Type | Required | Help | -|--------|--------|----------|------| -| `text` | string | No | Text content to add as a memory. | - -**Options:** - -| Flag | Type | Default | Panel | Help | -|------------------|---------|---------|------------|------| -| `-u, --user-id` | string | - | Scope | Scope to user. | -| `--agent-id` | string | - | Scope | Scope to agent. | -| `--app-id` | string | - | Scope | Scope to app. | -| `--run-id` | string | - | Scope | Scope to run. | -| `--messages` | string | - | - | Conversation messages as JSON. | -| `-f, --file` | path | - | - | Read messages from JSON file. | -| `-m, --metadata` | string | - | - | Custom metadata as JSON. | -| `--immutable` | boolean | false | - | Prevent future updates. | -| `--no-infer` | boolean | false | - | Skip inference, store raw. | -| `--expires` | string | - | - | Expiration date (YYYY-MM-DD). | -| `--categories` | string | - | - | Categories (JSON array or comma-separated). | -| `--graph` | boolean | false | Scope | Enable graph memory extraction. | -| `--no-graph` | boolean | false | Scope | Disable graph memory extraction. | -| `-o, --output` | string | "text" | Output | Output format: text, json, quiet. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Input priority:** `--file` > `--messages` > text argument > stdin (if piped and no text). - -**Content wrapping:** Text content is wrapped as `[{"role": "user", "content": ""}]` before sending to the API. Messages from `--messages` or `--file` are sent as-is. - -**Examples:** -```bash -mem0 add "I prefer dark mode" --user-id alice -echo "text" | mem0 add -u alice -mem0 add --file msgs.json -u alice -o json -``` - ---- - -### 3.3 `search` - -Search memories by semantic query. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 search [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | Yes | -| resolveIds | Yes | -| resolveGraph | Yes | -| confirmDangerous | No | -| Output formats | text, json, table | -| Default output | text | -| API endpoint | `POST /v2/memories/search/` | - -**Arguments:** - -| Name | Type | Required | Help | -|---------|--------|----------|------| -| `query` | string | Yes | Search query. | - -**Options:** - -| Flag | Type | Default | Panel | Help | -|-------------------------|---------|---------|------------|------| -| `-u, --user-id` | string | - | Scope | Filter by user. | -| `--agent-id` | string | - | Scope | Filter by agent. | -| `--app-id` | string | - | Scope | Filter by app. | -| `--run-id` | string | - | Scope | Filter by run. | -| `-k, --top-k, --limit` | integer | 10 | Search | Number of results. | -| `--threshold` | float | 0.3 | Search | Minimum similarity score. | -| `--rerank` | boolean | false | Search | Enable reranking (Platform only). | -| `--keyword` | boolean | false | Search | Use keyword search. | -| `--filter` | string | - | Search | Advanced filter expression (JSON). | -| `--fields` | string | - | Search | Specific fields to return (comma-separated). | -| `--graph` | boolean | false | Search | Enable graph in search. | -| `--no-graph` | boolean | false | Search | Disable graph in search. | -| `-o, --output` | string | "text" | Output | Output: text, json, table. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Stdin fallback:** If no query argument is provided and stdin is piped, reads query from stdin. - -**Examples:** -```bash -mem0 search "preferences" --user-id alice -mem0 search "tools" -u alice -o json -k 5 -echo "preferences" | mem0 search -u alice -``` - ---- - -### 3.4 `get` - -Get a specific memory by ID. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 get [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | No | -| resolveIds | No | -| resolveGraph | No | -| confirmDangerous | No | -| Output formats | text, json | -| Default output | text | -| API endpoint | `GET /v1/memories/{memory_id}/` | - -**Arguments:** - -| Name | Type | Required | Help | -|-------------|--------|----------|------| -| `memory_id` | string | Yes | Memory ID to retrieve. | - -**Options:** - -| Flag | Type | Default | Panel | Help | -|----------------|--------|---------|------------|------| -| `-o, --output` | string | "text" | Output | Output: text, json. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Examples:** -```bash -mem0 get abc-123-def-456 -mem0 get abc-123-def-456 -o json -``` - ---- - -### 3.5 `list` - -List memories with optional filters. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 list [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | Yes | -| resolveIds | Yes | -| resolveGraph | Yes | -| confirmDangerous | No | -| Output formats | text, json, table | -| Default output | table | -| API endpoint | `POST /v2/memories/` | - -**Arguments:** None. - -**Options:** - -| Flag | Type | Default | Panel | Help | -|------------------|---------|---------|------------|------| -| `-u, --user-id` | string | - | Scope | Filter by user. | -| `--agent-id` | string | - | Scope | Filter by agent. | -| `--app-id` | string | - | Scope | Filter by app. | -| `--run-id` | string | - | Scope | Filter by run. | -| `--page` | integer | 1 | Pagination | Page number. | -| `--page-size` | integer | 100 | Pagination | Results per page. | -| `--category` | string | - | Filters | Filter by category. | -| `--after` | string | - | Filters | Created after (YYYY-MM-DD). | -| `--before` | string | - | Filters | Created before (YYYY-MM-DD). | -| `--graph` | boolean | false | Filters | Enable graph in listing. | -| `--no-graph` | boolean | false | Filters | Disable graph in listing. | -| `-o, --output` | string | "table" | Output | Output: text, json, table. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Examples:** -```bash -mem0 list -u alice -mem0 list --category prefs --after 2024-01-01 -o json -``` - ---- - -### 3.6 `update` - -Update a memory's text or metadata. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 update [text] [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | No | -| resolveIds | No | -| resolveGraph | No | -| confirmDangerous | No | -| Output formats | text, json, quiet | -| Default output | text | -| API endpoint | `PUT /v1/memories/{memory_id}/` | - -**Arguments:** - -| Name | Type | Required | Help | -|-------------|--------|----------|------| -| `memory_id` | string | Yes | Memory ID to update. | -| `text` | string | No | New memory text. | - -**Options:** - -| Flag | Type | Default | Panel | Help | -|------------------|--------|---------|------------|------| -| `-m, --metadata` | string | - | - | Update metadata (JSON). | -| `-o, --output` | string | "text" | Output | Output: text, json, quiet. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Stdin fallback:** If no text argument is provided and no `--metadata` flag is set and stdin is piped, reads text from stdin. - -**Examples:** -```bash -mem0 update abc-123 "new text" -mem0 update abc-123 --metadata '{"key":"val"}' -echo "new text" | mem0 update abc-123 -``` - ---- - -### 3.7 `delete` - -Delete a memory, all memories matching a scope, or an entity. This is a consolidated command with three mutually exclusive modes. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 delete [memory_id] [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | Yes | -| resolveIds | Yes | -| resolveGraph | No | -| confirmDangerous | Yes | -| Output formats | text, json, quiet | -| Default output | text | -| API endpoint | `DELETE /v1/memories/{memory_id}/` (single), `DELETE /v1/memories/` (--all), `DELETE /v1/entities/` (--entity) | - -**Arguments:** - -| Name | Type | Required | Help | -|-------------|--------|----------|------| -| `memory_id` | string | No | Memory ID to delete (omit when using --all or --entity). | - -**Options:** - -| Flag | Type | Default | Panel | Help | -|-----------------|---------|---------|------------|------| -| `--all` | boolean | false | - | Delete all memories matching scope filters. | -| `--entity` | boolean | false | - | Delete the entity itself and all its memories (cascade). | -| `--project` | boolean | false | - | With --all: delete ALL memories project-wide. | -| `--dry-run` | boolean | false | - | Show what would be deleted without deleting. | -| `--force` | boolean | false | - | Skip confirmation. | -| `-u, --user-id` | string | - | Scope | Scope to user. | -| `--agent-id` | string | - | Scope | Scope to agent. | -| `--app-id` | string | - | Scope | Scope to app. | -| `--run-id` | string | - | Scope | Scope to run. | -| `-o, --output` | string | "text" | Output | Output: text, json, quiet. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Three modes (mutually exclusive):** - -1. **Single memory:** `mem0 delete ` -- deletes one memory by ID. Cannot combine with `--all` or `--entity`. -2. **Bulk delete:** `mem0 delete --all [scope]` -- deletes all memories matching scope filters. Use `--project` with `--all` to wipe all memories project-wide (sends wildcard `*` entity IDs). Cannot combine with `` or `--entity`. -3. **Entity cascade:** `mem0 delete --entity [scope]` -- deletes the entity itself and all its memories. Cannot combine with `` or `--all`. - -If none of ``, `--all`, or `--entity` is provided, the command prints a usage hint and exits with an error. - -**Dry-run behavior:** -- Single: fetches the memory via `GET`, displays it, then prints "No changes made." -- `--all`: lists matching memories and displays the count, then prints "No changes made." -- `--entity`: shows the scope that would be affected without deleting. - -**Confirmation:** Without `--force`, prompts the user with "[y/N]" confirmation. With `--all --project`, the prompt warns about entire project wipe. - -**`--all --project` wildcard behavior:** Sends `DELETE /v1/memories/` with query params `user_id=*&agent_id=*&app_id=*&run_id=*`. The API typically returns an async response with a `message` field (deletion happens in background). The CLI detects this and prints "Deletion started. Memories will be removed in the background." - -**Examples:** -```bash -mem0 delete abc-123-def-456 # single memory -mem0 delete --all -u alice --force # all memories for user -mem0 delete --all --project --force # project-wide wipe -mem0 delete --entity -u alice --force # entity + all its memories -mem0 delete abc-123 --dry-run # preview single delete -``` - ---- - -### 3.8 `import` - -Import memories from a JSON file. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 import [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | Yes | -| resolveIds | Yes | -| resolveGraph | No | -| confirmDangerous | No | -| Output formats | text, json | -| Default output | text | -| API endpoint | `POST /v1/memories/` (per item) | - -**Arguments:** - -| Name | Type | Required | Help | -|-------------|--------|----------|------| -| `file_path` | string | Yes | JSON file to import. | - -**Options:** - -| Flag | Type | Default | Panel | Help | -|-----------------|--------|---------|------------|------| -| `-u, --user-id` | string | - | Scope | Override user ID. | -| `--agent-id` | string | - | Scope | Override agent ID. | -| `-o, --output` | string | "text" | Output | Output: text, json. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**File format:** JSON array (or single object) where each item has `memory`, `text`, or `content` field for the text, plus optional `user_id`, `agent_id`, and `metadata` fields. - -**Behavior:** Iterates through items, calling `backend.add()` for each. CLI-provided `--user-id` and `--agent-id` override per-item values. Displays progress indicator (every 10 items in Node, Rich progress bar in Python). Reports `added` and `failed` counts. - -**JSON output envelope:** -```json -{ - "status": "success", - "command": "import", - "data": { "added": 42, "failed": 0, "duration_s": 3.14 }, - "duration_ms": 3140 -} -``` - -**Examples:** -```bash -mem0 import data.json --user-id alice -mem0 import data.json -u alice -o json -``` - ---- - -### 3.9 `config show` - -Display current configuration (secrets redacted). - -| Property | Value | -|------------------|-------| -| Usage | `mem0 config show [OPTIONS]` | -| needsBackend | No | -| needsConfig | No | - -**Options:** - -| Flag | Type | Default | Help | -|----------------|--------|---------|------| -| `-o, --output` | string | "text" | Output: text, json. | - -**Behavior:** Loads config (file + env vars), displays as table (text) or JSON envelope. API keys are always redacted using `redact_key()`. - -**Examples:** -```bash -mem0 config show -mem0 config show -o json -``` - ---- - -### 3.10 `config get` - -Get a configuration value. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 config get ` | -| needsBackend | No | -| needsConfig | No | - -**Arguments:** - -| Name | Type | Required | Help | -|-------|--------|----------|------| -| `key` | string | Yes | Config key (e.g. `platform.api_key`). | - -**Valid keys:** `platform.api_key`, `platform.base_url`, `defaults.user_id`, `defaults.agent_id`, `defaults.app_id`, `defaults.run_id`, `defaults.enable_graph`. - -**Behavior:** Prints the value to stdout. API keys are redacted. Unknown keys print an error. - -**Examples:** -```bash -mem0 config get platform.api_key -mem0 config get defaults.user_id -``` - ---- - -### 3.11 `config set` - -Set a configuration value. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 config set ` | -| needsBackend | No | -| needsConfig | No | - -**Arguments:** - -| Name | Type | Required | Help | -|---------|--------|----------|------| -| `key` | string | Yes | Config key (e.g. `platform.api_key`). | -| `value` | string | Yes | Value to set. | - -**Type coercion:** Boolean fields accept `true/1/yes` (case-insensitive) as true, anything else as false. Integer fields are parsed via `parseInt`. String fields are stored as-is. - -**Examples:** -```bash -mem0 config set defaults.user_id alice -mem0 config set platform.base_url https://api.mem0.ai -``` - ---- - -### 3.12 `entity list` - -List all entities of a given type. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 entity list ` | -| needsBackend | Yes | -| needsConfig | No | -| resolveIds | No | -| resolveGraph | No | -| confirmDangerous | No | -| Output formats | table, json | -| Default output | table | -| API endpoint | `GET /v1/entities/` | - -**Arguments:** - -| Name | Type | Required | Choices | Help | -|---------------|--------|----------|--------------------------------|------| -| `entity_type` | string | Yes | `users`, `agents`, `apps`, `runs` | Entity type to list. | - -**Behavior:** Calls `GET /v1/entities/` which returns ALL entity types, then filters client-side using the type map: `users` -> `user`, `agents` -> `agent`, `apps` -> `app`, `runs` -> `run`. Displays a table with "Name / ID" and "Created" columns. - -**Options:** - -| Flag | Type | Default | Panel | Help | -|----------------|--------|---------|------------|------| -| `-o, --output` | string | "table" | Output | Output: table, json. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Examples:** -```bash -mem0 entity list users -mem0 entity list agents -o json -``` - ---- - -### 3.13 `entity delete` - -Delete an entity and ALL its memories (cascade). Also accessible via `mem0 delete --entity`. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 entity delete [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | No | -| resolveIds | No | -| resolveGraph | No | -| confirmDangerous | Yes | -| Output formats | text, json, quiet | -| Default output | text | -| API endpoint | `DELETE /v1/entities/` | - -**Arguments:** None. - -**Options:** - -| Flag | Type | Default | Panel | Help | -|-----------------|---------|---------|------------|------| -| `-u, --user-id` | string | - | Scope | User ID. | -| `--agent-id` | string | - | Scope | Agent ID. | -| `--app-id` | string | - | Scope | App ID. | -| `--run-id` | string | - | Scope | Run ID. | -| `--dry-run` | boolean | false | - | Show what would be deleted without deleting. | -| `--force` | boolean | false | - | Skip confirmation. | -| `-o, --output` | string | "text" | Output | Output: text, json, quiet. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Validation:** At least one entity ID is required. Errors if none provided. - -**Examples:** -```bash -mem0 entity delete --user-id alice --force -mem0 entity delete --user-id alice --dry-run -``` - ---- - -### 3.14 `event list` - -List recent background processing events. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 event list [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | Yes | -| resolveIds | No | -| resolveGraph | No | -| confirmDangerous | No | -| Output formats | text (table), json | -| Default output | table | -| API endpoint | `GET /v1/events/` | - -**Options:** - -| Flag | Type | Default | Panel | Help | -|----------------|--------|---------|------------|------| -| `-o, --output` | string | "table" | Output | Output: text, json. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Behavior:** Fetches all background events for the project. Displays as a table with columns: Event ID (first 8 chars), Type, Status (color-coded), Latency, Created. Status values: `PENDING` (accent), `SUCCEEDED` (green), `FAILED` (red), `PROCESSING` (yellow). - -**JSON output envelope:** -```json -{ - "status": "success", - "command": "event list", - "count": 3, - "duration_ms": 87, - "data": [ - { "id": "evt-abc", "event_type": "ADD", "status": "SUCCEEDED", "latency": 412.0, "created_at": "2026-01-01T10:00:00Z" } - ] -} -``` - -**Examples:** -```bash -mem0 event list -mem0 event list --output json -``` - ---- - -### 3.15 `event status` - -Get the status and results of a specific background event. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 event status [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | Yes | -| resolveIds | No | -| resolveGraph | No | -| confirmDangerous | No | -| Output formats | text, json | -| Default output | text | -| API endpoint | `GET /v1/events/{event_id}/` | - -**Arguments:** - -| Name | Type | Required | Help | -|------------|--------|----------|------| -| `event_id` | string | Yes | Event ID to inspect. | - -**Options:** - -| Flag | Type | Default | Panel | Help | -|----------------|--------|---------|------------|------| -| `-o, --output` | string | "text" | Output | Output: text, json. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Behavior:** Fetches the event by ID and displays: Event ID, Type, Status (color-coded), Latency, Created, Updated, and a numbered list of result memories (event type, memory text, user_id, truncated memory ID). Displayed in a boxed panel (text) or JSON envelope. - -**JSON output envelope:** -```json -{ - "status": "success", - "command": "event status", - "duration_ms": 65, - "data": { - "id": "evt-abc", - "event_type": "ADD", - "status": "SUCCEEDED", - "latency": 412.0, - "created_at": "2026-01-01T10:00:00Z", - "updated_at": "2026-01-01T10:00:01Z", - "results": [ - { "id": "mem-xyz", "event": "ADD", "user_id": "alice", "memory": "User prefers dark mode" } - ] - } -} -``` - -**Examples:** -```bash -mem0 event status evt-abc-123 -mem0 event status evt-abc-123 --output json -``` - ---- - -### 3.16 `status` - -Check connectivity and authentication. - -| Property | Value | -|------------------|-------| -| Usage | `mem0 status [OPTIONS]` | -| needsBackend | Yes | -| needsConfig | Yes | -| resolveIds | No | -| resolveGraph | No | -| confirmDangerous | No | - -**Options:** - -| Flag | Type | Default | Panel | Help | -|----------------|--------|---------|------------|------| -| `-o, --output` | string | "text" | Output | Output: text, json. | -| `--api-key` | string | - | Connection | Override API key. | -| `--base-url` | string | - | Connection | Override API base URL. | - -**Behavior:** Validates connectivity by calling `GET /v1/ping/`. Displays connection status in a boxed panel (text) or JSON envelope. The ping endpoint is lightweight and does not require any entity scope. - -**JSON output:** -```json -{ - "status": "success", - "command": "status", - "duration_ms": 112, - "data": { - "connected": true, - "backend": "platform", - "base_url": "https://api.mem0.ai" - } -} -``` - -**Examples:** -```bash -mem0 status -mem0 status -o json -``` - ---- - -### 3.17 `help` - -Show help. Use `--json` for machine-readable output (for LLM agents). - -| Property | Value | -|------------------|-------| -| Usage | `mem0 help [OPTIONS]` | -| needsBackend | No | -| needsConfig | No | - -**Options:** - -| Flag | Type | Default | Help | -|----------|---------|---------|------| -| `--json` | boolean | false | Output machine-readable JSON for LLM agents. | - -**Behavior:** -- Without `--json`: prints a human-readable summary of all commands. -- With `--json`: Node outputs the entire `cli-spec.json` file. Python outputs a hand-built JSON object describing all commands, arguments, options, and global options. - -**Examples:** -```bash -mem0 help -mem0 help --json -``` - ---- - -## 4. API Endpoints - -### Base URL - -Default: `https://api.mem0.ai` (configurable via `--base-url`, `MEM0_BASE_URL`, or `platform.base_url` in config). - -### Authentication - -All requests include the header: -``` -Authorization: Token -``` - -The auth header name is `Authorization` and the scheme is `Token` (not Bearer). - -### Timeout - -30 seconds for all requests (Python: `httpx.Client(timeout=30.0)`, Node: `AbortSignal.timeout(30_000)`). - -### Endpoint Reference - -| Operation | Method | Path | Request Body | Query Params | -|-----------------|----------|-------------------------------|------------------|-------------------------| -| Add memory | `POST` | `/v1/memories/` | JSON payload | - | -| Search | `POST` | `/v2/memories/search/` | JSON payload | - | -| Get memory | `GET` | `/v1/memories/{memory_id}/` | - | - | -| List memories | `POST` | `/v2/memories/` | JSON payload | `page`, `page_size` | -| Update memory | `PUT` | `/v1/memories/{memory_id}/` | JSON payload | - | -| Delete memory | `DELETE` | `/v1/memories/{memory_id}/` | - | - | -| Delete all | `DELETE` | `/v1/memories/` | - | entity ID params | -| List entities | `GET` | `/v1/entities/` | - | - | -| Delete entities | `DELETE` | `/v1/entities/` | - | entity ID params | -| List events | `GET` | `/v1/events/` | - | - | -| Get event | `GET` | `/v1/events/{event_id}/` | - | - | -| Ping (status) | `GET` | `/v1/ping/` | - | - | - -### How Filters Are Built (`_buildFilters` / `_build_filters`) - -Both CLIs use an identical filter-building algorithm: - -1. If the caller passed a pre-built filter structure containing `AND` or `OR` keys (e.g. from `--filter`), use it directly. -2. Otherwise, build an array of AND conditions: - - Each entity ID becomes `{"user_id": "..."}`, `{"agent_id": "..."}`, etc. - - Extra filters (category, date ranges) are appended as additional conditions. -3. If exactly 1 condition: return it directly (no wrapping). -4. If 2+ conditions: return `{"AND": [condition1, condition2, ...]}`. -5. If 0 conditions: return `undefined`/`None`. - -**Category filter format:** `{"categories": {"contains": ""}}` - -**Date filter format:** `{"created_at": {"gte": "YYYY-MM-DD"}}` and/or `{"created_at": {"lte": "YYYY-MM-DD"}}`. If both `after` and `before` are set, they merge into one `created_at` object: `{"created_at": {"gte": "...", "lte": "..."}}`. - -### How Pagination Works - -For the `list` command (and `search` internally): -- `page` and `page_size` are sent as **query parameters** (not in the POST body). -- Filters and `enable_graph` are sent in the **POST body**. -- Default: `page=1`, `page_size=100`. - -### Response Normalization - -Both CLIs handle inconsistent API response formats: -``` -# For search and list, the API may return: -result = [...] # Direct array -result = {"results": [...]} # Wrapped in results key -result = {"memories": [...]} # Wrapped in memories key - -# Normalization logic (identical in both CLIs): -if isinstance(result, list): - return result -else: - return result.get("results", result.get("memories", [])) -``` - -### Error Handling - -HTTP errors are mapped to typed exceptions: - -| HTTP Status | Error Class | Message Template | -|-------------|----------------|-----------------| -| 401 | `AuthError` | "Authentication failed. Your API key may be invalid or expired." | -| 404 | `NotFoundError`| "Resource not found: {path}" | -| 400 | `APIError` | "Bad request to {path}: {detail}" (detail extracted from response JSON `.detail` field) | -| 204 | (success) | Returns `{}` (empty object) | -| Other | Generic Error | "HTTP {status}: {statusText}" | - ---- - -## 5. Configuration - -### Config File Location - -- Directory: `~/.mem0/` (created with permissions `0700`) -- File: `~/.mem0/config.json` (written with permissions `0600`) - -### Config Precedence (highest to lowest) - -1. **CLI flags** (`--api-key`, `--base-url`, `--user-id`, etc.) -2. **Environment variables** (`MEM0_API_KEY`, etc.) -3. **Config file** (`~/.mem0/config.json`) -4. **Defaults** (hardcoded) - -### Environment Variables - -| Variable | Config Path | Type | Default | -|--------------------|--------------------------|---------|-----------------------| -| `MEM0_API_KEY` | `platform.api_key` | string | `""` | -| `MEM0_BASE_URL` | `platform.base_url` | string | `"https://api.mem0.ai"` | -| `MEM0_USER_ID` | `defaults.user_id` | string | `""` | -| `MEM0_AGENT_ID` | `defaults.agent_id` | string | `""` | -| `MEM0_APP_ID` | `defaults.app_id` | string | `""` | -| `MEM0_RUN_ID` | `defaults.run_id` | string | `""` | -| `MEM0_ENABLE_GRAPH`| `defaults.enable_graph` | boolean | `false` | - -**Boolean parsing for `MEM0_ENABLE_GRAPH`:** Accepted truthy values are `"true"`, `"1"`, `"yes"` (case-insensitive). Everything else is `false`. - -### Config File JSON Schema - -```json -{ - "version": 1, - "defaults": { - "user_id": "", - "agent_id": "", - "app_id": "", - "run_id": "", - "enable_graph": false - }, - "platform": { - "api_key": "", - "base_url": "https://api.mem0.ai" - } -} -``` - -| Field | Type | Default | Description | -|--------------------------|---------|--------------------------|-------------| -| `version` | integer | `1` | Config schema version. | -| `defaults.user_id` | string | `""` | Default user ID for scoping. | -| `defaults.agent_id` | string | `""` | Default agent ID for scoping. | -| `defaults.app_id` | string | `""` | Default app ID for scoping. | -| `defaults.run_id` | string | `""` | Default run ID for scoping. | -| `defaults.enable_graph` | boolean | `false` | Default graph memory extraction. | -| `platform.api_key` | string | `""` | API key for mem0 Platform. | -| `platform.base_url` | string | `"https://api.mem0.ai"` | Base URL for API requests. | - -### Config Key Map (for `config get`/`config set`) - -The dotted key paths map to internal config objects as follows: - -| Dotted Key | Section | Field | -|-------------------------|------------|--------------| -| `platform.api_key` | platform | apiKey / api_key | -| `platform.base_url` | platform | baseUrl / base_url | -| `defaults.user_id` | defaults | userId / user_id | -| `defaults.agent_id` | defaults | agentId / agent_id | -| `defaults.app_id` | defaults | appId / app_id | -| `defaults.run_id` | defaults | runId / run_id | -| `defaults.enable_graph` | defaults | enableGraph / enable_graph | - -### API Key Redaction - -The `redact_key`/`redactKey` function: -- Empty string: returns `"(not set)"` -- Length <= 8: returns first 2 chars + `"***"` -- Length > 8: returns first 4 chars + `"..."` + last 4 chars - ---- - -## 6. Key Behavioral Patterns - -These patterns are the **contract** both CLIs must follow. Any new implementation must replicate them exactly. - -### 6.1 Entity ID Resolution - -**Function:** `_resolve_ids` (Python) / `resolveIds` (Node) - -**Rule:** If **any** explicit entity ID is provided via CLI flags, only use the explicitly provided IDs. Do NOT mix in defaults for other entity types (which would over-filter). If **no** explicit IDs are provided, fall back to **all** configured defaults. - -``` -if any(user_id, agent_id, app_id, run_id): - # Only use what was explicitly passed; others become None - return {user_id or None, agent_id or None, app_id or None, run_id or None} -else: - # Fall back to all configured defaults - return {config.user_id or None, config.agent_id or None, ...} -``` - -**Rationale:** If a user passes `--user-id alice` and the config also has `agent_id=bot1`, they probably want only Alice's memories, not the intersection of Alice AND bot1. - -### 6.2 Graph Tri-State Resolution - -**Rule:** `--no-graph` > `--graph` > config default. - -``` -if opts.no_graph: return false -if opts.graph: return true -return config.defaults.enable_graph -``` - -This is resolved in the main app file (not in the command handlers) before calling the command function. - -### 6.3 Category Parsing - -**Rule:** Try JSON parse first, fallback to comma-split. - -``` -if categories: - try: - cats = JSON.parse(categories) # e.g. '["a","b"]' - except: - cats = categories.split(",").map(s => s.trim()) # e.g. "a, b" -``` - -### 6.4 Stdin Detection - -**Rule:** Read from stdin if no text argument is provided AND stdin is piped (not a TTY). - -- `add`: If no `text`, no `--messages`, no `--file`, and stdin is piped -> read content from stdin. -- `search`: If no `query` argument and stdin is piped -> read query from stdin. -- `update`: If no `text` argument and no `--metadata` and stdin is piped -> read text from stdin. - -Detection method: -- Python: `not sys.stdin.isatty()` -- Node: `!process.stdin.isTTY` - -Reading method: -- Python: `sys.stdin.read().strip()` -- Node: `fs.readFileSync(0, "utf-8").trim()` - -### 6.5 Filter Building (`_buildFilters`) - -Detailed algorithm (see Section 4 for full description): - -1. If `extraFilters` has `AND` or `OR` key -> return it as-is (pre-built filter). -2. Collect AND conditions from entity IDs. -3. Append extra filters (category, date ranges). -4. 0 conditions -> `undefined`/`None`. -5. 1 condition -> return that single object. -6. 2+ conditions -> `{"AND": [...]}`. - -### 6.6 API Response Normalization - -All `search` and `listMemories`/`list_memories` calls normalize the response: - -``` -if Array.isArray(result): return result -return result.results ?? result.memories ?? [] -``` - -This handles both direct array responses and wrapped `{results: [...]}` or `{memories: [...]}` formats. - -### 6.7 Config File Permissions - -- Config directory (`~/.mem0/`): created with mode `0o700` (owner read+write+execute only). -- Config file (`~/.mem0/config.json`): written with mode `0o600` (owner read+write only). -- Python uses `os.chmod()` with `stat.S_IRWXU` (dir) and `stat.S_IRUSR | stat.S_IWUSR` (file). -- Node uses `fs.mkdirSync(..., { mode: 0o700 })` and `fs.chmodSync(file, 0o600)`. - -### 6.8 Timed Status Pattern - -Every API call is wrapped in a spinner + timing pattern: - -**Python:** -```python -with timed_status(err_console, "Adding memory...") as ts: - result = backend.add(...) -``` -Uses Rich `Status` context manager on stderr. On success, prints `ts.success_msg` with elapsed time. On error, prints `ts.error_msg` with elapsed time. - -**Node:** -```typescript -result = await timedStatus("Adding memory...", async (ctx) => { - return backend.add(...); -}); -``` -Uses `ora` spinner on stderr. On success, prints `ctx.successMsg` with elapsed time. On error, prints `ctx.errorMsg` with elapsed time. - -Both use `performance.now()` / `time.perf_counter()` for timing. Elapsed time is formatted as `{seconds:.2f}s`. - -**Key:** Spinners and timing messages always go to **stderr** so they never contaminate machine-readable stdout. - -### 6.9 Error Hierarchy - -``` -AuthError (HTTP 401) -> "Authentication failed. Your API key may be invalid or expired." -NotFoundError (HTTP 404) -> "Resource not found: {path}" -APIError (HTTP 400) -> "Bad request to {path}: {detail}" -``` - -For HTTP 400, the CLI attempts to extract a `detail` field from the JSON response body. If parsing fails, falls back to `resp.statusText`/`resp.text`. - -HTTP 204 is treated as success with empty body (`{}`). - -Any other non-OK response throws a generic error with `"HTTP {status}: {statusText}"`. - -### 6.10 `delete --all --project` Wildcard Behavior - -When `delete --all --project` is used, the CLI sends wildcard entity IDs (`user_id=*`, `agent_id=*`, `app_id=*`, `run_id=*`) to `DELETE /v1/memories/`. The API typically returns an **asynchronous response** with a `message` field (the deletion happens in the background). The CLI detects the `message` key in the response and prints "Deletion started. Memories will be removed in the background." instead of a success count. - -### 6.11 Non-Interactive Init - -When both `--api-key` and `--user-id` are provided to `mem0 init`: -1. Sets config values directly (no prompts). -2. Validates the platform connection. -3. Saves config to disk. -4. Prints success message. - -When running in a non-TTY (piped input) without both flags, prints an error with usage hint: -``` -"Non-interactive terminal detected and missing required flags." -"Usage: mem0 init --api-key --user-id " -``` - -### 6.12 Add Result Event Display - -The `format_add_result` function handles the API response from `POST /v1/memories/`: - -The response is either a direct array or `{results: [...]}`. Each result item has an `event` field: - -| Event | Icon | Label | -|----------|------|------------| -| `ADD` | `+` | Added | -| `UPDATE` | `~` | Updated | -| `DELETE` | `-` | Deleted | -| `NOOP` | `.` | No change | -| `PENDING`| hourglass | Queued (async) | - -For `PENDING` events, displays "Processing in background" with the event ID. - ---- - -## 7. Output Modes - -### 7.1 Supported Modes Per Command - -All commands also support `agent` mode via the global `--json`/`--agent` flag, which wraps output in a structured JSON envelope with sanitized fields. - -| Command | text | json | table | quiet | -|----------------|------|------|-------|-------| -| add | Y | Y | - | Y | -| search | Y | Y | Y | - | -| get | Y | Y | - | - | -| list | Y | Y | Y (default) | - | -| update | Y | Y | - | Y | -| delete | Y | Y | - | Y | -| import | Y | Y | - | - | -| config show | Y | Y | - | - | -| config get | (raw value) | - | - | - | -| config set | (success msg) | - | - | - | -| entity list | - | Y | Y (default) | - | -| entity delete | Y | Y | - | Y | -| event list | Y (table) | Y | - | - | -| event status | Y | Y | - | - | -| status | Y | Y | - | - | -| help | Y | Y (--json) | - | - | - -### 7.2 JSON Envelope Format - -There are two related envelope formats: - -**`formatJsonEnvelope`** — used by `config show`, `status`, and `import` for `--output json`: - -```json -{ - "status": "success", - "command": "", - "duration_ms": 245, - "scope": {"user_id": "alice", "agent_id": null}, - "count": 10, - "error": null, - "data": { ... } -} -``` - -**`formatAgentEnvelope`** — used by all commands in agent mode (`--json`/`--agent`). Same structure, but `data` is passed through `sanitizeAgentData(command, data)` to project only the most relevant fields: - -| Command | Fields in `data` | -|---------------|-----------------| -| add | `[{id, memory, event}]` or `[{status, event_id}]` for PENDING | -| search | `[{id, memory, score, created_at, categories}]` | -| list | `[{id, memory, created_at, categories}]` | -| get | `{id, memory, created_at, updated_at, categories, metadata}` | -| update | `{id, memory}` | -| delete | (raw API response) | -| entity list | `[{name, type, count}]` | -| event list | `[{id, event_type, status, latency, created_at}]` | -| event status | `{id, event_type, status, latency, created_at, updated_at, results: [{id, event, user_id, memory}]}` | -| status/config/import | (pass-through) | - -Error envelopes (on non-zero exit): -```json -{ - "status": "error", - "command": "", - "error": "Authentication failed. Your API key may be invalid or expired.", - "data": null -} -``` - -Fields: -- `status`: `"success"` or `"error"`. -- `command`: The command name. -- `duration_ms`: Optional, elapsed time in milliseconds. -- `scope`: Optional, active entity scope (omitted if empty). -- `count`: Optional, result count. -- `error`: Only present when `status` is `"error"`. -- `data`: The primary payload (sanitized in agent mode). - -### 7.3 Text Output - -- `formatMemoriesText`: Numbered list with memory text, score, ID (first 8 chars), created date, and category, separated by ` . ` in dim color. -- `formatSingleMemory`: Boxed panel (boxen/Rich Panel) showing memory text, ID, created date, updated date, metadata, and categories. -- `formatAddResult`: Event-based output with icons (+, ~, -, .) and labels. - -### 7.4 Table Output - -Uses `cli-table3` (Node) or `rich.table.Table` (Python) with columns: -- ID (first 8 chars, dim) -- Memory (truncated to 60 chars with "...") -- Category (first category from array) -- Created (YYYY-MM-DD) - -### 7.5 Quiet Mode - -Commands that support `--output quiet` (`add`, `update`, `delete`, `entity delete`) produce **no stdout output** in quiet mode. The operation still executes. Exit code indicates success/failure. - -### 7.6 Error Output - -- **Errors always go to stderr.** Both CLIs use a separate stderr console: - - Python: `Console(stderr=True)` for `print_error` calls. - - Node: `console.error()` in `printError`, spinner on `process.stderr` stream. -- **Data always goes to stdout.** JSON output, table output, and text output all go to stdout. - -### 7.7 Unicode Symbol Degradation - -The `_sym`/`sym` function selects symbols based on terminal capability: - -| Condition | Fancy Symbol | Plain Fallback | -|----------------------------------------|-------------|----------------| -| `!stdout.isTTY` or `NO_COLOR` env set | - | Used | -| Interactive TTY with color | Used | - | - -| Symbol | Fancy | Plain | -|----------|-------|-----------| -| Success | `checkmark` | `[ok]` | -| Error | `X` | `[error]` | -| Warning | `warning triangle` | `[warn]` | -| Info | `diamond` | `*` | - -### 7.8 Result Summary Footer - -After list/search results, a summary line is printed in dim: -``` - 10 results . page 1 . user id=alice . 0.45s -``` - -Format: `{count} result(s) . page {n} . {scope} . {elapsed}s` - -### 7.9 Date Formatting - -All dates are normalized to `YYYY-MM-DD` format for display. The formatting handles ISO 8601 strings with `Z` timezone suffix by replacing it with `+00:00` before parsing. - ---- - -## 8. Agent-Friendly Design Decisions - -### Why `--dry-run` exists on destructive commands - -The `delete` command (all modes) and `entity delete` support `--dry-run`. This lets AI agents preview the effect of a destructive operation before committing. For `delete `, it fetches the memory and displays it. For `delete --all`, it lists matching memories and shows the count. For `delete --entity` / `entity delete`, it shows the scope that would be affected. - -### Why `--force` exists - -Destructive commands (`delete --all`, `delete --entity`, `entity delete`) require interactive confirmation by default. The `--force` flag skips this confirmation, which is essential for: -- AI agents (non-interactive) -- CI/CD pipelines -- Scripting - -### Why `--json`/`--agent` global flags exist - -The `--json` and `--agent` flags (aliases of each other) activate agent mode globally. When set: -1. All output becomes a structured JSON envelope (`{status, command, duration_ms, scope, count, data}`). -2. The `data` field is sanitized via `sanitizeAgentData` — only the most relevant fields are included per command, reducing noise for agents parsing the output. -3. All human-readable output (spinners, colors, banners, timing lines) is suppressed. -4. Errors are emitted as JSON to stdout with a non-zero exit code, not to stderr as text. - -This is distinct from `--output json`, which returns the raw API response without sanitization. - -### Why `--output json` is on every command - -Every data-returning command supports `--output json` (or `--json` for `help`). This enables machine consumption by AI agents and scripts. JSON output goes to stdout while human-readable spinners/timing go to stderr, so piping `mem0 list -o json | jq .` works cleanly. - -### Why stdin is supported - -Commands `add`, `search`, and `update` can read from stdin when piped. This enables composability: -```bash -echo "I prefer dark mode" | mem0 add -u alice -cat query.txt | mem0 search -u alice -echo "updated text" | mem0 update abc-123 -``` - -### Why `help --json` exists - -The `help --json` command outputs the complete CLI specification in machine-readable JSON. AI agents can call this once to discover all available commands, their arguments, options, and valid values -- enabling self-documenting tool use. - -### Why errors go to stderr - -All error messages, warnings, spinners, and timing information go to stderr. This means `--output json` produces **only** valid JSON on stdout, with no interleaved human-readable messages. An AI agent can safely parse stdout as JSON. - ---- - -## 9. Adding a New Command - -Step-by-step guide for adding a new command to both CLIs. - -### Step 1: Add to `cli-spec.json` - -Add a new entry to the `commands` array with all required fields: - -```json -{ - "name": "my-command", - "description": "What this command does.", - "usage": "mem0 my-command [OPTIONS]", - "needsBackend": true, - "needsConfig": true, - "resolveIds": true, - "resolveGraph": false, - "confirmDangerous": false, - "outputFormats": ["text", "json"], - "defaultOutput": "text", - "arguments": [ - { - "name": "arg", - "type": "string", - "required": true, - "help": "Argument description." - } - ], - "options": [ - { - "name": "user_id", - "flags": ["--user-id", "-u"], - "type": "string", - "help": "Scope to user.", - "panel": "Scope" - }, - { - "name": "output", - "flags": ["--output", "-o"], - "type": "string", - "default": "text", - "help": "Output format.", - "panel": "Output" - } - ], - "apiEndpoint": "myEndpoint" -} -``` - -If the command calls a new API endpoint, also add it to `api.endpoints`. - -### Step 2: Add Backend Method (if new API endpoint) - -**Python** (`python/src/mem0_cli/backend/base.py` and `platform.py`): -1. Add abstract method to `Backend` ABC in `base.py`. -2. Implement in `PlatformBackend` in `platform.py`. - -**Node** (`node/src/backend/base.ts` and `platform.ts`): -1. Add method signature to `Backend` interface in `base.ts`. -2. Implement in `PlatformBackend` class in `platform.ts`. - -### Step 3: Add Command Handler - -**Python** (`python/src/mem0_cli/commands/`): -Create a function `cmd_my_command(backend, ...)` in the appropriate commands file. Follow the patterns: -- Use `timed_status(err_console, "...")` for API calls. -- Use `print_error(err_console, ...)` for errors. -- Use `format_json(console, ...)` for JSON output. -- Raise `typer.Exit(1)` on errors. - -**Node** (`node/src/commands/`): -Create an async function `cmdMyCommand(backend, ...)`. Follow the patterns: -- Use `await timedStatus("...", async () => { ... })` for API calls. -- Use `printError(...)` for errors. -- Use `formatJson(...)` for JSON output. -- Call `process.exit(1)` on errors. - -### Step 4: Register in App Entrypoint - -**Python** (`python/src/mem0_cli/app.py`): -```python -@app.command(name="my-command") -def my_command( - arg: str = typer.Argument(..., help="..."), - output: str = typer.Option("text", "--output", "-o", help="...", rich_help_panel="Output"), - api_key: str | None = typer.Option(None, "--api-key", help="...", rich_help_panel="Connection"), - base_url: str | None = typer.Option(None, "--base-url", help="...", rich_help_panel="Connection"), -) -> None: - """Command description.""" - from mem0_cli.commands.my_module import cmd_my_command - backend, config = _get_backend_and_config(api_key, base_url) - ids = _resolve_ids(config, ...) - cmd_my_command(backend, arg, **ids, output=output) -``` - -**Node** (`node/src/index.ts`): -```typescript -program - .command("my-command ") - .description("Command description.") - .option("-o, --output ", "Output format.", "text") - .option("--api-key ", "Override API key.") - .option("--base-url ", "Override API base URL.") - .action(async (arg, opts) => { - const { cmdMyCommand } = await import("./commands/my-module.js"); - const { backend, config } = getBackendAndConfig(opts.apiKey, opts.baseUrl); - const ids = resolveIds(config, opts); - await cmdMyCommand(backend, arg, { ...ids, output: opts.output }); - }); -``` - -### Step 5: Add Help Examples - -Both CLIs include examples in the help text: -- Python: In the docstring of the Typer command function. -- Node: Via `.addHelpText("after", "\nExamples:\n $ mem0 ...")`. - -### Step 6: Add to Help Display and Command Order - -**Node** (`node/src/help.ts`): -1. Add `"my-command"` to `COMMAND_ORDER` array (determines display order in `--help`). -2. Add option-to-panel mappings in `OPTION_PANELS["my-command"]`. - -**Python**: Options are assigned to panels via `rich_help_panel="..."` on each `typer.Option()`. The `help` command's `_build_help_json()` function needs a new entry. - -### Step 7: Add to `help` Command Output - -**Python** (`python/src/mem0_cli/app.py`): -1. Add entry in `_build_help_json()` dict. -2. Add line in the `help` command's human-readable output. - -**Node** (`node/src/index.ts`): -Add line in the `help` command's human-readable output listing. - -### Step 8: Add Tests - -- Python: Add tests in `python/tests/`. -- Node: Add tests in `node/src/__tests__/` or similar. - -### Step 9: Update This Specification - -Add the command to the Complete Command Reference (Section 3) with all arguments, options, behavior notes, and examples. - ---- - -## 10. Adding a New Language Implementation - -To add a new language implementation (e.g., Go, Rust, Ruby), you need to replicate the exact behavioral contract defined in `cli-spec.json` and this document. Here is what is required: - -### 10.1 Core Modules to Implement - -| Module | Purpose | -|---------------|---------| -| **config** | Load `~/.mem0/config.json`, apply env var overrides, enforce precedence. Implement `load_config`, `save_config`, `ensure_config_dir`, `redact_key`, `get_nested_value`, `set_nested_value`. | -| **backend/base** | Define the `Backend` interface/trait with all 8 methods: `add`, `search`, `get`, `list_memories`, `update`, `delete`, `delete_entities`, `status`, `entities`. Define error types: `AuthError`, `NotFoundError`, `APIError`. | -| **backend/platform** | Implement `PlatformBackend` with HTTP client. Must implement `_build_filters` logic exactly. Must handle response normalization. Must set `Authorization: Token ` header. 30s timeout. | -| **branding** | Implement print helpers (`print_success`, `print_error`, `print_warning`, `print_info`, `print_scope`), `print_banner`, `timed_status` pattern, `sym` function for Unicode degradation. Colors must match the hex values in `cli-spec.json`. | -| **output** | Implement `format_memories_text`, `format_memories_table`, `format_single_memory`, `format_add_result`, `format_json`, `format_json_envelope`, `print_result_summary`. Date formatting to YYYY-MM-DD. ID truncation to 8 chars. Memory text truncation to 60 chars in tables. | -| **commands/** | Implement all command handlers matching the exact behavior described in Section 3. | -| **app/main** | CLI entrypoint with all commands registered. Implement `resolve_ids`, `resolve_graph`, stdin detection, and the `getBackendAndConfig` helper. | -| **help** | Implement help formatter with grouped option panels (Scope, Search, Pagination, Filters, Output, Connection). Implement `help --json` output. | - -### 10.2 Behavioral Checklist - -Every new implementation MUST: - -- [ ] Read and respect `cli-spec.json` for all command names, descriptions, argument names, option flags, and defaults -- [ ] Implement config precedence: CLI flags > env vars > config file > defaults -- [ ] Implement entity ID resolution (explicit IDs only vs. all defaults) -- [ ] Implement graph tri-state (`--no-graph` > `--graph` > config default) -- [ ] Implement category parsing (JSON first, comma-split fallback) -- [ ] Implement stdin detection and reading for `add`, `search`, `update` -- [ ] Implement `_build_filters` with AND/OR structure -- [ ] Implement response normalization (array vs `{results}` vs `{memories}`) -- [ ] Set config directory permissions to 0700 and file to 0600 -- [ ] Implement timed status with spinner on stderr + elapsed time -- [ ] Implement error hierarchy (AuthError 401, NotFoundError 404, APIError 400) -- [ ] Implement `delete --all --project` with wildcard `*` entity IDs and async response handling -- [ ] Implement non-interactive `init` when both `--api-key` and `--user-id` provided -- [ ] Implement `--dry-run` on delete (all modes) and entity delete -- [ ] Implement `--force` on delete --all, delete --entity, and entity delete -- [ ] Send errors to stderr, data to stdout -- [ ] Implement Unicode symbol degradation for non-TTY/NO_COLOR -- [ ] Implement JSON envelope format for status, config show, import -- [ ] Support `--output` on all data-returning commands -- [ ] Implement `help --json` for machine-readable command discovery -- [ ] Implement masked API key input during `init` (echo `*` per character) -- [ ] Implement confirmation prompts for dangerous commands (unless `--force`) -- [ ] Binary must be named `mem0` - -### 10.3 Package Metadata - -Follow the naming conventions: -- Package description: "The official CLI for mem0 -- the memory layer for AI agents" -- Author: `mem0.ai ` -- License: Apache-2.0 -- Keywords: `mem0`, `memory`, `ai`, `agents`, `cli` - -### 10.4 Testing - -Conformance tests should verify: -- All commands from `cli-spec.json` are registered -- All options from `cli-spec.json` are accepted -- Config precedence is correct -- Entity ID resolution matches the spec -- Filter building produces correct structures -- Output modes produce expected formats -- Error codes are mapped correctly -- Stdin reading works for supported commands From f8082a7345dadd9e042ebbc40b57b1498c8f6d63 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 22 Sep 2026 20:06:21 +0530 Subject: [PATCH 21/55] Fix grammar & typos: API casing in template heading (#7410) Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs/templates/api_reference_template.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/templates/api_reference_template.mdx b/docs/templates/api_reference_template.mdx index d04412863..67a83d556 100644 --- a/docs/templates/api_reference_template.mdx +++ b/docs/templates/api_reference_template.mdx @@ -4,7 +4,7 @@ description: "Standard layout for documenting Mem0 API endpoints." icon: "code" --- -# Api Reference Template +# API Reference Template API reference pages document a single endpoint contract. Present metadata, request/response examples, and recovery guidance without narrative detours. From 8c02c425a53ea31bd0d493bbcf0ab22c1be3609d Mon Sep 17 00:00:00 2001 From: Kartik Date: Wed, 23 Sep 2026 19:35:25 +0530 Subject: [PATCH 22/55] fix(agent-plugins): match memo prompts and tool descriptions, release 0.3.3 (#7420) Co-authored-by: Claude --- .claude-plugin/marketplace.json | 2 +- .cursor-plugin/marketplace.json | 2 +- .kimi-plugin/marketplace.json | 2 +- docs/changelog/sdk.mdx | 84 +++++++++++++++++++ integrations/agent-plugin-core/README.md | 4 +- .../agent-plugin-core/python/mcp_server.py | 13 +-- .../agent-plugin-core/python/memory_core.py | 10 +-- .../skills/search/SKILL.md.tmpl | 8 +- .../typescript/src/lifecycle.ts | 7 +- .../typescript/src/prompts.ts | 10 +++ .../typescript/tests/prompts.test.ts | 31 +++++++ .../antigravity-plugin/core/mcp_server.py | 13 +-- .../antigravity-plugin/core/memory_core.py | 10 +-- .../antigravity-plugin/plugin-build.json | 2 +- .../antigravity-plugin/skills/search/SKILL.md | 8 +- .../.claude-plugin/plugin.json | 2 +- .../claude-code-plugin/agents/sidekick.md | 7 +- .../claude-code-plugin/core/mcp_server.py | 13 +-- .../claude-code-plugin/core/memory_core.py | 10 +-- .../claude-code-plugin/plugin-build.json | 2 +- .../claude-code-plugin/skills/search/SKILL.md | 8 +- .../tests/test_memory_core.py | 8 +- .../codex-plugin/.codex-plugin/plugin.json | 2 +- integrations/codex-plugin/core/mcp_server.py | 13 +-- integrations/codex-plugin/core/memory_core.py | 10 +-- integrations/codex-plugin/plugin-build.json | 2 +- .../codex-plugin/skills/search/SKILL.md | 8 +- .../cursor-plugin/.cursor-plugin/plugin.json | 2 +- integrations/cursor-plugin/core/mcp_server.py | 13 +-- .../cursor-plugin/core/memory_core.py | 10 +-- integrations/cursor-plugin/plugin-build.json | 2 +- .../cursor-plugin/skills/search/SKILL.md | 8 +- integrations/deepseek-plugin/package.json | 2 +- integrations/deepseek-plugin/src/index.ts | 12 ++- integrations/kimi-plugin/core/mcp_server.py | 13 +-- integrations/kimi-plugin/core/memory_core.py | 10 +-- integrations/kimi-plugin/kimi.plugin.json | 2 +- integrations/kimi-plugin/plugin-build.json | 2 +- .../kimi-plugin/skills/search/SKILL.md | 8 +- .../mem0-agent-plugin/core/mcp_server.py | 13 +-- .../mem0-agent-plugin/core/memory_core.py | 10 +-- integrations/mem0-agent-plugin/plugin.json | 2 +- .../mem0-agent-plugin/skills/search/SKILL.md | 8 +- integrations/openclaw/openclaw.plugin.json | 2 +- integrations/openclaw/package.json | 2 +- integrations/openclaw/tools/memory-search.ts | 5 +- integrations/opencode-plugin/opencode-mem0.ts | 11 +-- .../mem0-context-loader/SKILL.md | 24 +----- .../opencode-skills/mem0-search/SKILL.md | 7 +- integrations/opencode-plugin/package.json | 2 +- integrations/pi-agent-plugin/README.md | 2 +- integrations/pi-agent-plugin/package.json | 2 +- .../skills/context-loader/SKILL.md | 23 +---- .../pi-agent-plugin/src/memory/tools.ts | 10 +-- integrations/pi-agent-plugin/src/prompt.ts | 11 ++- marketplace.json | 2 +- 56 files changed, 262 insertions(+), 249 deletions(-) create mode 100644 integrations/agent-plugin-core/typescript/src/prompts.ts create mode 100644 integrations/agent-plugin-core/typescript/tests/prompts.test.ts diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index ccaa4dcea..752311cbc 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -12,7 +12,7 @@ "name": "mem0", "source": "./integrations/claude-code-plugin", "description": "Cross-session memory and token savings for coding agents.", - "version": "0.3.2" + "version": "0.3.3" } ] } diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 84f31855b..4d083a06b 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -12,7 +12,7 @@ "name": "mem0", "source": "./integrations/cursor-plugin", "description": "Cross-session memory and token savings for coding agents.", - "version": "0.3.2" + "version": "0.3.3" } ] } diff --git a/.kimi-plugin/marketplace.json b/.kimi-plugin/marketplace.json index 0b8cbcac0..47c986c6c 100644 --- a/.kimi-plugin/marketplace.json +++ b/.kimi-plugin/marketplace.json @@ -5,7 +5,7 @@ { "id": "mem0", "displayName": "Mem0", - "version": "0.3.2", + "version": "0.3.3", "description": "Cross-session memory and token savings for coding agents.", "homepage": "https://mem0.ai", "keywords": ["memory", "personalization", "mcp", "semantic-search"], diff --git a/docs/changelog/sdk.mdx b/docs/changelog/sdk.mdx index 5562fbe1d..008e58b9f 100644 --- a/docs/changelog/sdk.mdx +++ b/docs/changelog/sdk.mdx @@ -2394,6 +2394,17 @@ Initial release of the Mem0 plugin for Claude Code and Cursor, followed by Codex + + +**Improvements:** +- **Search:** The `search_memories` tool description no longer tells the agent to call it before answering anything that could depend on prior context. It now asks for a search before repeating investigation or when earlier decisions, fixes, commands, or results may help, which reduces unnecessary searches ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Sidekick:** Sidekick searches memories when earlier sessions could help, instead of before every answer ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Extraction:** Repository memory instructions are shorter. They no longer ask for a dedicated memory for each command that failed and was then fixed, and no longer carry separate rules against saving personal preferences or memories that only name the repository, branch, or directory ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Search skill:** `/search` no longer describes categories as best-effort labels or asks for a retry without the category ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Packaging:** `PLUGIN_VERSION` bumped to `0.3.3`, so the `mem0-plugin/` wire header and `plugin_version` telemetry field identify builds with these prompts ([#7420](https://github.com/mem0ai/mem0/pull/7420)) + + + **Improvements:** @@ -2424,6 +2435,16 @@ Initial release of the Mem0 plugin for Claude Code and Cursor, followed by Codex + + +**Improvements:** +- **Search:** The `search_memories` tool description no longer tells the agent to call it before answering anything that could depend on prior context. It now asks for a search before repeating investigation or when earlier decisions, fixes, commands, or results may help, which reduces unnecessary searches ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Extraction:** Repository memory instructions are shorter. They no longer ask for a dedicated memory for each command that failed and was then fixed, and no longer carry separate rules against saving personal preferences or memories that only name the repository, branch, or directory ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Search skill:** `/search` no longer describes categories as best-effort labels or asks for a retry without the category ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Packaging:** `PLUGIN_VERSION` bumped to `0.3.3`, so the `mem0-plugin/` wire header and `plugin_version` telemetry field identify builds with these prompts ([#7420](https://github.com/mem0ai/mem0/pull/7420)) + + + **Improvements:** @@ -2454,6 +2475,16 @@ Initial release of the Mem0 plugin for Claude Code and Cursor, followed by Codex + + +**Improvements:** +- **Search:** The `search_memories` tool description no longer tells the agent to call it before answering anything that could depend on prior context. It now asks for a search before repeating investigation or when earlier decisions, fixes, commands, or results may help, which reduces unnecessary searches ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Extraction:** Repository memory instructions are shorter. They no longer ask for a dedicated memory for each command that failed and was then fixed, and no longer carry separate rules against saving personal preferences or memories that only name the repository, branch, or directory ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Search skill:** `/search` no longer describes categories as best-effort labels or asks for a retry without the category ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Packaging:** `PLUGIN_VERSION` bumped to `0.3.3`, so the `mem0-plugin/` wire header and `plugin_version` telemetry field identify builds with these prompts ([#7420](https://github.com/mem0ai/mem0/pull/7420)) + + + **Improvements:** @@ -2483,6 +2514,15 @@ Initial release of the Mem0 plugin for Claude Code and Cursor, followed by Codex + + +**Improvements:** +- **Search:** The `search_memories` tool description no longer asks the agent to search proactively or to run several searches for multi-part questions. It now asks for a search before repeating investigation or when earlier decisions, fixes, commands, or results may help, the same wording as the other coding-agent plugins ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Session context:** Removed two system-context lines that told the agent to run 2 parallel searches before responding and 2-4 parallel searches for non-trivial tasks ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Skills:** `/mem0-search` and `/mem0-context-loader` make one `search_memories` call instead of 2 and 2-4 parallel calls. `/mem0-context-loader` now uses the search skill description from the other coding-agent plugins instead of asking to load at every new task or context switch ([#7420](https://github.com/mem0ai/mem0/pull/7420)) + + + **Changes:** @@ -2589,6 +2629,16 @@ Initial release of the Mem0 plugin for Claude Code and Cursor, followed by Codex + + +**Improvements:** +- **Search:** The `search_memories` tool description no longer tells the agent to call it before answering anything that could depend on prior context. It now asks for a search before repeating investigation or when earlier decisions, fixes, commands, or results may help, which reduces unnecessary searches ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Extraction:** Repository memory instructions are shorter. They no longer ask for a dedicated memory for each command that failed and was then fixed, and no longer carry separate rules against saving personal preferences or memories that only name the repository, branch, or directory ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Search skill:** `/search` no longer describes categories as best-effort labels or asks for a retry without the category ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Packaging:** `PLUGIN_VERSION` bumped to `0.3.3`, so the `mem0-plugin/` wire header and `plugin_version` telemetry field identify builds with these prompts ([#7420](https://github.com/mem0ai/mem0/pull/7420)) + + + **Improvements:** @@ -2692,6 +2742,16 @@ Existing memories written by the previous versions are not rewritten. If your me + + +**Improvements:** +- **Search:** The `search_memories` tool description no longer tells the agent to call it before answering anything that could depend on prior context. It now asks for a search before repeating investigation or when earlier decisions, fixes, commands, or results may help, which reduces unnecessary searches ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Extraction:** Repository memory instructions are shorter. They no longer ask for a dedicated memory for each command that failed and was then fixed, and no longer carry separate rules against saving personal preferences or memories that only name the repository, branch, or directory ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Search skill:** `/search` no longer describes categories as best-effort labels or asks for a retry without the category ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Packaging:** `PLUGIN_VERSION` bumped to `0.3.3`, so the `mem0-plugin/` wire header and `plugin_version` telemetry field identify builds with these prompts ([#7420](https://github.com/mem0ai/mem0/pull/7420)) + + + **Improvements:** @@ -2737,6 +2797,13 @@ Existing memories written by the previous versions are not rewritten. If your me + + +**Improvements:** +- **Search:** The `memory_search` tool description no longer asks the agent to search proactively or to run several searches for multi-part questions. It now asks for a search before repeating investigation or when earlier decisions, fixes, commands, or results may help. Recall strategies (`smart`, `always`, `manual`) are unchanged ([#7420](https://github.com/mem0ai/mem0/pull/7420)) + + + **Changes:** @@ -3033,6 +3100,15 @@ Existing memories written by the previous versions are not rewritten. If your me + + +**Improvements:** +- **Search:** The memory policy, `mem0_memory` tool description, and prompt guidelines no longer ask the agent to search before answering anything that may depend on earlier context or to run several searches per question. They now ask for a search before repeating investigation or when earlier decisions, fixes, commands, or results may help ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Skills:** `context-loader` makes one search instead of 2-4 parallel searches, and uses the search skill description from the other coding-agent plugins ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Automatic recall:** Injected memories are introduced as "Mem0 found these relevant memories from earlier work in this repository:", the same heading as the Python plugins. The old heading called them a shallow first pass and told the agent to search again ([#7420](https://github.com/mem0ai/mem0/pull/7420)) + + + **Improvements:** @@ -3153,6 +3229,14 @@ Existing memories written by the previous versions are not rewritten. If your me + + +**Improvements:** +- **Search:** The `search_memory` tool description no longer asks the agent to search proactively before answering anything that may depend on earlier context. It now asks for a search before repeating investigation or when earlier decisions, fixes, commands, or results may help ([#7420](https://github.com/mem0ai/mem0/pull/7420)) +- **Automatic recall:** Injected memories are introduced as "Mem0 found these relevant memories from earlier work:". The old heading called them a shallow first pass and told the agent to search again with `mem0_memory`, a tool DeepSeek does not have ([#7420](https://github.com/mem0ai/mem0/pull/7420)) + + + **Improvements:** diff --git a/integrations/agent-plugin-core/README.md b/integrations/agent-plugin-core/README.md index f11026319..dab9a88b7 100644 --- a/integrations/agent-plugin-core/README.md +++ b/integrations/agent-plugin-core/README.md @@ -8,7 +8,7 @@ This directory is the single source of shared memory behavior for Mem0 coding-ag integrations/ ├── agent-plugin-core/ # Shared source; never installed as a plugin │ ├── python/ # Claude-derived capture, recall, MCP, scoping, and telemetry -│ ├── typescript/ # Shared lifecycle, formatting, identity, scoping, and telemetry +│ ├── typescript/ # Shared lifecycle, search prompts, formatting, identity, scoping, and telemetry │ ├── skills/ # The only source for the six generated memory skills │ ├── build/ # Bundle builder, schemas, and validation │ ├── conformance/ # One offline/live verification entry point @@ -45,7 +45,7 @@ New Git repository writes use a hashed remote identity for shared `agent_id`. Se Captured prompts and responses preserve their full text after secret redaction. Python extraction splits oversized input across requests without dropping message text. The session-end worker flushes the conversation already collected by hooks without adding the final answer again. Search queries, retrieved context, and tool evidence have separate limits. -TypeScript hosts reuse redaction and lifecycle utilities but retain their own tools, scopes, and capture events. They do not inherit the Python `repo`/`dir`/`mine` contract or its background batching. OpenCode captures selected user prompts; Pi and DeepSeek capture completed conversation turns; OpenClaw selects recent messages and earlier summaries, then filters noise. Removing message-length truncation does not turn these integrations into complete transcript archives. +TypeScript hosts reuse redaction, lifecycle utilities, and the search prompts in `typescript/src/prompts.ts`, which a test keeps identical to the Python core. They retain their own tools, scopes, and capture events. They do not inherit the Python `repo`/`dir`/`mine` contract or its background batching. OpenCode captures selected user prompts; Pi and DeepSeek capture completed conversation turns; OpenClaw selects recent messages and earlier summaries, then filters noise. Removing message-length truncation does not turn these integrations into complete transcript archives. For installation, follow the host guides: [Claude Code](../../docs/integrations/claude-code.mdx), [Cursor](../../docs/integrations/cursor.mdx), [Codex](../../docs/integrations/codex.mdx), [Kimi](../../docs/integrations/kimi.mdx), and [Antigravity](../../docs/integrations/antigravity.mdx). diff --git a/integrations/agent-plugin-core/python/mcp_server.py b/integrations/agent-plugin-core/python/mcp_server.py index 036fbbdc9..a0b73cb79 100644 --- a/integrations/agent-plugin-core/python/mcp_server.py +++ b/integrations/agent-plugin-core/python/mcp_server.py @@ -21,16 +21,9 @@ from memory_core import ( PROTOCOL_VERSION = "2024-11-05" TOOL_NAME = "search_memories" TOOL_DESCRIPTION = ( - "Search memories from earlier work in this repository. ALWAYS call this " - "tool before answering anything that could depend on prior context: the " - "user's preferences, facts about this codebase, history, people, projects, " - "or earlier decisions. Do not rely on the chat window alone. The " - "repository's memory is shared by everyone who works in it and includes " - "what it took to run, test, or build here, so search before assuming an " - "invocation works. The scope argument changes what is searched: 'repo' " - "(default) is the whole repository's shared memory plus your own " - "preferences, 'dir' narrows the shared part to the directory you are " - "working in, and 'mine' is your preferences alone." + "Search memories from earlier work in this repository. Use it before " + "repeating investigation or when earlier decisions, fixes, commands, or " + "results may help." ) TOOL_SCHEMA = { "type": "object", diff --git a/integrations/agent-plugin-core/python/memory_core.py b/integrations/agent-plugin-core/python/memory_core.py index ea2670dac..9b420a063 100644 --- a/integrations/agent-plugin-core/python/memory_core.py +++ b/integrations/agent-plugin-core/python/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.2" +PLUGIN_VERSION = "0.3.3" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" @@ -71,15 +71,13 @@ MAX_FLUSH_ATTEMPTS = 5 FORGET_PAGE_SIZE = 100 FORGET_MAX_PAGES = 50 -PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help anyone with future coding work in this repository. +PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help with future coding work. A completed change should produce one memory explaining the resulting behavior, where it is implemented when useful, and any important constraints or reasoning. Exploration or accepted decisions may produce separate memories only when they are independently useful. -A command that failed and was then made to work should produce one memory naming the failing invocation, the error it returned, and the invocation that succeeded. Do not save one-off errors caused by an edit still in progress, transient network failures, or anything a rerun would fix on its own. +Use the coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. -Use the current coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. - -Write about the repository, not the user, assistant, session, or task. Do not save personal preferences. Do not save a memory that only states which repository, branch, or directory the session worked in. Do not include test results, documentation updates, release notes, or temporary state. +Write about the repository, not the user, assistant, session, or task. Do not include test results, documentation updates, release notes, or temporary state. If nothing useful was established, return no memories.""" diff --git a/integrations/agent-plugin-core/skills/search/SKILL.md.tmpl b/integrations/agent-plugin-core/skills/search/SKILL.md.tmpl index 3a255b1ad..6c4fdd03c 100644 --- a/integrations/agent-plugin-core/skills/search/SKILL.md.tmpl +++ b/integrations/agent-plugin-core/skills/search/SKILL.md.tmpl @@ -12,11 +12,9 @@ Call `search_memories` with the user's question. Treat `--top-k`, `--category`, query. Omit `top_k` to use Mem0's configured default. Omit `category` to search every -category; a category is a best-effort label Mem0 assigned when it saved the -memory, so if a category search misses, repeat it without the category. Omit -`scope` to use the configured default, normally `repo`: this repository's -shared memory, which everyone who works in it contributes to, plus your own -preferences. +category. Omit `scope` to use the configured default, normally `repo`: this +repository's shared memory, which everyone who works in it contributes to, +plus your own preferences. Pass `scope` when the question needs something else: `dir` to narrow the shared memory to the directory you are working in (a package inside a diff --git a/integrations/agent-plugin-core/typescript/src/lifecycle.ts b/integrations/agent-plugin-core/typescript/src/lifecycle.ts index 42c522b54..738ccc1c7 100644 --- a/integrations/agent-plugin-core/typescript/src/lifecycle.ts +++ b/integrations/agent-plugin-core/typescript/src/lifecycle.ts @@ -1,5 +1,6 @@ import type { MemoryLike } from "./formatting.ts"; import { formatMemoryCompact } from "./formatting.ts"; +import { RECALL_HEADING } from "./prompts.ts"; const MAX_RECALL_QUERY_CHARS = 6_000; export const DEFAULT_MAX_CONTEXT_CHARS = 4_000; @@ -70,12 +71,14 @@ export function extractConversation( } interface RecallOptions { + heading?: string; maxChars?: number; seenIds?: Set; timeoutMs?: number; } interface MemoryLifecycleOptions { + recallHeading?: string; maxContextChars?: number; recallTimeoutMs?: number; } @@ -109,6 +112,7 @@ class MemoryLifecycle { search: (query: string) => Promise<{ results?: unknown[] }>, ): Promise { return buildRecallContext(prompt, enabled, search, { + heading: this.#options.recallHeading, maxChars: this.#options.maxContextChars, seenIds: this.#seenMemoryIds, timeoutMs: this.#options.recallTimeoutMs, @@ -148,8 +152,7 @@ export async function buildRecallContext( const unseen = memories.filter((memory) => !options.seenIds?.has(memory.id)); if (!unseen.length) return ""; - const prefix = - "\nRetrieved automatically for the current request. This is a shallow first pass — search mem0_memory for more if you need it.\n"; + const prefix = `\n${options.heading ?? RECALL_HEADING}\n`; const suffix = "\n"; const maxChars = options.maxChars ?? DEFAULT_MAX_CONTEXT_CHARS; const lines: string[] = []; diff --git a/integrations/agent-plugin-core/typescript/src/prompts.ts b/integrations/agent-plugin-core/typescript/src/prompts.ts new file mode 100644 index 000000000..cb4d4e07b --- /dev/null +++ b/integrations/agent-plugin-core/typescript/src/prompts.ts @@ -0,0 +1,10 @@ +export const SEARCH_WHEN = + "before repeating investigation or when earlier decisions, fixes, commands, or results may help"; + +export const SEARCH_TOOL_DESCRIPTION = `Search memories from earlier work in this repository. Use it ${SEARCH_WHEN}.`; +export const SEARCH_QUERY_DESCRIPTION = "A direct question about earlier work in this repository."; +export const RECALL_HEADING = "Mem0 found these relevant memories from earlier work in this repository:"; + +export const USER_SEARCH_TOOL_DESCRIPTION = `Search memories from earlier work. Use it ${SEARCH_WHEN}.`; +export const USER_SEARCH_QUERY_DESCRIPTION = "A direct question about earlier work."; +export const USER_RECALL_HEADING = "Mem0 found these relevant memories from earlier work:"; diff --git a/integrations/agent-plugin-core/typescript/tests/prompts.test.ts b/integrations/agent-plugin-core/typescript/tests/prompts.test.ts new file mode 100644 index 000000000..3090c1d51 --- /dev/null +++ b/integrations/agent-plugin-core/typescript/tests/prompts.test.ts @@ -0,0 +1,31 @@ +import assert from "node:assert/strict"; +import { readFileSync } from "node:fs"; +import test from "node:test"; + +import { buildRecallContext } from "../src/lifecycle.ts"; +import { + RECALL_HEADING, + SEARCH_QUERY_DESCRIPTION, + SEARCH_TOOL_DESCRIPTION, + USER_RECALL_HEADING, +} from "../src/prompts.ts"; + +const pythonSource = (name: string) => + readFileSync(new URL(`../../python/${name}`, import.meta.url), "utf8").replace(/"\s*\n\s*"/g, ""); + +test("search prompts match the Python core", () => { + assert.ok(pythonSource("mcp_server.py").includes(SEARCH_TOOL_DESCRIPTION)); + assert.ok(pythonSource("mcp_server.py").includes(SEARCH_QUERY_DESCRIPTION)); + assert.ok(pythonSource("hook_runner.py").includes(RECALL_HEADING)); +}); + +test("recall context uses the repository heading unless the host overrides it", async () => { + const search = async () => ({ results: [{ id: "m1", memory: "Use pnpm" }] }); + + assert.ok((await buildRecallContext("package manager", true, search)).includes(RECALL_HEADING)); + assert.ok( + (await buildRecallContext("package manager", true, search, { heading: USER_RECALL_HEADING })).includes( + USER_RECALL_HEADING, + ), + ); +}); diff --git a/integrations/antigravity-plugin/core/mcp_server.py b/integrations/antigravity-plugin/core/mcp_server.py index 036fbbdc9..a0b73cb79 100644 --- a/integrations/antigravity-plugin/core/mcp_server.py +++ b/integrations/antigravity-plugin/core/mcp_server.py @@ -21,16 +21,9 @@ from memory_core import ( PROTOCOL_VERSION = "2024-11-05" TOOL_NAME = "search_memories" TOOL_DESCRIPTION = ( - "Search memories from earlier work in this repository. ALWAYS call this " - "tool before answering anything that could depend on prior context: the " - "user's preferences, facts about this codebase, history, people, projects, " - "or earlier decisions. Do not rely on the chat window alone. The " - "repository's memory is shared by everyone who works in it and includes " - "what it took to run, test, or build here, so search before assuming an " - "invocation works. The scope argument changes what is searched: 'repo' " - "(default) is the whole repository's shared memory plus your own " - "preferences, 'dir' narrows the shared part to the directory you are " - "working in, and 'mine' is your preferences alone." + "Search memories from earlier work in this repository. Use it before " + "repeating investigation or when earlier decisions, fixes, commands, or " + "results may help." ) TOOL_SCHEMA = { "type": "object", diff --git a/integrations/antigravity-plugin/core/memory_core.py b/integrations/antigravity-plugin/core/memory_core.py index ea2670dac..9b420a063 100644 --- a/integrations/antigravity-plugin/core/memory_core.py +++ b/integrations/antigravity-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.2" +PLUGIN_VERSION = "0.3.3" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" @@ -71,15 +71,13 @@ MAX_FLUSH_ATTEMPTS = 5 FORGET_PAGE_SIZE = 100 FORGET_MAX_PAGES = 50 -PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help anyone with future coding work in this repository. +PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help with future coding work. A completed change should produce one memory explaining the resulting behavior, where it is implemented when useful, and any important constraints or reasoning. Exploration or accepted decisions may produce separate memories only when they are independently useful. -A command that failed and was then made to work should produce one memory naming the failing invocation, the error it returned, and the invocation that succeeded. Do not save one-off errors caused by an edit still in progress, transient network failures, or anything a rerun would fix on its own. +Use the coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. -Use the current coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. - -Write about the repository, not the user, assistant, session, or task. Do not save personal preferences. Do not save a memory that only states which repository, branch, or directory the session worked in. Do not include test results, documentation updates, release notes, or temporary state. +Write about the repository, not the user, assistant, session, or task. Do not include test results, documentation updates, release notes, or temporary state. If nothing useful was established, return no memories.""" diff --git a/integrations/antigravity-plugin/plugin-build.json b/integrations/antigravity-plugin/plugin-build.json index 43b90d8cb..5a9112025 100644 --- a/integrations/antigravity-plugin/plugin-build.json +++ b/integrations/antigravity-plugin/plugin-build.json @@ -1,6 +1,6 @@ { "id": "mem0", - "version": "0.3.2", + "version": "0.3.3", "homepage": "https://docs.mem0.ai/integrations/antigravity", "native": { "pluginRoot": "${ANTIGRAVITY_PLUGIN_ROOT}", diff --git a/integrations/antigravity-plugin/skills/search/SKILL.md b/integrations/antigravity-plugin/skills/search/SKILL.md index 7a6af05fa..530a70a86 100644 --- a/integrations/antigravity-plugin/skills/search/SKILL.md +++ b/integrations/antigravity-plugin/skills/search/SKILL.md @@ -12,11 +12,9 @@ Call `search_memories` with the user's question. Treat `--top-k`, `--category`, query. Omit `top_k` to use Mem0's configured default. Omit `category` to search every -category; a category is a best-effort label Mem0 assigned when it saved the -memory, so if a category search misses, repeat it without the category. Omit -`scope` to use the configured default, normally `repo`: this repository's -shared memory, which everyone who works in it contributes to, plus your own -preferences. +category. Omit `scope` to use the configured default, normally `repo`: this +repository's shared memory, which everyone who works in it contributes to, +plus your own preferences. Pass `scope` when the question needs something else: `dir` to narrow the shared memory to the directory you are working in (a package inside a diff --git a/integrations/claude-code-plugin/.claude-plugin/plugin.json b/integrations/claude-code-plugin/.claude-plugin/plugin.json index 0dd8298e9..8182b49dc 100644 --- a/integrations/claude-code-plugin/.claude-plugin/plugin.json +++ b/integrations/claude-code-plugin/.claude-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "mem0", - "version": "0.3.2", + "version": "0.3.3", "description": "Cross-session memory and token savings for coding agents.", "author": { "name": "Mem0" diff --git a/integrations/claude-code-plugin/agents/sidekick.md b/integrations/claude-code-plugin/agents/sidekick.md index d0552c0c3..8f719327a 100644 --- a/integrations/claude-code-plugin/agents/sidekick.md +++ b/integrations/claude-code-plugin/agents/sidekick.md @@ -12,11 +12,8 @@ You are Mem0's Sonnet coding agent. Complete the work the main agent gives you. Work in the separate Git worktree Claude Code created for you. Return a tested result that the main agent can review without doing the same work again. -ALWAYS call `search_memories` before answering anything that could depend on -prior context (the user's preferences, facts about this codebase, history, -people, projects, or earlier decisions). Do not rely on the chat window or -assume you know enough from the current conversation. Search with a focused -question before investigating the repository. +When memories from earlier sessions could help, call `search_memories` with a +focused question before searching the repository again. Inspect the relevant code and repository rules. Reproduce the problem when that helps. Decide the implementation details, edit files when asked, and test the diff --git a/integrations/claude-code-plugin/core/mcp_server.py b/integrations/claude-code-plugin/core/mcp_server.py index 036fbbdc9..a0b73cb79 100644 --- a/integrations/claude-code-plugin/core/mcp_server.py +++ b/integrations/claude-code-plugin/core/mcp_server.py @@ -21,16 +21,9 @@ from memory_core import ( PROTOCOL_VERSION = "2024-11-05" TOOL_NAME = "search_memories" TOOL_DESCRIPTION = ( - "Search memories from earlier work in this repository. ALWAYS call this " - "tool before answering anything that could depend on prior context: the " - "user's preferences, facts about this codebase, history, people, projects, " - "or earlier decisions. Do not rely on the chat window alone. The " - "repository's memory is shared by everyone who works in it and includes " - "what it took to run, test, or build here, so search before assuming an " - "invocation works. The scope argument changes what is searched: 'repo' " - "(default) is the whole repository's shared memory plus your own " - "preferences, 'dir' narrows the shared part to the directory you are " - "working in, and 'mine' is your preferences alone." + "Search memories from earlier work in this repository. Use it before " + "repeating investigation or when earlier decisions, fixes, commands, or " + "results may help." ) TOOL_SCHEMA = { "type": "object", diff --git a/integrations/claude-code-plugin/core/memory_core.py b/integrations/claude-code-plugin/core/memory_core.py index ea2670dac..9b420a063 100644 --- a/integrations/claude-code-plugin/core/memory_core.py +++ b/integrations/claude-code-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.2" +PLUGIN_VERSION = "0.3.3" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" @@ -71,15 +71,13 @@ MAX_FLUSH_ATTEMPTS = 5 FORGET_PAGE_SIZE = 100 FORGET_MAX_PAGES = 50 -PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help anyone with future coding work in this repository. +PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help with future coding work. A completed change should produce one memory explaining the resulting behavior, where it is implemented when useful, and any important constraints or reasoning. Exploration or accepted decisions may produce separate memories only when they are independently useful. -A command that failed and was then made to work should produce one memory naming the failing invocation, the error it returned, and the invocation that succeeded. Do not save one-off errors caused by an edit still in progress, transient network failures, or anything a rerun would fix on its own. +Use the coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. -Use the current coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. - -Write about the repository, not the user, assistant, session, or task. Do not save personal preferences. Do not save a memory that only states which repository, branch, or directory the session worked in. Do not include test results, documentation updates, release notes, or temporary state. +Write about the repository, not the user, assistant, session, or task. Do not include test results, documentation updates, release notes, or temporary state. If nothing useful was established, return no memories.""" diff --git a/integrations/claude-code-plugin/plugin-build.json b/integrations/claude-code-plugin/plugin-build.json index 4b98c2919..d62d653c3 100644 --- a/integrations/claude-code-plugin/plugin-build.json +++ b/integrations/claude-code-plugin/plugin-build.json @@ -1,6 +1,6 @@ { "id": "mem0", - "version": "0.3.2", + "version": "0.3.3", "homepage": "https://docs.mem0.ai/integrations/claude-code", "native": { "pluginRoot": "${CLAUDE_PLUGIN_ROOT}", diff --git a/integrations/claude-code-plugin/skills/search/SKILL.md b/integrations/claude-code-plugin/skills/search/SKILL.md index 198a1f023..f7289b91d 100644 --- a/integrations/claude-code-plugin/skills/search/SKILL.md +++ b/integrations/claude-code-plugin/skills/search/SKILL.md @@ -12,11 +12,9 @@ Call `search_memories` with the user's question. Treat `--top-k`, `--category`, query. Omit `top_k` to use Mem0's configured default. Omit `category` to search every -category; a category is a best-effort label Mem0 assigned when it saved the -memory, so if a category search misses, repeat it without the category. Omit -`scope` to use the configured default, normally `repo`: this repository's -shared memory, which everyone who works in it contributes to, plus your own -preferences. +category. Omit `scope` to use the configured default, normally `repo`: this +repository's shared memory, which everyone who works in it contributes to, +plus your own preferences. Pass `scope` when the question needs something else: `dir` to narrow the shared memory to the directory you are working in (a package inside a diff --git a/integrations/claude-code-plugin/tests/test_memory_core.py b/integrations/claude-code-plugin/tests/test_memory_core.py index 9aea939cf..b6b1c28f9 100644 --- a/integrations/claude-code-plugin/tests/test_memory_core.py +++ b/integrations/claude-code-plugin/tests/test_memory_core.py @@ -1,8 +1,8 @@ from __future__ import annotations import json -import re import os +import re import sqlite3 import subprocess import sys @@ -2307,8 +2307,8 @@ def test_sidekick_instructions_reject_unrequested_related_changes(): prompt = (PLUGIN_ROOT / "agents" / "sidekick.md").read_text() normalized = " ".join(prompt.split()) assert "Skill" in prompt.split("---", 2)[1] - assert "ALWAYS call `search_memories` before answering anything" in normalized - assert "Do not rely on the chat window" in normalized + assert "call `search_memories` with a" in normalized + assert "focused question before searching the repository again" in normalized assert "Complete only the work the main agent assigned" in normalized assert "Do not make related improvements" in normalized assert "report them separately" in normalized @@ -4333,7 +4333,7 @@ def test_flush_sends_unified_body_with_both_agent_and_user_id(isolated_env, monk assert sent_body["run_id"] == "s1" assert "lane" not in sent_body["metadata"] assert "Save concise repository facts" in sent_body["agent_custom_instructions"] - assert "invocation that succeeded" in sent_body["agent_custom_instructions"] + assert "Write about the repository, not the user" in sent_body["agent_custom_instructions"] assert "Do not save repository facts" in sent_body["custom_instructions"] assert sent_body["custom_categories"] == memory_core.CODING_MEMORY_CATEGORIES store.close() diff --git a/integrations/codex-plugin/.codex-plugin/plugin.json b/integrations/codex-plugin/.codex-plugin/plugin.json index 0a80bf9e3..e91eca25a 100644 --- a/integrations/codex-plugin/.codex-plugin/plugin.json +++ b/integrations/codex-plugin/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "mem0", - "version": "0.3.2", + "version": "0.3.3", "description": "Cross-session memory and token savings for coding agents.", "author": { "name": "Mem0", "email": "support@mem0.ai" }, "homepage": "https://docs.mem0.ai/integrations/codex", diff --git a/integrations/codex-plugin/core/mcp_server.py b/integrations/codex-plugin/core/mcp_server.py index 036fbbdc9..a0b73cb79 100644 --- a/integrations/codex-plugin/core/mcp_server.py +++ b/integrations/codex-plugin/core/mcp_server.py @@ -21,16 +21,9 @@ from memory_core import ( PROTOCOL_VERSION = "2024-11-05" TOOL_NAME = "search_memories" TOOL_DESCRIPTION = ( - "Search memories from earlier work in this repository. ALWAYS call this " - "tool before answering anything that could depend on prior context: the " - "user's preferences, facts about this codebase, history, people, projects, " - "or earlier decisions. Do not rely on the chat window alone. The " - "repository's memory is shared by everyone who works in it and includes " - "what it took to run, test, or build here, so search before assuming an " - "invocation works. The scope argument changes what is searched: 'repo' " - "(default) is the whole repository's shared memory plus your own " - "preferences, 'dir' narrows the shared part to the directory you are " - "working in, and 'mine' is your preferences alone." + "Search memories from earlier work in this repository. Use it before " + "repeating investigation or when earlier decisions, fixes, commands, or " + "results may help." ) TOOL_SCHEMA = { "type": "object", diff --git a/integrations/codex-plugin/core/memory_core.py b/integrations/codex-plugin/core/memory_core.py index ea2670dac..9b420a063 100644 --- a/integrations/codex-plugin/core/memory_core.py +++ b/integrations/codex-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.2" +PLUGIN_VERSION = "0.3.3" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" @@ -71,15 +71,13 @@ MAX_FLUSH_ATTEMPTS = 5 FORGET_PAGE_SIZE = 100 FORGET_MAX_PAGES = 50 -PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help anyone with future coding work in this repository. +PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help with future coding work. A completed change should produce one memory explaining the resulting behavior, where it is implemented when useful, and any important constraints or reasoning. Exploration or accepted decisions may produce separate memories only when they are independently useful. -A command that failed and was then made to work should produce one memory naming the failing invocation, the error it returned, and the invocation that succeeded. Do not save one-off errors caused by an edit still in progress, transient network failures, or anything a rerun would fix on its own. +Use the coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. -Use the current coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. - -Write about the repository, not the user, assistant, session, or task. Do not save personal preferences. Do not save a memory that only states which repository, branch, or directory the session worked in. Do not include test results, documentation updates, release notes, or temporary state. +Write about the repository, not the user, assistant, session, or task. Do not include test results, documentation updates, release notes, or temporary state. If nothing useful was established, return no memories.""" diff --git a/integrations/codex-plugin/plugin-build.json b/integrations/codex-plugin/plugin-build.json index 7f5fc94f6..a354c31f5 100644 --- a/integrations/codex-plugin/plugin-build.json +++ b/integrations/codex-plugin/plugin-build.json @@ -1,6 +1,6 @@ { "id": "mem0", - "version": "0.3.2", + "version": "0.3.3", "homepage": "https://docs.mem0.ai/integrations/codex", "native": { "pluginRoot": "${PLUGIN_ROOT}", diff --git a/integrations/codex-plugin/skills/search/SKILL.md b/integrations/codex-plugin/skills/search/SKILL.md index f6c27b19c..90f435008 100644 --- a/integrations/codex-plugin/skills/search/SKILL.md +++ b/integrations/codex-plugin/skills/search/SKILL.md @@ -12,11 +12,9 @@ Call `search_memories` with the user's question. Treat `--top-k`, `--category`, query. Omit `top_k` to use Mem0's configured default. Omit `category` to search every -category; a category is a best-effort label Mem0 assigned when it saved the -memory, so if a category search misses, repeat it without the category. Omit -`scope` to use the configured default, normally `repo`: this repository's -shared memory, which everyone who works in it contributes to, plus your own -preferences. +category. Omit `scope` to use the configured default, normally `repo`: this +repository's shared memory, which everyone who works in it contributes to, +plus your own preferences. Pass `scope` when the question needs something else: `dir` to narrow the shared memory to the directory you are working in (a package inside a diff --git a/integrations/cursor-plugin/.cursor-plugin/plugin.json b/integrations/cursor-plugin/.cursor-plugin/plugin.json index a30f9ad9a..7c2304f29 100644 --- a/integrations/cursor-plugin/.cursor-plugin/plugin.json +++ b/integrations/cursor-plugin/.cursor-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "mem0", - "version": "0.3.2", + "version": "0.3.3", "description": "Cross-session memory and token savings for coding agents.", "author": { "name": "Mem0", "email": "support@mem0.ai" }, "homepage": "https://docs.mem0.ai/integrations/cursor", diff --git a/integrations/cursor-plugin/core/mcp_server.py b/integrations/cursor-plugin/core/mcp_server.py index 036fbbdc9..a0b73cb79 100644 --- a/integrations/cursor-plugin/core/mcp_server.py +++ b/integrations/cursor-plugin/core/mcp_server.py @@ -21,16 +21,9 @@ from memory_core import ( PROTOCOL_VERSION = "2024-11-05" TOOL_NAME = "search_memories" TOOL_DESCRIPTION = ( - "Search memories from earlier work in this repository. ALWAYS call this " - "tool before answering anything that could depend on prior context: the " - "user's preferences, facts about this codebase, history, people, projects, " - "or earlier decisions. Do not rely on the chat window alone. The " - "repository's memory is shared by everyone who works in it and includes " - "what it took to run, test, or build here, so search before assuming an " - "invocation works. The scope argument changes what is searched: 'repo' " - "(default) is the whole repository's shared memory plus your own " - "preferences, 'dir' narrows the shared part to the directory you are " - "working in, and 'mine' is your preferences alone." + "Search memories from earlier work in this repository. Use it before " + "repeating investigation or when earlier decisions, fixes, commands, or " + "results may help." ) TOOL_SCHEMA = { "type": "object", diff --git a/integrations/cursor-plugin/core/memory_core.py b/integrations/cursor-plugin/core/memory_core.py index ea2670dac..9b420a063 100644 --- a/integrations/cursor-plugin/core/memory_core.py +++ b/integrations/cursor-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.2" +PLUGIN_VERSION = "0.3.3" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" @@ -71,15 +71,13 @@ MAX_FLUSH_ATTEMPTS = 5 FORGET_PAGE_SIZE = 100 FORGET_MAX_PAGES = 50 -PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help anyone with future coding work in this repository. +PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help with future coding work. A completed change should produce one memory explaining the resulting behavior, where it is implemented when useful, and any important constraints or reasoning. Exploration or accepted decisions may produce separate memories only when they are independently useful. -A command that failed and was then made to work should produce one memory naming the failing invocation, the error it returned, and the invocation that succeeded. Do not save one-off errors caused by an edit still in progress, transient network failures, or anything a rerun would fix on its own. +Use the coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. -Use the current coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. - -Write about the repository, not the user, assistant, session, or task. Do not save personal preferences. Do not save a memory that only states which repository, branch, or directory the session worked in. Do not include test results, documentation updates, release notes, or temporary state. +Write about the repository, not the user, assistant, session, or task. Do not include test results, documentation updates, release notes, or temporary state. If nothing useful was established, return no memories.""" diff --git a/integrations/cursor-plugin/plugin-build.json b/integrations/cursor-plugin/plugin-build.json index 30024586e..5320fb7f9 100644 --- a/integrations/cursor-plugin/plugin-build.json +++ b/integrations/cursor-plugin/plugin-build.json @@ -1,6 +1,6 @@ { "id": "mem0", - "version": "0.3.2", + "version": "0.3.3", "homepage": "https://docs.mem0.ai/integrations/cursor", "native": { "pluginRoot": "${CURSOR_PLUGIN_ROOT}", diff --git a/integrations/cursor-plugin/skills/search/SKILL.md b/integrations/cursor-plugin/skills/search/SKILL.md index 7a7ddfa90..2e3bde6a7 100644 --- a/integrations/cursor-plugin/skills/search/SKILL.md +++ b/integrations/cursor-plugin/skills/search/SKILL.md @@ -12,11 +12,9 @@ Call `search_memories` with the user's question. Treat `--top-k`, `--category`, query. Omit `top_k` to use Mem0's configured default. Omit `category` to search every -category; a category is a best-effort label Mem0 assigned when it saved the -memory, so if a category search misses, repeat it without the category. Omit -`scope` to use the configured default, normally `repo`: this repository's -shared memory, which everyone who works in it contributes to, plus your own -preferences. +category. Omit `scope` to use the configured default, normally `repo`: this +repository's shared memory, which everyone who works in it contributes to, +plus your own preferences. Pass `scope` when the question needs something else: `dir` to narrow the shared memory to the directory you are working in (a package inside a diff --git a/integrations/deepseek-plugin/package.json b/integrations/deepseek-plugin/package.json index 2df84283c..41a8fe7a5 100644 --- a/integrations/deepseek-plugin/package.json +++ b/integrations/deepseek-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/deepseek-plugin", - "version": "0.3.1", + "version": "0.3.2", "description": "Mem0 long-term memory as a native DeepSeek Harness (Cordis) plugin.", "type": "module", "license": "Apache-2.0", diff --git a/integrations/deepseek-plugin/src/index.ts b/integrations/deepseek-plugin/src/index.ts index 3ac86f4b0..c5eb64390 100644 --- a/integrations/deepseek-plugin/src/index.ts +++ b/integrations/deepseek-plugin/src/index.ts @@ -21,6 +21,11 @@ import { truncateOutput } from "./output.ts"; import { resolveSearchFilters, resolveAddParams } from "./scoping.ts"; import { captureEvent, errorKind } from "./telemetry.ts"; import { createMemoryLifecycle } from "../../agent-plugin-core/typescript/src/lifecycle.ts"; +import { + USER_RECALL_HEADING, + USER_SEARCH_QUERY_DESCRIPTION, + USER_SEARCH_TOOL_DESCRIPTION, +} from "../../agent-plugin-core/typescript/src/prompts.ts"; export const name = "mem0"; export const inject = ["tools", "systemPrompt"]; @@ -107,7 +112,7 @@ export function apply(ctx: Context, config: Config): void { const stateFor = (session: object): SessionState => { let state = sessionStates.get(session); if (!state) { - const lifecycle = createMemoryLifecycle(); + const lifecycle = createMemoryLifecycle({ recallHeading: USER_RECALL_HEADING }); lifecycle.beginSession(); state = { lifecycle, messages: [] }; sessionStates.set(session, state); @@ -197,10 +202,9 @@ export function apply(ctx: Context, config: Config): void { ctx.tools.register( defineTool({ name: "search_memory", - description: - "Search the user's long-term Mem0 memory for facts relevant to a query. Use proactively before answering anything that may depend on what the user told you earlier.", + description: USER_SEARCH_TOOL_DESCRIPTION, parameters: { - query: { type: "string", description: "What to recall.", required: true }, + query: { type: "string", description: USER_SEARCH_QUERY_DESCRIPTION, required: true }, limit: { type: "integer", description: `Max results to return (default ${DEFAULT_SEARCH_LIMIT}).`, diff --git a/integrations/kimi-plugin/core/mcp_server.py b/integrations/kimi-plugin/core/mcp_server.py index 036fbbdc9..a0b73cb79 100644 --- a/integrations/kimi-plugin/core/mcp_server.py +++ b/integrations/kimi-plugin/core/mcp_server.py @@ -21,16 +21,9 @@ from memory_core import ( PROTOCOL_VERSION = "2024-11-05" TOOL_NAME = "search_memories" TOOL_DESCRIPTION = ( - "Search memories from earlier work in this repository. ALWAYS call this " - "tool before answering anything that could depend on prior context: the " - "user's preferences, facts about this codebase, history, people, projects, " - "or earlier decisions. Do not rely on the chat window alone. The " - "repository's memory is shared by everyone who works in it and includes " - "what it took to run, test, or build here, so search before assuming an " - "invocation works. The scope argument changes what is searched: 'repo' " - "(default) is the whole repository's shared memory plus your own " - "preferences, 'dir' narrows the shared part to the directory you are " - "working in, and 'mine' is your preferences alone." + "Search memories from earlier work in this repository. Use it before " + "repeating investigation or when earlier decisions, fixes, commands, or " + "results may help." ) TOOL_SCHEMA = { "type": "object", diff --git a/integrations/kimi-plugin/core/memory_core.py b/integrations/kimi-plugin/core/memory_core.py index ea2670dac..9b420a063 100644 --- a/integrations/kimi-plugin/core/memory_core.py +++ b/integrations/kimi-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.2" +PLUGIN_VERSION = "0.3.3" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" @@ -71,15 +71,13 @@ MAX_FLUSH_ATTEMPTS = 5 FORGET_PAGE_SIZE = 100 FORGET_MAX_PAGES = 50 -PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help anyone with future coding work in this repository. +PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help with future coding work. A completed change should produce one memory explaining the resulting behavior, where it is implemented when useful, and any important constraints or reasoning. Exploration or accepted decisions may produce separate memories only when they are independently useful. -A command that failed and was then made to work should produce one memory naming the failing invocation, the error it returned, and the invocation that succeeded. Do not save one-off errors caused by an edit still in progress, transient network failures, or anything a rerun would fix on its own. +Use the coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. -Use the current coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. - -Write about the repository, not the user, assistant, session, or task. Do not save personal preferences. Do not save a memory that only states which repository, branch, or directory the session worked in. Do not include test results, documentation updates, release notes, or temporary state. +Write about the repository, not the user, assistant, session, or task. Do not include test results, documentation updates, release notes, or temporary state. If nothing useful was established, return no memories.""" diff --git a/integrations/kimi-plugin/kimi.plugin.json b/integrations/kimi-plugin/kimi.plugin.json index e58bec328..6b28575d3 100644 --- a/integrations/kimi-plugin/kimi.plugin.json +++ b/integrations/kimi-plugin/kimi.plugin.json @@ -1,6 +1,6 @@ { "name": "mem0", - "version": "0.3.2", + "version": "0.3.3", "description": "Cross-session memory and token savings for coding agents.", "keywords": ["memory", "coding-agents", "continual-learning", "token-efficiency"], "author": { "name": "Mem0", "email": "support@mem0.ai" }, diff --git a/integrations/kimi-plugin/plugin-build.json b/integrations/kimi-plugin/plugin-build.json index e73643eab..35e38ecf5 100644 --- a/integrations/kimi-plugin/plugin-build.json +++ b/integrations/kimi-plugin/plugin-build.json @@ -1,6 +1,6 @@ { "id": "mem0", - "version": "0.3.2", + "version": "0.3.3", "homepage": "https://docs.mem0.ai/integrations/kimi", "native": { "pluginRoot": "${KIMI_PLUGIN_ROOT}", diff --git a/integrations/kimi-plugin/skills/search/SKILL.md b/integrations/kimi-plugin/skills/search/SKILL.md index eb92a6ca8..316b78e53 100644 --- a/integrations/kimi-plugin/skills/search/SKILL.md +++ b/integrations/kimi-plugin/skills/search/SKILL.md @@ -12,11 +12,9 @@ Call `search_memories` with the user's question. Treat `--top-k`, `--category`, query. Omit `top_k` to use Mem0's configured default. Omit `category` to search every -category; a category is a best-effort label Mem0 assigned when it saved the -memory, so if a category search misses, repeat it without the category. Omit -`scope` to use the configured default, normally `repo`: this repository's -shared memory, which everyone who works in it contributes to, plus your own -preferences. +category. Omit `scope` to use the configured default, normally `repo`: this +repository's shared memory, which everyone who works in it contributes to, +plus your own preferences. Pass `scope` when the question needs something else: `dir` to narrow the shared memory to the directory you are working in (a package inside a diff --git a/integrations/mem0-agent-plugin/core/mcp_server.py b/integrations/mem0-agent-plugin/core/mcp_server.py index 036fbbdc9..a0b73cb79 100644 --- a/integrations/mem0-agent-plugin/core/mcp_server.py +++ b/integrations/mem0-agent-plugin/core/mcp_server.py @@ -21,16 +21,9 @@ from memory_core import ( PROTOCOL_VERSION = "2024-11-05" TOOL_NAME = "search_memories" TOOL_DESCRIPTION = ( - "Search memories from earlier work in this repository. ALWAYS call this " - "tool before answering anything that could depend on prior context: the " - "user's preferences, facts about this codebase, history, people, projects, " - "or earlier decisions. Do not rely on the chat window alone. The " - "repository's memory is shared by everyone who works in it and includes " - "what it took to run, test, or build here, so search before assuming an " - "invocation works. The scope argument changes what is searched: 'repo' " - "(default) is the whole repository's shared memory plus your own " - "preferences, 'dir' narrows the shared part to the directory you are " - "working in, and 'mine' is your preferences alone." + "Search memories from earlier work in this repository. Use it before " + "repeating investigation or when earlier decisions, fixes, commands, or " + "results may help." ) TOOL_SCHEMA = { "type": "object", diff --git a/integrations/mem0-agent-plugin/core/memory_core.py b/integrations/mem0-agent-plugin/core/memory_core.py index ea2670dac..9b420a063 100644 --- a/integrations/mem0-agent-plugin/core/memory_core.py +++ b/integrations/mem0-agent-plugin/core/memory_core.py @@ -29,7 +29,7 @@ from typing import Any, Iterable import telemetry DEFAULT_API_URL = "https://api.mem0.ai" -PLUGIN_VERSION = "0.3.2" +PLUGIN_VERSION = "0.3.3" _harness_name: str = "generic" _harness_env_prefix: str = "MEM0_PLUGIN" @@ -71,15 +71,13 @@ MAX_FLUSH_ATTEMPTS = 5 FORGET_PAGE_SIZE = 100 FORGET_MAX_PAGES = 50 -PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help anyone with future coding work in this repository. +PROJECT_MEMORY_INSTRUCTIONS = """Save concise repository facts that will help with future coding work. A completed change should produce one memory explaining the resulting behavior, where it is implemented when useful, and any important constraints or reasoning. Exploration or accepted decisions may produce separate memories only when they are independently useful. -A command that failed and was then made to work should produce one memory naming the failing invocation, the error it returned, and the invocation that succeeded. Do not save one-off errors caused by an edit still in progress, transient network failures, or anything a rerun would fix on its own. +Use the coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. -Use the current coding agent's final response for conclusions about current repository behavior. Do not save proposed or recommended changes unless the user accepted them or the coding agent completed them. Treat subagent responses as supporting repository evidence, not as decisions. - -Write about the repository, not the user, assistant, session, or task. Do not save personal preferences. Do not save a memory that only states which repository, branch, or directory the session worked in. Do not include test results, documentation updates, release notes, or temporary state. +Write about the repository, not the user, assistant, session, or task. Do not include test results, documentation updates, release notes, or temporary state. If nothing useful was established, return no memories.""" diff --git a/integrations/mem0-agent-plugin/plugin.json b/integrations/mem0-agent-plugin/plugin.json index 7a2baba80..95ff54651 100644 --- a/integrations/mem0-agent-plugin/plugin.json +++ b/integrations/mem0-agent-plugin/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "mem0", - "version": "0.3.2", + "version": "0.3.3", "description": "Cross-session memory and token savings for coding agents.", "author": { "name": "Mem0", diff --git a/integrations/mem0-agent-plugin/skills/search/SKILL.md b/integrations/mem0-agent-plugin/skills/search/SKILL.md index d52c4ff34..bbd4eb535 100644 --- a/integrations/mem0-agent-plugin/skills/search/SKILL.md +++ b/integrations/mem0-agent-plugin/skills/search/SKILL.md @@ -10,11 +10,9 @@ Call `search_memories` with the user's question. Treat `--top-k`, `--category`, query. Omit `top_k` to use Mem0's configured default. Omit `category` to search every -category; a category is a best-effort label Mem0 assigned when it saved the -memory, so if a category search misses, repeat it without the category. Omit -`scope` to use the configured default, normally `repo`: this repository's -shared memory, which everyone who works in it contributes to, plus your own -preferences. +category. Omit `scope` to use the configured default, normally `repo`: this +repository's shared memory, which everyone who works in it contributes to, +plus your own preferences. Pass `scope` when the question needs something else: `dir` to narrow the shared memory to the directory you are working in (a package inside a diff --git a/integrations/openclaw/openclaw.plugin.json b/integrations/openclaw/openclaw.plugin.json index 9d4cacaf8..e3b299112 100644 --- a/integrations/openclaw/openclaw.plugin.json +++ b/integrations/openclaw/openclaw.plugin.json @@ -2,7 +2,7 @@ "id": "openclaw-mem0", "name": "Memory (Mem0)", "description": "Mem0 memory backend for OpenClaw — platform (mem0.ai cloud) or self-hosted open-source. Auto-recall and auto-capture are opt-in (disabled by default). Supports OpenAI, Anthropic, Ollama (fully local), Qdrant, and PGVector providers.", - "version": "1.2.0", + "version": "1.2.1", "kind": "memory", "skills": ["skills"], "commandAliases": [ diff --git a/integrations/openclaw/package.json b/integrations/openclaw/package.json index 49f49dbf4..39aaeb70e 100644 --- a/integrations/openclaw/package.json +++ b/integrations/openclaw/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/openclaw-mem0", - "version": "1.2.0", + "version": "1.2.1", "type": "module", "description": "Mem0 memory backend for OpenClaw — platform or self-hosted open-source", "license": "Apache-2.0", diff --git a/integrations/openclaw/tools/memory-search.ts b/integrations/openclaw/tools/memory-search.ts index 58ce8183a..51d2ebcfd 100644 --- a/integrations/openclaw/tools/memory-search.ts +++ b/integrations/openclaw/tools/memory-search.ts @@ -1,4 +1,5 @@ import { Type } from "@sinclair/typebox"; +import { USER_SEARCH_QUERY_DESCRIPTION, USER_SEARCH_TOOL_DESCRIPTION } from "../../agent-plugin-core/typescript/src/prompts.ts"; import type { MemoryItem, SearchOptions } from "../types.ts"; import type { ToolDeps } from "./index.ts"; @@ -8,9 +9,9 @@ export function createMemorySearchTool(deps: ToolDeps) { return { name: "memory_search", label: "Memory Search", - description: "Search long-term memories stored in Mem0 by semantic meaning. Use this proactively before answering when the request may depend on the user's past work, preferences, or decisions -- relevant memories are not always already in context. For multi-part or comparative questions, run several searches with different phrasings and combine the results rather than stopping after one (multi-hop).", + description: USER_SEARCH_TOOL_DESCRIPTION, parameters: Type.Object({ - query: Type.String({ description: "Search query" }), + query: Type.String({ description: USER_SEARCH_QUERY_DESCRIPTION }), limit: Type.Optional(Type.Number({ description: `Max results (default: ${cfg.topK})` })), userId: Type.Optional(Type.String({ description: "User ID to scope search" })), agentId: Type.Optional(Type.String({ description: "Agent ID to search a specific agent's memories" })), diff --git a/integrations/opencode-plugin/opencode-mem0.ts b/integrations/opencode-plugin/opencode-mem0.ts index 8dcf6d535..a86eab3af 100644 --- a/integrations/opencode-plugin/opencode-mem0.ts +++ b/integrations/opencode-plugin/opencode-mem0.ts @@ -18,6 +18,7 @@ import {asScope, scopeSearchFilters, scopeWriteParams, resolveDefaultScope, SCOP import {parseProjectFromRemote} from "./project"; import {resolveApiKey} from "./api-key"; import {createMemoryLifecycle} from "../agent-plugin-core/typescript/src/lifecycle.ts"; +import {SEARCH_QUERY_DESCRIPTION, SEARCH_TOOL_DESCRIPTION} from "../agent-plugin-core/typescript/src/prompts.ts"; async function getUserId(): Promise { if (process.env.MEM0_USER_ID) return process.env.MEM0_USER_ID; @@ -424,9 +425,9 @@ Identity context (resolved at plugin startup): }), search_memories: tool({ - description: "Search stored memories by semantic meaning. Use this proactively before answering when the request may depend on the user's past work, preferences, decisions, or environment -- relevant memories are not always auto-injected. For multi-part or comparative questions, run several searches with different phrasings and combine the results rather than stopping after one (multi-hop).", + description: SEARCH_TOOL_DESCRIPTION, args: { - query: tool.schema.string().describe("Search query"), + query: tool.schema.string().describe(SEARCH_QUERY_DESCRIPTION), user_id: tool.schema.string().optional().describe("User ID"), app_id: tool.schema.string().optional().describe("App/Project ID"), agent_id: tool.schema.string().optional().describe("Agent ID"), @@ -636,9 +637,6 @@ Identity context (resolved at plugin startup): } if (memoryCount > 0) { - systemContext.push( - "Search mem0 for recent decisions and task learnings before responding. Run 2 parallel searches: one for decision type, one for task_learning type.", - ); try { const res = await mem0.search( "recent session state decisions and learnings", @@ -659,9 +657,6 @@ Identity context (resolved at plugin startup): } } - systemContext.push( - "Mem0 searches apply when user references past work, decision questions, errors, or non-trivial tasks. Queries use noun-phrases, 2-4 parallel calls with different metadata.type filters, and include user_id + app_id.", - ); systemContext.push(SCOPE_GUIDANCE); const activeScope = loadDefaultScope(); if (activeScope !== "project") { diff --git a/integrations/opencode-plugin/opencode-skills/mem0-context-loader/SKILL.md b/integrations/opencode-plugin/opencode-skills/mem0-context-loader/SKILL.md index 803689076..b22f647dc 100644 --- a/integrations/opencode-plugin/opencode-skills/mem0-context-loader/SKILL.md +++ b/integrations/opencode-plugin/opencode-skills/mem0-context-loader/SKILL.md @@ -1,35 +1,19 @@ --- name: mem0-context-loader -description: Searches and injects relevant memories into context before starting work on a task. Use when beginning a new task, switching context, or when project history, past decisions, or coding conventions need to be loaded. +description: Search memories from earlier OpenCode sessions in this repository. Use it when earlier work may already explain the code, error, decision, or command you need, so you can avoid repeating file reads, searches, or experiments. --- # Context Loader Pre-fetches relevant memories to prime context before working on a task. -## When to use - -- Session start (invoke manually or auto-triggered by skill description matching) -- User starts work on a specific feature or file set -- Complex multi-step task begins -- User says "what do we know about X" or "context for X" - ## Steps 1. **Extract topics** from current message/task. Identify: file paths, module names, feature areas, error patterns. -2. **Run 2-4 parallel `search_memories` calls** with different angles: +2. **Call `search_memories` once** with a focused question about the task: `filters={"AND": [{"user_id": ""}, {"app_id": ""}]}`, `top_k=10`. - | Query angle | Filter | Purpose | - |---|---|---| - | Feature/module name | `{"AND": [{"user_id": ""}, {"app_id": ""}, {"metadata": {"type": "decision"}}]}` | Architecture decisions | - | File paths mentioned | `{"AND": [{"user_id": ""}, {"app_id": ""}, {"metadata": {"type": "convention"}}]}` | Coding patterns | - | Error keywords (if any) | `{"AND": [{"user_id": ""}, {"app_id": ""}, {"metadata": {"type": "anti_pattern"}}]}` | Known pitfalls | - | Broad project context | `{"AND": [{"user_id": ""}, {"app_id": ""}]}` | Catch-all | - -3. **Deduplicate** results by memory ID across all search responses. - -4. **Output compact context block** (max 10 memories): +3. **Output compact context block** (max 10 memories): ``` context-loader: loaded memories for "" @@ -38,7 +22,7 @@ context-loader: loaded memories for "" - [anti_pattern] [mem0:] ``` -5. If **zero results**: output nothing. Don't announce empty context. +4. If **zero results**: output nothing. Don't announce empty context. ## Constraints diff --git a/integrations/opencode-plugin/opencode-skills/mem0-search/SKILL.md b/integrations/opencode-plugin/opencode-skills/mem0-search/SKILL.md index ed3533991..e6b570d12 100644 --- a/integrations/opencode-plugin/opencode-skills/mem0-search/SKILL.md +++ b/integrations/opencode-plugin/opencode-skills/mem0-search/SKILL.md @@ -27,14 +27,11 @@ When an ID is detected: ### Step 2: Search -Run 2 parallel `search_memories` calls: - -1. Broad: `query=`, `filters={"AND": [{"user_id": ""}, {"app_id": ""}]}`, `top_k=10`, `rerank=true` -2. Targeted: `query=`, `filters={"AND": [{"user_id": ""}, {"app_id": ""}, {"metadata": {"type": "decision"}}]}`, `top_k=5`, `rerank=true` +Call `search_memories` once with the user's question: `query=`, `filters={"AND": [{"user_id": ""}, {"app_id": ""}]}`, `top_k=10`. ### Step 3: Display -Deduplicate by ID, then show compact results: +Show compact results: ``` ## mem0 search: "" ( results) diff --git a/integrations/opencode-plugin/package.json b/integrations/opencode-plugin/package.json index efcb60a28..36c3dce6b 100644 --- a/integrations/opencode-plugin/package.json +++ b/integrations/opencode-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/opencode-plugin", - "version": "0.4.0", + "version": "0.4.1", "type": "module", "description": "Mem0 persistent memory plugin for OpenCode — add, search, and manage memories across sessions", "main": "dist/index.js", diff --git a/integrations/pi-agent-plugin/README.md b/integrations/pi-agent-plugin/README.md index cb28d2314..3dc5b351b 100644 --- a/integrations/pi-agent-plugin/README.md +++ b/integrations/pi-agent-plugin/README.md @@ -71,7 +71,7 @@ The plugin includes 6 skills that guide the agent on how to use each capability: | Skill | Purpose | |-------|---------| -| `context-loader` | Pre-fetch relevant memories at session start | +| `context-loader` | Search memories when earlier work may already explain the task | | `remember` | Store facts with category classification | | `search` | Quick semantic search with compact results | | `forget` | Delete memories with confirmation | diff --git a/integrations/pi-agent-plugin/package.json b/integrations/pi-agent-plugin/package.json index 7ef9f822e..fbec4db1b 100644 --- a/integrations/pi-agent-plugin/package.json +++ b/integrations/pi-agent-plugin/package.json @@ -1,6 +1,6 @@ { "name": "@mem0/pi-agent-plugin", - "version": "0.3.1", + "version": "0.3.2", "type": "module", "description": "Mem0 memory extension for Pi Agent persistent, scoped, semantic memory across sessions and projects", "license": "Apache-2.0", diff --git a/integrations/pi-agent-plugin/skills/context-loader/SKILL.md b/integrations/pi-agent-plugin/skills/context-loader/SKILL.md index 22c10b2c8..616de9d02 100644 --- a/integrations/pi-agent-plugin/skills/context-loader/SKILL.md +++ b/integrations/pi-agent-plugin/skills/context-loader/SKILL.md @@ -1,34 +1,19 @@ --- name: context-loader -description: Searches and injects relevant memories into context before starting work on a task or topic. Use when beginning a new task, switching context, or when past decisions, preferences, or knowledge need to be loaded. +description: Search memories from earlier Pi sessions in this repository. Use it when earlier work may already explain the code, error, decision, or command you need, so you can avoid repeating file reads, searches, or experiments. --- # Context Loader Pre-fetches relevant memories to prime context before working on a task or topic. -## When to use - -- Session start (auto-triggered by the extension's `before_agent_start` event) -- User starts work on a specific topic or area -- User says "what do we know about X" or "context for X" - ## Steps 1. **Extract topics** from current message/task. Identify: subject areas, people mentioned, project names, goal references. -2. **Run 2-4 parallel searches** using `mem0_memory` tool with `action="search"` and different query angles: +2. **Call `mem0_memory` once** with `action="search"` and a focused question about the task. - | Query angle | Purpose | - |---|---| - | Topic/subject name | Relevant decisions and preferences | - | People mentioned | Relationship context | - | Project/goal references | Progress and background | - | Broad context | Catch-all for anything relevant | - -3. **Deduplicate** results by memory ID across all search responses. - -4. **Output compact context block** (max 10 memories): +3. **Output compact context block** (max 10 memories): ``` context-loader: loaded memories for "" @@ -37,7 +22,7 @@ context-loader: loaded memories for "" - [lessons] [mem0:] ``` -5. If **zero results**: output nothing. Don't announce empty context. +4. If **zero results**: output nothing. Don't announce empty context. ## Constraints diff --git a/integrations/pi-agent-plugin/src/memory/tools.ts b/integrations/pi-agent-plugin/src/memory/tools.ts index 96d8e9b3e..f6110a73f 100644 --- a/integrations/pi-agent-plugin/src/memory/tools.ts +++ b/integrations/pi-agent-plugin/src/memory/tools.ts @@ -1,4 +1,5 @@ import { resolveToolScope } from "../../../agent-plugin-core/typescript/src/scoping.ts"; +import { SEARCH_QUERY_DESCRIPTION, SEARCH_WHEN } from "../../../agent-plugin-core/typescript/src/prompts.ts"; import type { ExtensionAPI } from "@earendil-works/pi-coding-agent"; import { Type } from "typebox"; import { StringEnum } from "@earendil-works/pi-ai"; @@ -144,11 +145,10 @@ export function registerMemoryTool( name: "mem0_memory", label: "Mem0 Memory", description: - "Search, add, update, and manage persistent semantic memories powered by Mem0. Memories persist across sessions and devices. Use action \"search\" proactively -- before answering anything that may depend on what the user told you earlier -- and run multiple searches with different phrasings for multi-part questions. Output is truncated to 200 lines / 50KB.", + `Search, add, update, and manage persistent semantic memories powered by Mem0. Memories persist across sessions and devices. Use action "search" ${SEARCH_WHEN}. Output is truncated to 200 lines / 50KB.`, promptSnippet: "Semantic memory search and storage via Mem0", promptGuidelines: [ - 'Use mem0_memory with action "search" proactively whenever the request may depend on the user\'s past work, preferences, decisions, or environment -- not only when they explicitly mention the past', - 'For multi-part or comparative questions, run several searches with different phrasings and combine the results before answering -- one search is rarely enough', + `Use mem0_memory with action "search" ${SEARCH_WHEN}`, 'Use mem0_memory with action "add" to save important facts, preferences, goals, decisions, or lessons the user shares', 'Use mem0_memory with action "update" to modify an existing memory — requires memory_id and content. Preserves the memory ID', "Always use the default project scope unless the user EXPLICITLY asks to search across all projects — only after the user selects /mem0-scope global use scope \"global\"", @@ -166,13 +166,13 @@ export function registerMemoryTool( ] as const, { description: - "Memory operation to run: \"search\" (semantic recall -- use proactively before answering; run several with different phrasings for multi-part questions), \"add\" (save a new fact/preference/decision), \"get_all\" (list everything in scope, no query needed), \"update\" (replace an existing memory's text by id), \"delete\" (remove one memory by id), \"delete_all\" (wipe every memory in the scope -- destructive, only on explicit request).", + "Memory operation to run: \"search\" (semantic recall of earlier work in this repository), \"add\" (save a new fact/preference/decision), \"get_all\" (list everything in scope, no query needed), \"update\" (replace an existing memory's text by id), \"delete\" (remove one memory by id), \"delete_all\" (wipe every memory in the scope -- destructive, only on explicit request).", }, ), query: Type.Optional( Type.String({ description: - "Search text -- required for action \"search\". Use a focused noun-phrase; for multi-part questions run several searches with different phrasings.", + `Search text -- required for action "search". ${SEARCH_QUERY_DESCRIPTION}`, }), ), content: Type.Optional( diff --git a/integrations/pi-agent-plugin/src/prompt.ts b/integrations/pi-agent-plugin/src/prompt.ts index 83365239b..dd1137d35 100644 --- a/integrations/pi-agent-plugin/src/prompt.ts +++ b/integrations/pi-agent-plugin/src/prompt.ts @@ -1,10 +1,9 @@ -export const MEMORY_POLICY = ` -You have persistent semantic memory via the mem0_memory tool, powered by Mem0. Relevant memories may be auto-injected under , but that retrieval is shallow — treat it as a starting point, not the full picture. +import { SEARCH_WHEN } from "../../agent-plugin-core/typescript/src/prompts.ts"; -Be proactive about retrieval: -- Search memory BEFORE answering whenever the request could depend on the user's past work, preferences, decisions, environment, or anything they told you earlier — don't wait to be asked. -- Check memory before asking the user something they may have already told you. -- For multi-part, comparative, or "how did we…" questions, run SEVERAL searches with different phrasings and combine the results. One search is rarely enough — keep going until you have what you need (multi-hop). +export const MEMORY_POLICY = ` +You have persistent semantic memory via the mem0_memory tool, powered by Mem0. Relevant memories may be auto-injected under . + +Use mem0_memory with action "search" ${SEARCH_WHEN}. Be proactive about saving: - Save important facts, preferences, goals, decisions, lessons learned, identity, relationships, and routines the user shares. diff --git a/marketplace.json b/marketplace.json index b1608c958..ded2d2ece 100644 --- a/marketplace.json +++ b/marketplace.json @@ -13,7 +13,7 @@ }, "category": "Productivity", "description": "Cross-session memory and token savings for coding agents.", - "version": "0.3.2" + "version": "0.3.3" } ] } From 83b07b1537d688b9687bb116f8e0c6a9cabf2d95 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Wed, 23 Sep 2026 19:53:11 +0530 Subject: [PATCH 23/55] Fix grammar & typos: minor fixes across docs (#7423) Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs/components/embedders/models/together.mdx | 2 +- docs/components/vectordbs/dbs/azure.mdx | 2 +- docs/cookbooks/integrations/healthcare-google-adk.mdx | 2 +- docs/integrations/llama-index.mdx | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/components/embedders/models/together.mdx b/docs/components/embedders/models/together.mdx index 75f44227e..a71c1764a 100644 --- a/docs/components/embedders/models/together.mdx +++ b/docs/components/embedders/models/together.mdx @@ -11,7 +11,7 @@ To use Together embedding models, set the `TOGETHER_API_KEY` environment variabl The `embedding_model_dims` parameter for `vector_store` should be set to `1024` for Together embedder. -**Breaking default change.** The default Together embedding model is now `intfloat/multilingual-e5-large-instruct` (**1024-dim**), replacing the previous default `togethercomputer/m2-bert-80M-8k-retrieval` (**768-dim**). If you created a self-hosted vector store with the old default, its collection is 768-dim and will reject the new 1024-dim vectors **recreate/reindex the collection at 1024 dimensions** after upgrading. To defer the change, pin the previous values explicitly (`model="togethercomputer/m2-bert-80M-8k-retrieval"`, `embedding_dims=768`) note Together no longer lists this model among its recommended embeddings, so reindexing at 1024 is the durable path. +**Breaking default change.** The default Together embedding model is now `intfloat/multilingual-e5-large-instruct` (**1024-dim**), replacing the previous default `togethercomputer/m2-bert-80M-8k-retrieval` (**768-dim**). If you created a self-hosted vector store with the old default, its collection is 768-dim and will reject the new 1024-dim vectors — **recreate/reindex the collection at 1024 dimensions** after upgrading. To defer the change, pin the previous values explicitly (`model="togethercomputer/m2-bert-80M-8k-retrieval"`, `embedding_dims=768`) — note Together no longer lists this model among its recommended embeddings, so reindexing at 1024 is the durable path. diff --git a/docs/components/vectordbs/dbs/azure.mdx b/docs/components/vectordbs/dbs/azure.mdx index 93a0bf4ad..8577b50cc 100644 --- a/docs/components/vectordbs/dbs/azure.mdx +++ b/docs/components/vectordbs/dbs/azure.mdx @@ -95,7 +95,7 @@ Uses the identity from Azure PowerShell (`Connect-AzAccount`). 7. **Azure Developer CLI Credential:** Uses the session from Azure Developer CLI (`azd auth login`). - If an API is provided, it will be used for authentication over an Azure Identity + If an API key is provided, it will be used for authentication over an Azure Identity To enable Role-Based Access Control (RBAC) for Azure AI Search, follow these steps: 1. In the Azure Portal, navigate to your **Azure AI Search** service. diff --git a/docs/cookbooks/integrations/healthcare-google-adk.mdx b/docs/cookbooks/integrations/healthcare-google-adk.mdx index 0696f45e5..9c9571a66 100644 --- a/docs/cookbooks/integrations/healthcare-google-adk.mdx +++ b/docs/cookbooks/integrations/healthcare-google-adk.mdx @@ -30,7 +30,7 @@ pip install google-adk mem0ai python-dotenv ## Code Breakdown -Let's get started and understand the different components required in building a healthcare assistant powered by memory +Let's get started and understand the different components required in building a healthcare assistant powered by memory. ```python # Import dependencies diff --git a/docs/integrations/llama-index.mdx b/docs/integrations/llama-index.mdx index f2bc02491..d529937f6 100644 --- a/docs/integrations/llama-index.mdx +++ b/docs/integrations/llama-index.mdx @@ -45,7 +45,7 @@ memory_from_client = Mem0Memory.from_client( ) ``` -Context is used to identify the user, agent or the conversation in the Mem0. It is required to be passed in the at least one of the fields in the `Mem0Memory` constructor. It can be any of the following: +Context is used to identify the user, agent or the conversation in the Mem0. It is required to be passed in at least one of the fields in the `Mem0Memory` constructor. It can be any of the following: ```python context = { From 0cddc36d524ac6f54228e6355048adb936b436c3 Mon Sep 17 00:00:00 2001 From: Brennan <31714723+BCathcart@users.noreply.github.com> Date: Wed, 23 Sep 2026 10:02:04 -0700 Subject: [PATCH 24/55] Protect against None timestamps in Valkey layer (#6993) Signed-off-by: Brennan Cathcart --- mem0/vector_stores/valkey.py | 20 +++++--------------- tests/vector_stores/test_valkey.py | 26 ++++++++++++++++++++++++++ 2 files changed, 31 insertions(+), 15 deletions(-) diff --git a/mem0/vector_stores/valkey.py b/mem0/vector_stores/valkey.py index 0688a1288..189285539 100644 --- a/mem0/vector_stores/valkey.py +++ b/mem0/vector_stores/valkey.py @@ -299,13 +299,8 @@ class ValkeyDB(VectorStoreBase): # Create the key for the hash key = f"{self.prefix}:{id}" - # Check for required fields and provide defaults if missing - if "data" not in payload: - # Silently use default value for missing 'data' field - pass - - # Ensure created_at is present - if "created_at" not in payload: + # Default created_at when missing or None to current time + if not payload.get("created_at"): payload["created_at"] = datetime.now(pytz.timezone(self.timezone)).isoformat() # Prepare the hash data @@ -499,13 +494,8 @@ class ValkeyDB(VectorStoreBase): try: key = f"{self.prefix}:{vector_id}" - # Check for required fields and provide defaults if missing - if "data" not in payload: - # Silently use default value for missing 'data' field - pass - - # Ensure created_at is present - if "created_at" not in payload: + # Default created_at when missing or None to current time + if not payload.get("created_at"): payload["created_at"] = datetime.now(pytz.timezone(self.timezone)).isoformat() # Prepare the hash data @@ -521,7 +511,7 @@ class ValkeyDB(VectorStoreBase): hash_data["embedding"] = np.array(vector, dtype=np.float32).tobytes() # Add updated_at if available - if "updated_at" in payload: + if payload.get("updated_at"): hash_data["updated_at"] = int(datetime.fromisoformat(payload["updated_at"]).timestamp()) # Add optional fields diff --git a/tests/vector_stores/test_valkey.py b/tests/vector_stores/test_valkey.py index 769f511d4..b42a54848 100644 --- a/tests/vector_stores/test_valkey.py +++ b/tests/vector_stores/test_valkey.py @@ -158,6 +158,32 @@ def test_insert_handles_missing_created_at(valkey_db, mock_valkey_client): assert "created_at" in kwargs["mapping"] # Should be added automatically +def test_insert_and_update_with_none_timestamps(valkey_db, mock_valkey_client): + """Regression: a None timestamp must not crash insert() or update(). + + A None created_at falls back to now and a None updated_at is skipped, so + neither reaches fromisoformat() which only accepts a str. + """ + vector = np.random.rand(1536).tolist() + + valkey_db.insert( + vectors=[vector], + payloads=[{"hash": "h", "data": "d", "created_at": None, "updated_at": None}], + ids=["id1"], + ) + _, insert_kwargs = mock_valkey_client.hset.call_args + assert isinstance(insert_kwargs["mapping"]["created_at"], int) + + valkey_db.update( + vector_id="id1", + vector=vector, + payload={"hash": "h", "data": "d", "created_at": None, "updated_at": None}, + ) + _, update_kwargs = mock_valkey_client.hset.call_args + assert isinstance(update_kwargs["mapping"]["created_at"], int) + assert "updated_at" not in update_kwargs["mapping"] + + def test_delete(valkey_db, mock_valkey_client): """Test deleting a vector.""" # Call delete From ea9bbcabed98418a1800c104aade8975e6460a04 Mon Sep 17 00:00:00 2001 From: Karthik Date: Thu, 24 Sep 2026 00:11:22 +0530 Subject: [PATCH 25/55] =?UTF-8?q?feat(profiles):=20User=20Profiles=20v1=20?= =?UTF-8?q?=E2=80=94=20SDK=20methods=20+=20docs=20(#7340)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Pratik <10096516+pratikgajjar@users.noreply.github.com> Co-authored-by: Claude Opus 4.8 (1M context) --- .../profiles/generate-profiles.mdx | 5 + .../profiles/get-profile-job.mdx | 5 + .../profiles/get-profile-settings.mdx | 5 + docs/api-reference/profiles/get-profile.mdx | 5 + .../profiles/update-profile-settings.mdx | 5 + docs/changelog/sdk.mdx | 14 + docs/docs.json | 12 + docs/llms.txt | 6 + docs/openapi.json | 476 ++++++++++- docs/platform/features/user-profiles.mdx | 359 ++++++++ examples/notebooks/user-profiles.ipynb | 764 ++++++++++++++++++ mem0-ts/package.json | 2 +- mem0-ts/src/client/index.ts | 8 + mem0-ts/src/client/mem0.ts | 206 ++++- mem0-ts/src/client/mem0.types.ts | 95 +++ .../tests/memoryClient.profiles.test.ts | 341 ++++++++ mem0-ts/src/client/utils.ts | 3 + mem0/client/main.py | 384 ++++++++- pyproject.toml | 2 +- tests/test_client_profiles.py | 272 +++++++ 20 files changed, 2961 insertions(+), 8 deletions(-) create mode 100644 docs/api-reference/profiles/generate-profiles.mdx create mode 100644 docs/api-reference/profiles/get-profile-job.mdx create mode 100644 docs/api-reference/profiles/get-profile-settings.mdx create mode 100644 docs/api-reference/profiles/get-profile.mdx create mode 100644 docs/api-reference/profiles/update-profile-settings.mdx create mode 100644 docs/platform/features/user-profiles.mdx create mode 100644 examples/notebooks/user-profiles.ipynb create mode 100644 mem0-ts/src/client/tests/memoryClient.profiles.test.ts create mode 100644 tests/test_client_profiles.py diff --git a/docs/api-reference/profiles/generate-profiles.mdx b/docs/api-reference/profiles/generate-profiles.mdx new file mode 100644 index 000000000..e5de5a12d --- /dev/null +++ b/docs/api-reference/profiles/generate-profiles.mdx @@ -0,0 +1,5 @@ +--- +title: 'Generate Profiles' +description: "Start one generation: sample a few entities, or build one for a single entity." +openapi: post /v2/profiles/jobs/ +--- diff --git a/docs/api-reference/profiles/get-profile-job.mdx b/docs/api-reference/profiles/get-profile-job.mdx new file mode 100644 index 000000000..c24e86794 --- /dev/null +++ b/docs/api-reference/profiles/get-profile-job.mdx @@ -0,0 +1,5 @@ +--- +title: 'Get Generation Job' +description: "Read the progress of a generation, and whether it finished." +openapi: get /v2/profiles/jobs/{job_id}/ +--- diff --git a/docs/api-reference/profiles/get-profile-settings.mdx b/docs/api-reference/profiles/get-profile-settings.mdx new file mode 100644 index 000000000..82eb1b37b --- /dev/null +++ b/docs/api-reference/profiles/get-profile-settings.mdx @@ -0,0 +1,5 @@ +--- +title: 'Get Profile Settings' +description: "Retrieve the profile schema, custom instructions, and enabled flag for the current project." +openapi: get /v2/profiles/settings/ +--- diff --git a/docs/api-reference/profiles/get-profile.mdx b/docs/api-reference/profiles/get-profile.mdx new file mode 100644 index 000000000..604535a3c --- /dev/null +++ b/docs/api-reference/profiles/get-profile.mdx @@ -0,0 +1,5 @@ +--- +title: 'Get Profile' +description: "Retrieve the structured profile for a user, with a status describing whether generation has completed." +openapi: get /v2/entities/{entity_type}/{entity_id}/profile/ +--- diff --git a/docs/api-reference/profiles/update-profile-settings.mdx b/docs/api-reference/profiles/update-profile-settings.mdx new file mode 100644 index 000000000..e33dc9198 --- /dev/null +++ b/docs/api-reference/profiles/update-profile-settings.mdx @@ -0,0 +1,5 @@ +--- +title: 'Update Profile Settings' +description: "Set the JSON Schema, custom instructions, or enabled flag that control profile generation for the project." +openapi: post /v2/profiles/settings/ +--- diff --git a/docs/changelog/sdk.mdx b/docs/changelog/sdk.mdx index 008e58b9f..bf53c5d31 100644 --- a/docs/changelog/sdk.mdx +++ b/docs/changelog/sdk.mdx @@ -7,6 +7,13 @@ mode: "wide" + + +**New Features:** +- **Client:** Add User Profiles to `MemoryClient` and `AsyncMemoryClient`: `get_profile()`, `generate_profile()`, `get_profile_settings()`, `update_profile_settings()`, `sample_profiles()`, and `get_profile_job()`. A profile is a structured, always-current JSON summary of one user, shaped by a JSON Schema you configure per project and filled by an LLM from that user's memories. Generation is asynchronous. Every job POST carries an `Idempotency-Key`; to retry a lost request without starting a second job, pass the same `idempotency_key` on each attempt ([#7340](https://github.com/mem0ai/mem0/pull/7340)) + + + **Improvements:** @@ -1235,6 +1242,13 @@ See the [OSS v2 to v3 migration guide](https://docs.mem0.ai/migration/oss-v2-to- + + +**New Features:** +- **Client:** Add User Profiles to `MemoryClient`: `getProfile()`, `generateProfile()`, `getProfileSettings()`, `updateProfileSettings()`, `sampleProfiles()`, and `getProfileJob()`. A profile is a structured, always-current JSON summary of one user, shaped by a JSON Schema you configure per project and filled by an LLM from that user's memories. Generation is asynchronous. Every job POST carries an `Idempotency-Key`; to retry a lost request without starting a second job, pass the same `idempotencyKey` on each attempt ([#7340](https://github.com/mem0ai/mem0/pull/7340)) + + + **Improvements:** diff --git a/docs/docs.json b/docs/docs.json index 7aecc007c..969ebad35 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -72,6 +72,7 @@ "pages": [ "platform/features/v2-memory-filters", "platform/features/entity-scoped-memory", + "platform/features/user-profiles", "platform/features/graph-memory", "platform/features/async-client", "platform/features/multimodal-support", @@ -513,6 +514,17 @@ "api-reference/entities/delete-user" ] }, + { + "group": "Profiles", + "icon": "id-card", + "pages": [ + "api-reference/profiles/get-profile", + "api-reference/profiles/get-profile-settings", + "api-reference/profiles/update-profile-settings", + "api-reference/profiles/generate-profiles", + "api-reference/profiles/get-profile-job" + ] + }, { "group": "Organizations", "icon": "building", diff --git a/docs/llms.txt b/docs/llms.txt index ce60e29f5..2a939cbe3 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -198,6 +198,7 @@ If the user is on a pre-current major (Python < 2, TS < 3, or a Platform call st ### Features - Essential - [V2 Memory Filters](https://docs.mem0.ai/platform/features/v2-memory-filters) [Platform]: Use when compound filters (AND/OR on metadata, entity, time) are needed at search. - [Entity-Scoped Memory](https://docs.mem0.ai/platform/features/entity-scoped-memory) [Platform]: Use when partitioning memories by user, agent, app, or run. +- [Profiles](https://docs.mem0.ai/platform/features/user-profiles) [Platform]: Use when a structured always-current summary of a user is needed in one read, instead of searching their memories. - [Graph Memory](https://docs.mem0.ai/platform/features/graph-memory) [Platform]: Use when connecting facts across memories through shared entities for entity-centric or multi-hop questions. - [Async Client](https://docs.mem0.ai/platform/features/async-client) [Platform]: Use when the app issues many concurrent Mem0 calls and needs non-blocking I/O. - [Multimodal Support](https://docs.mem0.ai/platform/features/multimodal-support) [Platform]: Use when storing images or PDFs as memory input. @@ -364,6 +365,11 @@ All API Reference docs describe Mem0 Platform REST endpoints (requires API key). ### Entities - [Get Users](https://docs.mem0.ai/api-reference/entities/get-users) [Platform]: Use when listing users, agents, or apps known to a project. - [Delete User](https://docs.mem0.ai/api-reference/entities/delete-user) [Platform]: Use when removing an entity and all its memories. +- [Get Profile](https://docs.mem0.ai/api-reference/profiles/get-profile) [Platform]: Use when reading a user's structured profile and branching on its generation status. +- [Get Profile Settings](https://docs.mem0.ai/api-reference/profiles/get-profile-settings) [Platform]: Use when checking the project's profile schema, instructions, or enabled flag. +- [Update Profile Settings](https://docs.mem0.ai/api-reference/profiles/update-profile-settings) [Platform]: Use when defining or changing the JSON Schema that shapes profiles for a project. +- [Generate Profiles](https://docs.mem0.ai/api-reference/profiles/generate-profiles) [Platform]: Use when building profiles now: a sample of ten, or one entity. +- [Get Generation Job](https://docs.mem0.ai/api-reference/profiles/get-profile-job) [Platform]: Use when checking how far a generation has got, and whether it finished. ### Organizations - [Create Organization](https://docs.mem0.ai/api-reference/organization/create-org) [Platform]: Use when setting up a new org. diff --git a/docs/openapi.json b/docs/openapi.json index af215596f..f27449514 100644 --- a/docs/openapi.json +++ b/docs/openapi.json @@ -8070,6 +8070,480 @@ } } } + }, + "/v2/entities/{entity_type}/{entity_id}/profile/": { + "get": { + "tags": [ + "profiles" + ], + "operationId": "profiles_read", + "summary": "Get an entity's profile", + "description": "Return the memory profile for one user.\n\nGeneration is asynchronous, so a known entity that has no profile yet is a normal 200 carrying a `status`. A 404 means only that no such entity exists.", + "parameters": [ + { + "name": "entity_type", + "in": "path", + "required": true, + "schema": { + "type": "string", + "enum": [ + "user" + ] + }, + "description": "The kind of entity that carries the profile." + }, + { + "name": "entity_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The entity's id, as supplied when the memory was added." + } + ], + "responses": { + "200": { + "description": "The profile envelope.", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "profile": { + "type": "object", + "additionalProperties": true, + "description": "The generated profile, shaped by the project's schema. Empty unless status is succeeded." + }, + "status": { + "type": "string", + "enum": [ + "succeeded", + "pending", + "failed", + "not_enabled", + "insufficient_data" + ], + "description": "Generation state. Branch on this rather than on an empty profile." + }, + "entity_type": { + "type": "string", + "enum": [ + "user" + ] + }, + "entity_id": { + "type": "string" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "nullable": true + }, + "generation_count": { + "type": "integer" + } + } + } + } + } + }, + "400": { + "description": "Unsupported entity type." + }, + "404": { + "description": "No such entity in this project." + } + } + } + }, + "/v2/profiles/settings/": { + "get": { + "tags": [ + "profiles" + ], + "operationId": "profiles_settings_read", + "summary": "Get profile settings", + "description": "Return the profile settings for the project the API key is scoped to.", + "responses": { + "200": { + "description": "Current settings.", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "description": "Whether profile generation runs for this project. Project-wide." + }, + "entities": { + "type": "object", + "description": "Settings for user profiles, under `user`.", + "properties": { + "user": { + "type": "object", + "properties": { + "schema": { + "type": "object", + "additionalProperties": true, + "nullable": true, + "description": "JSON Schema describing the profile. Every property needs a description." + }, + "custom_instructions": { + "type": "string", + "nullable": true, + "description": "Extra guidance for the extraction step." + } + } + } + } + }, + "capabilities": { + "type": "object", + "properties": { + "jobs": { + "type": "boolean" + }, + "estimates": { + "type": "boolean" + }, + "samples": { + "type": "boolean" + }, + "full_rebuild": { + "type": "boolean", + "description": "Whether a project-wide rebuild (regenerate/backfill) is available. Currently false." + } + } + } + } + } + } + } + } + } + }, + "post": { + "tags": [ + "profiles" + ], + "operationId": "profiles_settings_update", + "summary": "Update profile settings", + "description": "Update the project's profile settings. Only the fields present in the body are written, so one setting can change without re-sending the others.", + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Only the fields present are written. `schema` and `custom_instructions` nest under `entities.user`; a flat body is rejected.", + "properties": { + "enabled": { + "type": "boolean", + "description": "Whether profile generation runs for this project. Project-wide." + }, + "entities": { + "type": "object", + "description": "Settings for user profiles, under `user`.", + "properties": { + "user": { + "type": "object", + "properties": { + "schema": { + "type": "object", + "additionalProperties": true, + "nullable": true, + "description": "JSON Schema describing the profile. Every property needs a description. Send null to clear it." + }, + "custom_instructions": { + "type": "string", + "nullable": true, + "description": "Extra guidance for the extraction step. Send null to clear it." + } + } + } + } + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Settings as stored after the update.", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "enabled": { + "type": "boolean", + "description": "Whether profile generation runs for this project. Project-wide." + }, + "entities": { + "type": "object", + "description": "Settings for user profiles, under `user`.", + "properties": { + "user": { + "type": "object", + "properties": { + "schema": { + "type": "object", + "additionalProperties": true, + "nullable": true, + "description": "JSON Schema describing the profile. Every property needs a description." + }, + "custom_instructions": { + "type": "string", + "nullable": true, + "description": "Extra guidance for the extraction step." + } + } + } + } + }, + "capabilities": { + "type": "object", + "properties": { + "jobs": { + "type": "boolean" + }, + "estimates": { + "type": "boolean" + }, + "samples": { + "type": "boolean" + }, + "full_rebuild": { + "type": "boolean", + "description": "Whether a project-wide rebuild (regenerate/backfill) is available. Currently false." + } + } + } + } + } + } + } + }, + "400": { + "description": "The schema is not a valid profile schema." + } + } + } + }, + "/v2/profiles/jobs/": { + "post": { + "tags": [ + "profiles" + ], + "operationId": "profiles_create_job", + "summary": "Generate profiles", + "description": "Start one generation. `operation` says what to build:\n\n- `sample` — up to 10 real entities, so a schema can be judged before it is used widely. These are real profiles: they are saved to those entities and count toward usage.\n- `trigger` — one entity, named by `entity_id`.\n\nSend an `Idempotency-Key` header. Replaying the same key returns the same job instead of charging twice. Poll `status_url` from the response until the status is terminal.", + "parameters": [ + { + "in": "header", + "name": "Idempotency-Key", + "required": true, + "schema": { + "type": "string", + "minLength": 8, + "maxLength": 128 + }, + "description": "Makes a retry safe: the same key returns the same job." + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "operation", + "entity_type" + ], + "properties": { + "operation": { + "type": "string", + "enum": [ + "sample", + "trigger" + ], + "description": "What to generate. Optional only when `entity_id` is set, which means `trigger`." + }, + "entity_type": { + "type": "string", + "enum": [ + "user" + ] + }, + "entity_id": { + "type": "string", + "description": "One entity, for `trigger`." + }, + "limit": { + "type": "integer", + "minimum": 1, + "maximum": 10, + "description": "How many entities to sample." + } + } + } + } + } + }, + "responses": { + "202": { + "description": "Job accepted.", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "job_id": { + "type": "string" + }, + "status": { + "type": "string" + }, + "status_url": { + "type": "string", + "description": "Poll this. Building the path yourself breaks on a route change." + }, + "operation": { + "type": "string" + }, + "entity_type": { + "type": "string" + }, + "entity_count_reserved": { + "type": "integer", + "description": "Entities reserved against usage for this job." + }, + "event_id": { + "type": "string", + "nullable": true + }, + "replayed": { + "type": "boolean", + "description": "True when an Idempotency-Key returned an existing job." + }, + "sampled": { + "type": "integer", + "description": "`sample` only." + }, + "entity_ids": { + "type": "array", + "items": { + "type": "string" + }, + "description": "`sample` only: the entity ids picked. Read each with `GET /v2/entities/user/{entity_id}/profile/`." + } + } + } + } + } + }, + "400": { + "description": "Unknown or missing `operation`, or profiles are not configured." + }, + "402": { + "description": "Payment required." + }, + "409": { + "description": "A job is already running, or the Idempotency-Key was used for a different request. Branch on `error.code`." + }, + "429": { + "description": "Cooldown. `retry_after_seconds` sits inside `error`." + }, + "503": { + "description": "`jobs_unavailable` — generation is switched off for this project." + } + } + } + }, + "/v2/profiles/jobs/{job_id}/": { + "get": { + "tags": [ + "profiles" + ], + "operationId": "profiles_get_job", + "summary": "Read a generation job", + "description": "The job nests under `job`. `total` is null until `enumeration_complete`, and `completed` is `succeeded + failed + skipped`.", + "parameters": [ + { + "in": "path", + "name": "job_id", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "The job.", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "job": { + "type": "object", + "properties": { + "id": { + "type": "string" + }, + "operation": { + "type": "string" + }, + "entity_type": { + "type": "string" + }, + "status": { + "type": "string", + "enum": [ + "QUEUED", + "RUNNING", + "SUCCEEDED", + "PARTIALLY_SUCCEEDED", + "FAILED", + "CANCELLED" + ] + }, + "total": { + "type": "integer", + "nullable": true + }, + "enumeration_complete": { + "type": "boolean" + }, + "completed": { + "type": "integer" + }, + "succeeded": { + "type": "integer" + }, + "failed": { + "type": "integer" + }, + "skipped": { + "type": "integer" + } + } + } + } + } + } + } + }, + "404": { + "description": "No such job in this project." + } + } + } } }, "components": { @@ -8988,4 +9462,4 @@ } }, "x-original-swagger-version": "2.0" -} \ No newline at end of file +} diff --git a/docs/platform/features/user-profiles.mdx b/docs/platform/features/user-profiles.mdx new file mode 100644 index 000000000..1e99f59ea --- /dev/null +++ b/docs/platform/features/user-profiles.mdx @@ -0,0 +1,359 @@ +--- +title: Profiles +description: "Build a structured, always-current summary of each user from their memories, shaped by a JSON Schema you define." +--- + +# Profiles + +Memories are individual facts. A profile is the summary of all of them for one entity: a single structured object, shaped by a JSON Schema you define, that Mem0 keeps current as new memories arrive. + +Search answers "what did this user say about X". A profile answers "who is this user", in one read, with no query to write. + + + **Use profiles when…** + - You want to personalize a first response, before the user says anything in this session. + - You need a compact object to drop into a prompt instead of a list of memories. + - You want the same fields for every user, so your code can rely on their shape. + + + + User Profiles are in **beta** and available on request. To enable them for your + organization, contact [support@mem0.ai](mailto:support@mem0.ai). + + +## How it works + +1. You define a **schema**: the fields a profile should contain, each with a description. +2. Mem0 builds each entity's profile from their memories, and rebuilds it as new memories arrive. +3. You read the profile whenever you need it. + +Generation is **asynchronous**. A profile is not ready the instant an entity's first memory lands, so a read tells you where it is with a `status` rather than failing. + +## Define the schema + +The schema is JSON Schema. Every property needs a `description` — that is what tells the model how to fill the field, so a vague description gives a vague profile. + + +```python Python +from mem0 import MemoryClient + +client = MemoryClient() + +client.update_profile_settings( + enabled=True, + schema={ + "type": "object", + "properties": { + "communication_style": { + "type": "string", + "description": "How the user prefers to be addressed: terse, detailed, formal, casual", + }, + "expertise_areas": { + "type": "array", + "items": {"type": "string"}, + "description": "Subjects the user demonstrates working knowledge of", + }, + "current_goals": { + "type": "array", + "items": {"type": "string"}, + "description": "What the user is actively trying to accomplish", + }, + }, + }, + custom_instructions="Prefer durable traits over one-off remarks.", +) +``` + +```typescript TypeScript +import MemoryClient from "mem0ai"; + +const client = new MemoryClient({ apiKey: "your-api-key" }); + +await client.updateProfileSettings({ + enabled: true, + schema: { + type: "object", + properties: { + communication_style: { + type: "string", + description: + "How the user prefers to be addressed: terse, detailed, formal, casual", + }, + expertise_areas: { + type: "array", + items: { type: "string" }, + description: "Subjects the user demonstrates working knowledge of", + }, + current_goals: { + type: "array", + items: { type: "string" }, + description: "What the user is actively trying to accomplish", + }, + }, + }, + customInstructions: "Prefer durable traits over one-off remarks.", +}); +``` + + + + Your schema's property names reach the API exactly as you write them. The SDKs do not rewrite them, so a profile always comes back with the field names you chose. + + +Only the fields you pass are written. To turn the feature off without touching your schema, send `enabled` alone. + +## Read a profile + + +```python Python +result = client.get_profile("alice") + +if result["status"] == "succeeded": + print(result["profile"]) +else: + print("not ready:", result["status"]) +``` + +```typescript TypeScript +const result = await client.getProfile({ entityId: "alice" }); + +if (result.status === "succeeded") { + console.log(result.profile); +} else { + console.log("not ready:", result.status); +} +``` + + +A response looks like this: + +```json +{ + "profile": { + "communication_style": "terse", + "expertise_areas": ["distributed systems", "postgres"], + "current_goals": ["cut p99 latency", "migrate off the legacy queue"] + }, + "status": "succeeded", + "entity_type": "user", + "entity_id": "alice", + "updated_at": "2026-02-08T10:30:00Z", + "generation_count": 3 +} +``` + +`generation_count` is how many times this profile has been (re)generated — `0` before the first generation completes. + +### Always branch on `status` + +`profile` is empty unless `status` is `succeeded`. Check the status rather than the emptiness of the object, so a profile that is merely still building is not mistaken for a user you know nothing about. + +| `status` | Meaning | What to do | +|---|---|---| +| `succeeded` | Profile is built and current | Use it | +| `pending` | Generation is queued or running | Read again shortly | +| `insufficient_data` | Not enough memories to say anything yet | Fall back to defaults | +| `not_enabled` | Profiles are off for this project | Enable them in settings | +| `failed` | The last generation did not complete | Retry, or trigger a new one | + +A `404` means only that no such entity exists in your project. + +## Generate a profile on demand + +Profiles are built once an entity has accumulated enough messages, so a brand-new user has none during their first few interactions. Trigger one directly to close that gap: + + +```python Python +client.generate_profile("alice") +``` + +```typescript TypeScript +await client.generateProfile({ entityId: "alice" }); +``` + + +The call returns as soon as the work is queued. Poll the read endpoint and branch on `status`. + +## Test a schema before applying it + +A schema that reads well can still produce disappointing profiles. Sample a few real entities and inspect the output before committing to it. + +Sampling is asynchronous: the call returns a job as soon as it is queued. Poll `status_url` until the job is terminal, then read each sampled entity's profile: + + +```python Python +import time + +job = client.sample_profiles(limit=5) + +# Poll until the sample job reaches a terminal state (job status is UPPERCASE). +TERMINAL = {"SUCCEEDED", "PARTIALLY_SUCCEEDED", "FAILED", "CANCELLED"} +deadline = time.time() + 120 +while True: + status = client.get_profile_job(job["status_url"])["job"] + if status["status"] in TERMINAL: + break + if time.time() > deadline: + raise TimeoutError("Sample job did not finish in time") + time.sleep(3) + +print(status["status"], status["succeeded"], "of", status["total"]) + +# The create response lists the sampled entities; read each one's saved profile. +for entity_id in job.get("entity_ids", []): + print(client.get_profile(entity_id)) +``` + +```typescript TypeScript +const job = await client.sampleProfiles({ limit: 5 }); + +// Poll until the sample job reaches a terminal state (job status is UPPERCASE). +const TERMINAL = ["SUCCEEDED", "PARTIALLY_SUCCEEDED", "FAILED", "CANCELLED"]; +const deadline = Date.now() + 120_000; +let status; +while (true) { + status = (await client.getProfileJob(job.statusUrl)).job; + if (TERMINAL.includes(status.status)) break; + if (Date.now() > deadline) + throw new Error("Sample job did not finish in time"); + await new Promise((resolve) => setTimeout(resolve, 3000)); +} + +console.log(status.status, status.succeeded, "of", status.total); + +// The create response lists the sampled entities; read each one's saved profile. +for (const entityId of job.entityIds ?? []) { + console.log(await client.getProfile({ entityId })); +} +``` + + +These are real generations. The profiles are saved to those entities and count toward your usage, so sampling is not wasted work and not a free dry run. A sample covers up to 10 entities and cannot be repeated immediately. + +## Apply a new schema to existing entities + +A new schema shapes the next generation. Profiles that already exist keep their values until their entity is generated again. + +Each entity picks the new schema up as it sends more memories, and you can generate one now with `generate_profile`. + + +Rebuilding every profile in a project at once is not available yet. Refresh profiles one entity at a time with `generate_profile`, or let each one update on its own as its entity sends more memories. + + +## When profiles update + +You never call an "update profile" endpoint — Mem0 keeps each profile current for you. Two things drive it: + +- **Automatically, as memories accumulate.** Mem0 refreshes an entity's profile after roughly every **10 messages** it receives, folding the new memories into the existing profile. There is no schedule to wait for and no extra call to make: the same `add` you already do keeps the profile moving. +- **On demand.** Call `generate_profile` to build or refresh a profile immediately — useful for a brand-new entity that has not yet crossed the automatic threshold. + +Generation is **asynchronous and incremental**. A refresh runs in the background a short while after its trigger, so a read taken immediately after an `add` may still show the previous profile (or `pending`). Branch on `status` rather than assuming the latest memory is already reflected. + + + Updates are **incremental**, not a full rebuild each time — Mem0 merges what it newly learns into the stored profile and keeps the fields your schema still defines. After a schema change, existing profiles pick it up as their entities send more memories, or when you call `generate_profile` — see [Apply a new schema to existing entities](#apply-a-new-schema-to-existing-entities). + + +## Use a profile in a prompt + +The point of the structure is that it drops straight into a prompt: + +```python +result = client.get_profile(user_id) + +if result["status"] == "succeeded": + profile = result["profile"] + system_prompt = f"""You are helping {user_id}. +Communication style: {profile.get("communication_style", "unknown")} +Areas of expertise: {", ".join(profile.get("expertise_areas", []))} +Current goals: {", ".join(profile.get("current_goals", []))} + +Match their style and do not explain what they already know.""" +else: + system_prompt = "You are a helpful assistant." +``` + +## Writing a schema that works + +- **Describe every field.** The description is the instruction; without it the model guesses. +- **Prefer durable traits.** "Prefers dark mode" ages well; "is annoyed today" does not. +- **Keep it small.** Ten focused fields beat forty speculative ones, and cost less to generate. +- **Say what the field is not.** A description that rules out the near-miss interpretation is worth more than one that only states the obvious. +- **Sample before you commit.** It is the only way to see what your descriptions actually produce. + + + A schema has a size budget of roughly **10,000 tokens** of serialized JSON — the whole schema is sent to the model on every generation, so a handful of verbose fields can cost more than many terse ones. Oversized schemas are rejected on save. + + +## Availability + +The feature is in beta and enabled per organization on request — see the note at the top of this page. + +Once it is on, an entity gets a profile when two more things hold: + +- profiles are **enabled** with a schema for the project (see [Define the schema](#define-the-schema)), and +- the memory is scoped to an entity — a `user_id`. + +On a project where profiles are turned off, a read returns `status: not_enabled` rather than an error, so you can call it unconditionally and branch on the status. + +## Settings reference + +| Argument | Type | Description | +|---|---|---| +| `enabled` | boolean | Whether profile generation runs for the project | +| `schema` | object | JSON Schema describing the profile. Every property needs a `description` | +| `custom_instructions` | string | Extra guidance applied during extraction | + +`enabled` is project-wide. `schema` and `custom_instructions` apply to user +profiles, so the stored settings nest them under `entities`: + +```json +{ + "enabled": true, + "entities": { + "user": { + "schema": { "type": "object", "properties": { "...": {} } }, + "custom_instructions": "Prefer durable traits over one-off remarks." + } + }, + "capabilities": { "full_rebuild": false } +} +``` + +That is what a read returns and what a write accepts. The SDKs take the fields +flat and nest them for you, so a schema you write with +`update_profile_settings` comes back unchanged from `get_profile_settings`. + + + Profile settings are per project. An API key is scoped to one project, so profiles never cross a project boundary. + + +## FAQ + +**Do I need to change my `add` or `search` calls to use profiles?** +No. Profiles are built from the memories you already add. You define a schema once and read the profile when you need it — your ingestion and retrieval code is unchanged. + +**Why is `profile` empty even though the entity has memories?** +Generation is asynchronous and needs enough to work with. Branch on `status`: `pending` means it is still building, and `insufficient_data` means there are not yet enough memories to fill the schema. Read again shortly, or call `generate_profile` to build one now. + +**Is sampling free?** +No. `sample_profiles` runs real generations against real memories and **keeps** the profiles it produces, so it counts toward your usage like any other generation. It exists to check a schema on a few entities before you commit to it — not as a zero-cost dry run. + +**Does changing the schema rewrite existing profiles?** +No. A schema change applies to the next generation. An existing profile keeps its values until its entity is generated again, which happens as that entity sends more memories, or when you call `generate_profile` for it. + +**What happens to a field I remove from the schema?** +It stops being maintained. On an entity's next generation, fields your schema no longer defines are pruned from the stored profile — so keep a field in the schema for as long as you want its value kept. + +**How current is a profile?** +It refreshes automatically as memories accumulate (about every 10 messages for an entity), plus any on-demand `generate_profile` calls. Because refreshes run in the background, expect a short delay after the triggering `add` rather than an instant update. + +## Related + + + + How users, agents, apps and runs partition memories. + + + Steer what Mem0 extracts in the first place. + + diff --git a/examples/notebooks/user-profiles.ipynb b/examples/notebooks/user-profiles.ipynb new file mode 100644 index 000000000..72ef7580d --- /dev/null +++ b/examples/notebooks/user-profiles.ipynb @@ -0,0 +1,764 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# User Profiles — live demo\n", + "\n", + "A **profile** is a structured JSON document about ONE user, filled by an LLM from that\n", + "user's memories, shaped by a JSON Schema you supply.\n", + "\n", + "Search answers *\"what did this user say about X\"*. A profile answers *\"who is this\n", + "user\"*, in one read, with no query to write — and it is available on the first turn of a\n", + "session, before the user has said anything.\n", + "\n", + "**What this notebook does:** feed a user 12 conversation turns, watch a profile get\n", + "generated from them, add 6 more turns that contradict the first set, and watch the\n", + "profile rewrite itself. Then it shows every way the API says no.\n", + "\n", + "**You need:** an API key, and a project on the **Pro plan or higher**. Never commit one.\n", + "\n", + "> Set `MEM0_API_KEY`, and `MEM0_API_HOST` if you are pointing at a sandbox rather than\n", + "> production. The cells below read both from the environment.\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "> **Use a disposable project.** This notebook overwrites the project's profile settings\n", + "> (enabled, schema, custom instructions). The last cell restores the values saved at the\n", + "> start, but only if you reach it: if a cell fails midway, the project keeps the demo\n", + "> schema until you run the cleanup cell or reset it yourself. Do not point it at a\n", + "> project other people or production traffic depend on.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# This notebook drives the SDK from this worktree, not the published mem0ai:\n", + "# the profile fixes below are not released yet.\n", + "%pip install -q -e ../..\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": "import json\nimport os\nimport time\nimport uuid\n\nimport mem0\nfrom mem0 import MemoryClient\n\nAPI_KEY = os.environ.get(\"MEM0_API_KEY\")\nif not API_KEY:\n import getpass\n\n API_KEY = getpass.getpass(\"API key: \")\n\nclient = MemoryClient(api_key=API_KEY, host=os.environ.get(\"MEM0_API_HOST\") or None)\n\n# Fresh id each run, so nothing below is stale from a previous pass.\nUSER_ID = f\"demo_{uuid.uuid4().hex[:8]}\"\n\n# Snapshot the project's profile settings up front. This notebook overwrites the\n# shared project schema/instructions/enabled below; the cleanup cell restores this.\nORIGINAL_SETTINGS = client.get_profile_settings()\n\nprint(\"sdk :\", mem0.__file__) # must be this worktree\nprint(\"host :\", client.host)\nprint(\"demo user:\", USER_ID)" + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 1. Define the schema\n", + "\n", + "The schema is handed to the model as a **tool definition**, and each field's\n", + "`description` is the only instruction the model gets about what belongs there. An\n", + "undescribed field is a field the model guesses at.\n", + "\n", + "Rules worth knowing:\n", + "\n", + "- root `type: object` with a **non-empty** `properties` — an empty one is refused, because\n", + " it would bill you to extract nothing\n", + "- the root keys `_profile_config_version` and `entities` are **reserved** and rejected:\n", + " they name the storage envelope, so a schema using them could not be read back\n", + " unambiguously\n", + "- keep it small. The whole schema is sent to the model on every generation\n", + "\n", + "Descriptions are **not** enforced on write in this build — a property without one is\n", + "accepted and then quietly underfilled at generation time. Section F1 demonstrates it.\n", + "Treat descriptions as your job, not the validator's.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "SCHEMA = {\n", + " \"type\": \"object\",\n", + " \"properties\": {\n", + " \"occupation\": {\n", + " \"type\": \"string\",\n", + " \"description\": \"The person's current job title, in one short phrase.\",\n", + " },\n", + " \"location\": {\n", + " \"type\": \"string\",\n", + " \"description\": \"The city or region the person currently lives in.\",\n", + " },\n", + " \"interests\": {\n", + " \"type\": \"array\",\n", + " \"items\": {\"type\": \"string\"},\n", + " \"description\": \"Hobbies and topics they return to, as short lowercase tags.\",\n", + " },\n", + " \"dietary_restrictions\": {\n", + " \"type\": \"array\",\n", + " \"items\": {\"type\": \"string\"},\n", + " \"description\": \"Foods the person avoids, and why, if they said.\",\n", + " },\n", + " \"communication_style\": {\n", + " \"type\": \"string\",\n", + " \"enum\": [\"concise\", \"detailed\", \"casual\", \"formal\"],\n", + " \"description\": \"How this person prefers to be answered.\",\n", + " },\n", + " \"expertise_level\": {\n", + " \"type\": \"string\",\n", + " \"enum\": [\"beginner\", \"intermediate\", \"advanced\"],\n", + " \"description\": \"Their technical depth, judged from how they discuss their work.\",\n", + " },\n", + " },\n", + "}\n", + "\n", + "settings = client.update_profile_settings(\n", + " enabled=True,\n", + " schema=SCHEMA,\n", + " custom_instructions=(\n", + " \"Prefer facts the person stated outright over anything inferred. \"\n", + " \"Leave a field empty rather than guessing.\"\n", + " ),\n", + ")\n", + "\n", + "# Sorted, because JSONB storage does not preserve the key order you sent.\n", + "# Compare a stored schema by SET, never by string or by key order.\n", + "stored = settings[\"entities\"][\"user\"][\"schema\"]\n", + "print(\"schema fields:\", sorted(stored[\"properties\"]))\n", + "print(\"enabled :\", settings[\"enabled\"])\n", + "print(\"capabilities :\", settings[\"capabilities\"])\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "`enabled` is project-wide; `schema` and `custom_instructions` apply to user profiles\n", + "and are stored under `entities`. The SDK takes them flat and nests them for you, so what\n", + "you write comes back unchanged from `get_profile_settings()`.\n", + "\n", + "Only the arguments you pass are written. To turn the feature off without touching your\n", + "schema, send `enabled` alone.\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 2. The turns\n", + "\n", + "Twelve conversation turns for one user. Nothing about `add()` changes — profiles are a\n", + "side effect of the normal pipeline.\n", + "\n", + "Twelve, not five, because generation fires when an entity crosses a **10-message\n", + "boundary**. Below that it waits for a flush window measured in hours, and this notebook\n", + "would sit there.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "TURNS = [\n", + " (\"user\", \"Hey — I just moved to Berlin for a new job.\"),\n", + " (\"assistant\", \"Congratulations! What's the new role?\"),\n", + " (\"user\", \"Senior data engineer at a logistics company. Mostly Spark and Airflow.\"),\n", + " (\"assistant\", \"Nice stack. How are you finding the pipelines there?\"),\n", + " (\"user\", \"Honestly the DAGs are a mess. I've been rewriting the partitioning to cut shuffle.\"),\n", + " (\"assistant\", \"That usually pays off fast. Anything blocking you?\"),\n", + " (\"user\", \"Just time. Keep it short when you answer me, I skim everything.\"),\n", + " (\"assistant\", \"Understood — short answers from here.\"),\n", + " (\"user\", \"Outside work I climb most weekends, and I'm learning German.\"),\n", + " (\"assistant\", \"Bouldering or ropes?\"),\n", + " (\"user\", \"Bouldering. Also — I'm vegetarian, so skip meat in any recipe suggestions.\"),\n", + " (\"assistant\", \"Noted, vegetarian only.\"),\n", + "]\n", + "\n", + "response = client.add(\n", + " [{\"role\": r, \"content\": c} for r, c in TURNS],\n", + " user_id=USER_ID,\n", + ")\n", + "print(json.dumps(response, indent=2)[:300])\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The add is **async** — it returns an `event_id` and the memories do not exist yet. Poll\n", + "`GET /v1/event/{event_id}/` until it is `SUCCEEDED` or `FAILED`; that, not a sleep, is how\n", + "you know the add finished. Then let the extracted memories settle.\n", + "\n", + "Under load this can take a minute or more, so the cell says plainly whether it ran out of\n", + "time rather than printing `0 memories` as though that were the answer.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "event_id = response[\"event_id\"]\n", + "deadline = time.time() + 300\n", + "\n", + "# 1. The add itself. Terminal status, not a sleep.\n", + "event_status = None\n", + "while time.time() < deadline:\n", + " event_status = client.client.get(f\"/v1/event/{event_id}/\").json().get(\"status\")\n", + " if event_status in (\"SUCCEEDED\", \"FAILED\"):\n", + " break\n", + " print(f\" add {event_status}\")\n", + " time.sleep(5)\n", + "print(f\"add finished: {event_status}\")\n", + "# Stop here unless the add SUCCEEDED. A failed or unfinished add would otherwise let the\n", + "# generation below bill for a profile built without these memories.\n", + "if event_status != \"SUCCEEDED\":\n", + " raise RuntimeError(f\"add did not succeed (status={event_status}); not generating a profile\")\n", + "\n", + "# 2. Extraction lands in batches, so the FIRST non-empty page is not the whole set.\n", + "# Wait for the count to stop growing instead of breaking on the first result.\n", + "memories, stable = [], 0\n", + "while time.time() < deadline:\n", + " page = client.get_all(filters={\"user_id\": USER_ID}, page_size=50)\n", + " found = page.get(\"results\", []) if isinstance(page, dict) else page\n", + " stable = stable + 1 if found and len(found) == len(memories) else 0\n", + " memories = found\n", + " if stable >= 2: # two identical polls in a row\n", + " break\n", + " print(f\" ... {len(memories)} so far\")\n", + " time.sleep(5)\n", + "\n", + "if memories:\n", + " print(f\"\\n{len(memories)} memories extracted:\\n\")\n", + " for m in memories:\n", + " print(\" \\u2022\", m.get(\"memory\"))\n", + "else:\n", + " # Say so. Reporting '0 memories' as a result hides a busy or broken environment\n", + " # and makes the profile below look like it came from nothing.\n", + " print(\"\\nNO memories yet — extraction is still catching up, or the ingestion\")\n", + " print(\"worker is down. Everything below will report insufficient_data.\")\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 3. Read the profile\n", + "\n", + "Crossing the 10-message boundary should already have queued a generation. Read first —\n", + "and note that a known user with no profile yet is a **200 with a status**, not a 404. That\n", + "distinction is the whole point of the envelope.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "envelope = client.get_profile(USER_ID)\n", + "print(json.dumps(envelope, indent=2))\n", + "\n", + "print(\"\\nstatus vocabulary:\")\n", + "print(\" succeeded terminal — a generation ran AND the profile has content\")\n", + "print(\" pending queued or running\")\n", + "print(\" failed terminal — the last generation did not complete\")\n", + "print(\" not_enabled feature off, or plan below Pro\")\n", + "print(\" insufficient_data no content to show: no row yet, queued, or a\")\n", + "print(\" generation that legitimately found nothing\")\n", + "print()\n", + "print(\"`succeeded` is decided by the profile BODY, not by generation_count: an\")\n", + "print(\"empty extraction still increments the counter, so counting generations\")\n", + "print(\"reports 'done' for a profile with nothing in it.\")\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Force it, rather than waiting\n", + "\n", + "`generate_profile()` closes the bootstrapping gap: without it a new user has no profile\n", + "until their tenth message. One entity, a few seconds.\n", + "\n", + "Each call sends a new `Idempotency-Key` unless you pass one, and a new key starts a new job.\n", + "To retry a dropped request safely, generate the key yourself and pass the same\n", + "`idempotency_key` on every attempt: the server then returns the original job instead of\n", + "billing a second one.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "TERMINAL = {\"succeeded\", \"failed\", \"not_enabled\"}\n", + "\n", + "\n", + "def wait_for_profile(entity_id, timeout=300, interval=5, since=None):\n", + " \"\"\"Poll until terminal.\n", + "\n", + " `since` waits for a generation_count ABOVE that value, which is how you wait\n", + " for an UPDATE rather than accepting the profile you already had.\n", + "\n", + " `insufficient_data` is NOT terminal by itself — it also covers 'queued', so\n", + " poll through it and give up on the timeout instead.\n", + " \"\"\"\n", + " deadline = time.time() + timeout\n", + " body = None\n", + " while time.time() < deadline:\n", + " body = client.get_profile(entity_id)\n", + " status = (body.get(\"status\") or \"\").lower()\n", + " count = body.get(\"generation_count\") or 0\n", + " fresh = count > since if since is not None else True\n", + " if status == \"succeeded\" and fresh:\n", + " return body\n", + " if status in (\"failed\", \"not_enabled\"):\n", + " raise RuntimeError(f\"generation stopped: {status}\")\n", + " print(f\" ... {status} (generation_count={count})\")\n", + " time.sleep(interval)\n", + " raise TimeoutError(f\"not ready in {timeout}s: {body}\")\n", + "\n", + "\n", + "print(json.dumps(client.generate_profile(USER_ID), indent=2))\n", + "print(\"\\npolling...\")\n", + "\n", + "try:\n", + " body = wait_for_profile(USER_ID)\n", + " print(\"\\n=== PROFILE ===\")\n", + " print(json.dumps(body[\"profile\"], indent=2))\n", + " print(f\"\\nstatus={body['status']} generations={body['generation_count']} updated={body['updated_at']}\")\n", + "except TimeoutError as e:\n", + " # Say so plainly and let the rest of the notebook skip, rather than raising\n", + " # a NameError in every cell below and burying the real cause.\n", + " body = None\n", + " print(f\"\\nNO PROFILE: {e}\")\n", + " print(\"Generation never finished. Usually the ingestion worker is down, or\")\n", + " print(\"this project has no memories for the user yet.\")\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# The model must not invent fields outside your schema — the forced tool call is\n", + "# what makes that structural rather than a request.\n", + "if body is None:\n", + " print(\"skipped — no profile was generated above\")\n", + "else:\n", + " extra = set(body[\"profile\"]) - set(SCHEMA[\"properties\"])\n", + " print(\"fields outside the schema:\", extra or \"none\")\n", + "\n", + " # A forced JSON-Schema response makes the model emit SOMETHING for every property,\n", + " # so 'I found nothing' arrives as a type default: 0, \"\", [].\n", + " filled = {k: v for k, v in body[\"profile\"].items() if v not in (None, \"\", [], {}, 0)}\n", + " print(f\"genuinely populated: {len(filled)}/{len(SCHEMA['properties'])} -> {list(filled)}\")\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 4. Now watch it update\n", + "\n", + "Six more turns that contradict and extend what we already know: a promotion, a move, a\n", + "dropped hobby. A profile is a living document, not an append-only log — the model gets the\n", + "memories and rewrites the whole thing.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "if body is None:\n", + " print(\"skipped — no profile was generated above\")\n", + "else:\n", + " before = body[\"generation_count\"]\n", + "\n", + " MORE_TURNS = [\n", + " (\"user\", \"Update — I got promoted to staff engineer last week.\"),\n", + " (\"assistant\", \"Congratulations. Same team?\"),\n", + " (\"user\", \"Same company, but I'm relocating to Munich for it.\"),\n", + " (\"assistant\", \"Big move. How do you feel about it?\"),\n", + " (\"user\", \"Good. I've stopped climbing though — knee injury. Picked up cycling instead.\"),\n", + " (\"assistant\", \"Sorry about the knee. Cycling's kinder on it.\"),\n", + " ]\n", + "\n", + " followup = client.add(\n", + " [{\"role\": r, \"content\": c} for r, c in MORE_TURNS],\n", + " user_id=USER_ID,\n", + " )\n", + "\n", + " # Wait for the add to land before triggering: a generation queued before the new\n", + " # memories exist rewrites the profile from the OLD ones and looks like a no-op.\n", + " deadline = time.time() + 300\n", + " status = None\n", + " while time.time() < deadline:\n", + " status = client.client.get(f\"/v1/event/{followup['event_id']}/\").json().get(\"status\")\n", + " if status in (\"SUCCEEDED\", \"FAILED\"):\n", + " break\n", + " time.sleep(5)\n", + " print(\"follow-up add:\", status)\n", + " # Generating after a FAILED or unfinished add bills for a profile built from the OLD\n", + " # memories only, so stop instead.\n", + " if status != \"SUCCEEDED\":\n", + " raise RuntimeError(f\"follow-up add did not succeed (status={status}); not regenerating\")\n", + " time.sleep(15) # let extraction settle\n", + "\n", + " print(json.dumps(client.generate_profile(USER_ID), indent=2))\n", + " print(f\"\\npolling for a NEW generation (count must exceed {before})...\")\n", + " updated = wait_for_profile(USER_ID, since=before)\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "if body is None:\n", + " print(\"skipped — no profile was generated above\")\n", + "else:\n", + " print(f\"{'field':<22} {'before':<34} after\")\n", + " print(\"-\" * 92)\n", + " for field in SCHEMA[\"properties\"]:\n", + " b = json.dumps(body[\"profile\"].get(field))\n", + " a = json.dumps(updated[\"profile\"].get(field))\n", + " mark = \" \" if a == b else \"->\"\n", + " print(f\"{mark} {field:<20} {b[:32]:<34} {a[:32]}\")\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 5. Use it in a prompt\n", + "\n", + "The point of the structure is that it drops straight into a prompt — no list of memories\n", + "to summarize, no query to write.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "def build_system_prompt(entity_id):\n", + " result = client.get_profile(entity_id)\n", + " if result[\"status\"] != \"succeeded\":\n", + " # Branch on status, never on an empty profile: a user whose profile is\n", + " # still building is not a user you know nothing about.\n", + " return \"You are a helpful assistant.\"\n", + "\n", + " p = result[\"profile\"]\n", + " return f\"\"\"You are helping {entity_id}.\n", + "Occupation: {p.get(\"occupation\", \"unknown\")}\n", + "Location: {p.get(\"location\", \"unknown\")}\n", + "Interests: {\", \".join(p.get(\"interests\", [])) or \"unknown\"}\n", + "Dietary restrictions: {\", \".join(p.get(\"dietary_restrictions\", [])) or \"none stated\"}\n", + "Preferred style: {p.get(\"communication_style\", \"unknown\")}\n", + "\n", + "Match their style and do not explain what they already know.\"\"\"\n", + "\n", + "\n", + "print(build_system_prompt(USER_ID))\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 6. Judge a schema before committing to it\n", + "\n", + "`sample_profiles()` runs your schema against up to 10 **real** users that have memories.\n", + "\n", + "These are real generations and the results are **kept** — a dry run would cost exactly the\n", + "same and leave those users no better off. It is not a free preview.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "# 202, not 200: the sample generations are queued, not finished.\n", + "#\n", + "# A 409 `already_running` means a sample from an earlier run is still going.\n", + "# That is the cooldown working, not an error — reuse that job rather than\n", + "# failing the notebook.\n", + "try:\n", + " job = client.sample_profiles(limit=3)\n", + " print(json.dumps(job, indent=2)[:400])\n", + " print(\"\\nsampled\", job.get(\"sampled\"), \"entities:\", job.get(\"entity_ids\"))\n", + "except Exception as e:\n", + " detail = str(e)\n", + " print(\"sample refused:\", detail[:200])\n", + " running = json.loads(detail).get(\"error\", {}).get(\"job_id\") if detail.startswith(\"{\") else None\n", + " job = {\"job_id\": running, \"status_url\": f\"/v2/profiles/jobs/{running}/\"} if running else None\n", + " print(\"reusing the running job:\", running)\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Poll `status_url` to see how the job went. `total` is `null` until enumeration finishes,\n", + "so format it defensively rather than assuming a number.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": "JOB_TERMINAL = {\"SUCCEEDED\", \"PARTIALLY_SUCCEEDED\", \"FAILED\", \"CANCELLED\"}\n\n\ndef wait_for_job(job_response, timeout=300, interval=5):\n \"\"\"Poll a generation job. Prefer status_url over a bare job id, so a route\n change needs no client update. Raise on timeout so an unfinished job is never\n mistaken for a finished one.\"\"\"\n handle = job_response.get(\"status_url\") or job_response[\"job_id\"]\n deadline = time.time() + timeout\n status = None\n while time.time() < deadline:\n status = client.get_profile_job(handle)[\"job\"]\n total = status.get(\"total\")\n print(\n f\" {status['status']} \"\n f\"completed={status.get('completed', 0)}/{total if total is not None else '?'} \"\n f\"succeeded={status.get('succeeded', 0)} \"\n f\"failed={status.get('failed', 0)} \"\n f\"skipped={status.get('skipped', 0)}\"\n )\n if str(status.get(\"status\", \"\")).upper() in JOB_TERMINAL:\n return status\n time.sleep(interval)\n raise TimeoutError(\n f\"job not terminal in {timeout}s (last status: {status.get('status') if status else 'none'})\"\n )\n\n\nif job is None:\n print(\"no sample job to poll\")\nelse:\n final = wait_for_job(job)\n\n print(\"\\n--- what the sample produced ---\")\n for entity_id in job.get(\"entity_ids\", []):\n got = client.get_profile(entity_id)\n print(f\"\\n{entity_id} [{got['status']}]\")\n print(\" \", json.dumps(got[\"profile\"])[:220])" + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 7. Apply a new schema to existing users\n", + "\n", + "A new schema shapes the **next** generation. Profiles that already exist keep their values\n", + "until their user is generated again — which happens as that user sends more memories, or\n", + "when you call `generate_profile()` for them.\n", + "\n", + "A field you **remove** stops being maintained: on the next generation, fields your schema\n", + "no longer defines are pruned. Keep a field for as long as you want its value kept." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---\n", + "\n", + "# Failure scenarios\n", + "\n", + "Everything above is the path that works. These are the ways it says no, and what each one\n", + "means. Run this section last: F3 deliberately leaves the project switched off for a moment.\n", + "\n", + "> **About the `HTTP error occurred:` lines below.** The SDK logs every 4xx at\n", + "> ERROR level before raising, so they appear even for the failures these cells\n", + "> deliberately catch. Read the line printed *after* each one — that is the cell's\n", + "> own verdict. Nothing here is unhandled.\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## F1. Schemas that get rejected\n", + "\n", + "Rejections happen on **write**, where you can see and fix them — not silently at\n", + "generation time, where you would only notice as an empty profile weeks later.\n", + "\n", + "The last case matters for storage: the user schema lives in one JSONB column alongside\n", + "the envelope that separates it, so a schema using the envelope's own reserved keys could\n", + "not be read back unambiguously. It is refused rather than stored.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "BAD_SCHEMAS = [\n", + " ({\"type\": \"object\", \"properties\": {}}, \"empty — bills you to extract nothing\"),\n", + " ({\"type\": \"array\", \"items\": {\"type\": \"string\"}}, \"root must be an object\"),\n", + " (\n", + " {\n", + " \"type\": \"object\",\n", + " \"properties\": {\"tone\": {\"type\": \"string\", \"description\": \"Preferred tone.\"}},\n", + " # At the schema ROOT, which is where the envelope's own keys live.\n", + " \"_profile_config_version\": 1,\n", + " \"entities\": {\"user\": {}},\n", + " },\n", + " \"reserved settings keys at the schema root\",\n", + " ),\n", + "]\n", + "\n", + "for bad, why in BAD_SCHEMAS:\n", + " try:\n", + " client.update_profile_settings(schema=bad)\n", + " print(f\"ACCEPTED (unexpected): {why}\")\n", + " except Exception as e:\n", + " print(f\"rejected [{why}]:\\n {str(e)[:160]}\\n\")\n", + "\n", + "# NOT rejected: a property with no description. The validator allows it and the\n", + "# model then has nothing to go on, so the field comes back empty. Descriptions are\n", + "# your job, not the validator's.\n", + "try:\n", + " client.update_profile_settings(schema={\"type\": \"object\", \"properties\": {\"x\": {\"type\": \"string\"}}})\n", + " print(\"accepted [no description on 'x'] <- the trap: valid to store, useless to generate\")\n", + "finally:\n", + " client.update_profile_settings(schema=SCHEMA) # put the good one back\n", + "\n", + "restored = client.get_profile_settings()[\"entities\"][\"user\"][\"schema\"]\n", + "assert set(restored[\"properties\"]) == set(SCHEMA[\"properties\"])\n", + "print(\"\\nschema restored:\", sorted(restored[\"properties\"]))\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## F2. A user that does not exist\n", + "\n", + "404 means only \"no such user\". A known user with no profile yet is a 200 carrying\n", + "`insufficient_data`, so an ordinary empty state never looks like an error.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "from mem0.exceptions import MemoryNotFoundError\n", + "\n", + "try:\n", + " client.get_profile(\"user_who_never_existed\")\n", + " print(\"ACCEPTED (unexpected)\")\n", + "except MemoryNotFoundError as e:\n", + " print(\"404 as intended:\", str(e)[:120])\n", + "\n", + "# ...versus a real user who simply has no profile row yet.\n", + "fresh = f\"demo_never_profiled_{uuid.uuid4().hex[:6]}\"\n", + "client.add([{\"role\": \"user\", \"content\": \"One passing remark.\"}], user_id=fresh)\n", + "time.sleep(5)\n", + "print(\"known but unprofiled:\", client.get_profile(fresh)[\"status\"])\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## F3. Profiles turned off\n", + "\n", + "`enabled` is the one project-wide switch. Every generation path then refuses.\n", + "\n", + "Nothing is deleted. Your schema and every profile you already built are kept, so turning\n", + "it back on resumes rather than restarts.\n", + "\n", + "Note what a read does **not** do — a profile that already exists keeps reporting\n", + "`succeeded` and keeps returning its content. `not_enabled` is only what you get for a user\n", + "with no profile yet. Turning the feature off stops new work; it does not hide what has\n", + "already been built.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": [ + "client.update_profile_settings(enabled=False)\n", + "\n", + "print(\"read (demo user) :\", client.get_profile(USER_ID)[\"status\"])\n", + "print(\"read (never profiled) :\", client.get_profile(fresh)[\"status\"])\n", + "try:\n", + " client.generate_profile(USER_ID)\n", + " print(\"trigger: ACCEPTED (unexpected)\")\n", + "except Exception as e:\n", + " print(\"trigger:\", str(e)[:160])\n", + "\n", + "back = client.update_profile_settings(enabled=True) # put it back\n", + "print(\"\\nrestored:\", back[\"enabled\"])\n", + "print(\"schema survived:\", bool(back[\"entities\"][\"user\"][\"schema\"]))\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## 7. Cleanup\n", + "\n", + "Removes the demo users. The profile row cascades with the entity.\n" + ] + }, + { + "cell_type": "code", + "execution_count": null, + "metadata": {}, + "outputs": [], + "source": "# Restore the project's profile settings to the start-of-run snapshot in `finally`, so a\n# failed delete still leaves a shared project as we found it. Passing the original values\n# (including None) clears anything this notebook set: the SDK treats an explicit None as\n# \"clear\" and an omitted argument as \"unchanged\".\ntry:\n # `fresh` only exists if the error-handling section ran.\n for entity_id in (USER_ID, globals().get(\"fresh\")):\n if entity_id is None:\n continue\n r = client.client.delete(f\"/v2/entities/user/{entity_id}/\")\n print(entity_id, \"->\", r.status_code)\nfinally:\n _user = ORIGINAL_SETTINGS.get(\"entities\", {}).get(\"user\", {})\n client.update_profile_settings(\n enabled=ORIGINAL_SETTINGS.get(\"enabled\", False),\n schema=_user.get(\"schema\"),\n custom_instructions=_user.get(\"custom_instructions\"),\n )\n print(\"profile settings restored to the pre-notebook snapshot\")" + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "---\n", + "\n", + "## Cheat sheet\n", + "\n", + "| Want | Call | Cost |\n", + "| --- | --- | --- |\n", + "| configure | `update_profile_settings(...)` | free |\n", + "| read | `get_profile(user_id)` | free |\n", + "| one user now | `generate_profile(user_id)` | 1 LLM call |\n", + "| try a schema | `sample_profiles(limit=n)` | ≤10 real generations, kept |\n", + "| poll a job | `get_profile_job(status_url)` | free |\n", + "\n", + "**Settings apply to user profiles.** The stored shape is:\n", + "\n", + "```json\n", + "{\"enabled\": true,\n", + " \"entities\": {\"user\": {\"schema\": {...}, \"custom_instructions\": \"...\"}},\n", + " \"capabilities\": {\"full_rebuild\": false}}\n", + "```\n", + "\n", + "The SDK takes these flat and nests them for you. Only the fields you pass are written;\n", + "`enabled` is the one project-wide switch.\n", + "\n", + "**Left alone, generation fires** on a 10-message boundary, or after a flush window\n", + "measured in hours. `generate_profile()` is how you skip the wait for one user.\n", + "\n", + "**Three traps:**\n", + "\n", + "1. `insufficient_data` is not a terminal verdict — it also covers \"queued\", so poll\n", + " through it and give up on a timeout instead.\n", + "2. `succeeded` is decided by the profile **body**, not `generation_count`. An empty\n", + " extraction still increments the counter.\n", + "3. A forced JSON-Schema response emits something for every property, so \"nothing found\"\n", + " arrives as a type default — `\"\"`, `[]`, `0` — not as a missing key.\n" + ] + } + ], + "metadata": { + "kernelspec": { + "display_name": "Python 3 (ipykernel)", + "language": "python", + "name": "python3" + }, + "language_info": { + "codemirror_mode": { + "name": "ipython", + "version": 3 + }, + "file_extension": ".py", + "mimetype": "text/x-python", + "name": "python", + "nbconvert_exporter": "python", + "pygments_lexer": "ipython3", + "version": "3.12.4" + } + }, + "nbformat": 4, + "nbformat_minor": 4 +} \ No newline at end of file diff --git a/mem0-ts/package.json b/mem0-ts/package.json index b0490dd2e..3bb996079 100644 --- a/mem0-ts/package.json +++ b/mem0-ts/package.json @@ -1,6 +1,6 @@ { "name": "mem0ai", - "version": "3.2.0", + "version": "3.3.0", "description": "The Memory Layer For Your AI Apps", "main": "./dist/index.js", "module": "./dist/index.mjs", diff --git a/mem0-ts/src/client/index.ts b/mem0-ts/src/client/index.ts index 24ec5b8f4..138b29dc7 100644 --- a/mem0-ts/src/client/index.ts +++ b/mem0-ts/src/client/index.ts @@ -23,6 +23,14 @@ export type { FeedbackPayload, CreateMemoryExportPayload, GetMemoryExportPayload, + ProfileEntityType, + ProfileStatus, + ProfileResponse, + ProfileJobResponse, + ProfileJobStatus, + ProfileSettings, + ProfileSettingsResponse, + EntityProfileSettings, } from "./mem0.types"; // Re-export enums as values (not type-only) diff --git a/mem0-ts/src/client/mem0.ts b/mem0-ts/src/client/mem0.ts index 33e03f0c2..0f8725164 100644 --- a/mem0-ts/src/client/mem0.ts +++ b/mem0-ts/src/client/mem0.ts @@ -1,4 +1,5 @@ import axios from "axios"; +import { v7 as uuidv7 } from "uuid"; import { AllUsers, PaginatedMemories, @@ -20,6 +21,12 @@ import { FeedbackPayload, CreateMemoryExportPayload, GetMemoryExportPayload, + ProfileEntityType, + ProfileResponse, + ProfileJobResponse, + ProfileJobStatus, + ProfileSettings, + ProfileSettingsResponse, } from "./mem0.types"; import { captureClientEvent, @@ -92,6 +99,9 @@ interface ClientIdentity { } // Shares one ping per (host, api key) across clients; FIFO-capped. +// One collection for every generation; the operation is a body field. +const PROFILE_JOBS_PATH = "/v2/profiles/jobs/"; + const IDENTITY_CACHE_MAX_DEFAULT = 50; const identityByCredentials = new Map>(); @@ -305,7 +315,8 @@ export default class MemoryClient { }); } - async _fetchWithErrorHandling(url: string, options: any): Promise { + /** Fetch with no key conversion, for payloads carrying user-controlled property names. */ + async _fetchRawJson(url: string, options: any): Promise { const response = await fetch(url, { ...options, headers: { @@ -318,8 +329,11 @@ export default class MemoryClient { const errorData = await response.text(); throw createExceptionFromResponse(response.status, errorData); } - const jsonResponse = await response.json(); - return snakeToCamelKeys(jsonResponse); + return response.json(); + } + + async _fetchWithErrorHandling(url: string, options: any): Promise { + return snakeToCamelKeys(await this._fetchRawJson(url, options)); } _preparePayload( @@ -816,6 +830,192 @@ export default class MemoryClient { return response; } + /** + * Get the memory profile for a single user. + * + * Branch on `status`, not on an empty `profile`: generation is asynchronous, + * so a known user without a profile yet is a normal response. + */ + async getProfile(data: { entityId: string }): Promise { + this._captureEvent("get_profile", []); + await this._awaitIdentity(); + + const response = await this._fetchWithErrorHandling( + `${this.host}/v2/entities/user/${encodeURIComponent(data.entityId)}/profile/`, + { + headers: this.headers, + }, + ); + return response; + } + + /** + * Generate or refresh the profile for one user, now. + * + * Profiles are otherwise built once a user crosses an internal message + * threshold, so a new user has none for its first few memories. Returns as + * soon as the work is queued: poll {@link getProfile} and branch on `status`. + * + * Pass `idempotencyKey` and reuse it to retry a lost request without starting + * (and being billed for) a second job. + */ + async generateProfile(data: { + entityId: string; + idempotencyKey?: string; + }): Promise { + this._captureEvent("generate_profile", []); + await this._awaitIdentity(); + + const response = await this._fetchWithErrorHandling( + `${this.host}${PROFILE_JOBS_PATH}`, + { + method: "POST", + headers: { + ...this.headers, + "Idempotency-Key": data.idempotencyKey ?? uuidv7(), + }, + body: JSON.stringify({ + operation: "trigger", + entity_type: "user", + entity_id: data.entityId, + }), + }, + ); + return response; + } + + /** Get the profile settings for the current project. */ + async getProfileSettings(): Promise { + this._captureEvent("get_profile_settings", []); + await this._awaitIdentity(); + + const raw = await this._fetchRawJson(`${this.host}/v2/profiles/settings/`, { + headers: this.headers, + }); + return this._settingsWithVerbatimSchema(raw); + } + + /** + * The envelope keys are ours; the schema's property names are the customer's. + * + * Each entity type carries its own schema, so every one has to be restored + * from the raw body — otherwise camel-casing rewrites the customer's field + * names and a profile comes back under keys they never chose. + */ + private _settingsWithVerbatimSchema(raw: any): ProfileSettingsResponse { + const settings = snakeToCamelKeys(raw) as ProfileSettingsResponse; + if (!raw || typeof raw !== "object") { + return settings; + } + + const rawEntities = raw.entities; + if (rawEntities && typeof rawEntities === "object") { + for (const [entityType, entitySettings] of Object.entries(rawEntities)) { + if ( + entitySettings && + typeof entitySettings === "object" && + "schema" in entitySettings && + settings.entities?.[entityType as ProfileEntityType] + ) { + settings.entities[entityType as ProfileEntityType]!.schema = ( + entitySettings as Record + ).schema; + } + } + } + + return settings; + } + + /** + * Update profile settings. Only the fields you pass are written. + * + * `schema` and `customInstructions` are per user and are nested under + * `entities` for the API; only `enabled` is project-wide. Sending them flat + * is rejected with `Unsupported settings`. + */ + async updateProfileSettings( + settings: ProfileSettings, + ): Promise { + const payloadKeys = Object.keys(settings || {}); + this._captureEvent("update_profile_settings", [payloadKeys]); + await this._awaitIdentity(); + + const { schema, customInstructions, enabled } = settings || {}; + + const body: Record = {}; + if (enabled !== undefined) { + body.enabled = enabled; + } + + const entitySettings: Record = {}; + // The schema's property names are the customer's and must reach the API verbatim. + if (schema !== undefined) { + entitySettings.schema = schema; + } + if (customInstructions !== undefined) { + entitySettings.custom_instructions = customInstructions; + } + if (Object.keys(entitySettings).length > 0) { + body.entities = { user: entitySettings }; + } + + const raw = await this._fetchRawJson(`${this.host}/v2/profiles/settings/`, { + method: "POST", + headers: this.headers, + body: JSON.stringify(body), + }); + return this._settingsWithVerbatimSchema(raw); + } + + /** + * Generate profiles for a few real users, to check a schema. + * + * Real generations against real memories, and the results are kept: the + * profiles are written to those users and count toward usage. + */ + async sampleProfiles(data?: { + limit?: number; + idempotencyKey?: string; + }): Promise { + this._captureEvent("sample_profiles", []); + await this._awaitIdentity(); + + const response = await this._fetchWithErrorHandling( + `${this.host}${PROFILE_JOBS_PATH}`, + { + method: "POST", + headers: { + ...this.headers, + "Idempotency-Key": data?.idempotencyKey ?? uuidv7(), + }, + body: JSON.stringify({ + operation: "sample", + // Required: the API refuses a job that does not name an entity kind. + entity_type: "user", + ...this._prepareParams({ limit: data?.limit }), + }), + }, + ); + return response; + } + + /** + * Read one generation job. Accepts the `statusUrl` from a create call, or a + * bare job id. Prefer `statusUrl` so a route change needs no client update. + */ + async getProfileJob(jobIdOrStatusUrl: string): Promise { + await this._awaitIdentity(); + + const path = jobIdOrStatusUrl.startsWith("/") + ? jobIdOrStatusUrl + : `${PROFILE_JOBS_PATH}${jobIdOrStatusUrl}/`; + return this._fetchWithErrorHandling(`${this.host}${path}`, { + method: "GET", + headers: this.headers, + }); + } + async createMemoryExport( data: CreateMemoryExportPayload, ): Promise<{ message: string; id: string }> { diff --git a/mem0-ts/src/client/mem0.types.ts b/mem0-ts/src/client/mem0.types.ts index cbe541321..606cf0daf 100644 --- a/mem0-ts/src/client/mem0.types.ts +++ b/mem0-ts/src/client/mem0.types.ts @@ -239,3 +239,98 @@ export interface GetMemoryExportPayload { filters?: Record; memoryExportId?: string; } + +// ─── Profile Types ────────────────────────────────────────── + +/** The entity kind that carries a profile. */ +export type ProfileEntityType = "user"; + +/** + * `succeeded` is the only state in which `profile` is guaranteed to hold content. + * + * These are values, not keys, so the client does not camel-case them: the wire + * spelling is what a comparison has to match. + */ +export type ProfileStatus = + | "succeeded" + | "pending" + | "failed" + | "not_enabled" + | "insufficient_data"; + +export interface ProfileResponse { + /** Shaped by the project's schema; keys are not camel-cased. */ + profile: Record; + status: ProfileStatus; + entityType: ProfileEntityType; + entityId: string; + updatedAt: string | null; + generationCount: number; + /** The last generation's failure reason, when `status` is `failed`. */ + error?: string | null; +} + +/** Every accepted generation. `statusUrl` is the server's own poll path. */ +export interface ProfileJobResponse { + jobId: string; + status: string; + statusUrl: string; + operation: string; + entityType: ProfileEntityType; + /** Entities reserved against usage for this job. */ + entityCountReserved?: number; + /** Null when the job has no associated event. */ + eventId?: string | null; + replayed?: boolean; + /** Sample runs only: how many entities were picked. */ + sampled?: number; + /** Sample runs only: the entity ids picked. Read each one with `getProfile`. */ + entityIds?: string[]; +} + +/** The settings to write. `schema` and `customInstructions` apply to user profiles. */ +export interface ProfileSettings { + /** Turn profile generation on or off. Project-wide. */ + enabled?: boolean; + /** JSON Schema for the profile. Every property needs a `description`. */ + schema?: Record | null; + customInstructions?: string | null; +} + +/** One entity type's stored configuration. */ +export interface EntityProfileSettings { + /** The customer's JSON Schema, with its property names verbatim. */ + schema?: Record | null; + customInstructions?: string | null; + [key: string]: any; +} + +/** + * The settings as stored. `schema` and `customInstructions` are per entity + * type and nest under `entities`; only `enabled` is project-wide. + */ +export interface ProfileSettingsResponse { + enabled?: boolean; + entities?: Partial>; + capabilities?: Record; + [key: string]: any; +} + +/** `GET /v2/profiles/jobs/{id}/`. The job nests under `job`. */ +export interface ProfileJobStatus { + job: { + id: string; + operation: string; + entityType: ProfileEntityType; + status: string; + /** Null until `enumerationComplete`. */ + total: number | null; + enumerationComplete: boolean; + /** succeeded + failed + skipped. */ + completed: number; + succeeded: number; + failed: number; + skipped: number; + [key: string]: any; + }; +} diff --git a/mem0-ts/src/client/tests/memoryClient.profiles.test.ts b/mem0-ts/src/client/tests/memoryClient.profiles.test.ts new file mode 100644 index 000000000..27069a570 --- /dev/null +++ b/mem0-ts/src/client/tests/memoryClient.profiles.test.ts @@ -0,0 +1,341 @@ +/** + * MemoryClient unit tests — profiles. + * Verifies request construction and the verbatim round-trip of user-controlled + * profile/schema keys, not mock response echo. + */ +import { MemoryClient } from "../mem0"; +import type { ProfileStatus } from "../mem0.types"; +import { TEST_API_KEY } from "./helpers"; +import { + setupMockFetch, + findFetchCall, + getFetchBody, + installConsoleSuppression, +} from "./setup"; + +installConsoleSuppression(); + +describe("MemoryClient - getProfile()", () => { + test("reads the v2 entity route and keeps profile keys verbatim", async () => { + const extra = new Map(); + extra.set("/v2/entities/user/alice/profile/", { + status: 200, + body: { + // Customer schema keys: camel-casing these would break the schema they wrote. + profile: { + favorite_topics: ["hiking"], + work_style: { preferred_hours: "mornings" }, + }, + status: "succeeded", + entity_type: "user", + entity_id: "alice", + updated_at: "2026-02-08T00:00:00Z", + generation_count: 3, + }, + }); + const mock = setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + const result = await client.getProfile({ entityId: "alice" }); + + const call = findFetchCall(mock, "/v2/entities/user/alice/profile/"); + expect(call).toBeDefined(); + + expect(result.profile).toEqual({ + favorite_topics: ["hiking"], + work_style: { preferred_hours: "mornings" }, + }); + expect(result.entityType).toBe("user"); + expect(result.entityId).toBe("alice"); + expect(result.generationCount).toBe(3); + expect(result.status).toBe("succeeded"); + }); + + test("status keeps its wire spelling", async () => { + // A status is a VALUE, not a key, so the client does not camel-case it. + // Declaring the union as `insufficientData` made tsc reject the comparison + // that works and accept one that can never be true. + const extra = new Map(); + extra.set("/v2/entities/user/bob/profile/", { + status: 200, + body: { + profile: {}, + status: "insufficient_data", + entity_type: "user", + entity_id: "bob", + }, + }); + setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + const result = await client.getProfile({ entityId: "bob" }); + + expect(result.status).toBe("insufficient_data"); + // Assignable without a cast: the declared union must contain the wire value. + const status: ProfileStatus = result.status; + expect(status).not.toBe("insufficientData"); + }); + + test("scopes to user and encodes the entity id", async () => { + const extra = new Map(); + extra.set("/v2/entities/user/", { + status: 200, + body: { profile: {}, status: "pending", entity_type: "user" }, + }); + const mock = setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + await client.getProfile({ entityId: "a/b" }); + + const call = findFetchCall(mock, "/v2/entities/user/a%2Fb/profile/"); + expect(call).toBeDefined(); + }); +}); + +describe("MemoryClient - generateProfile()", () => { + test("sends operation trigger with the entity to the jobs collection", async () => { + const extra = new Map(); + extra.set("/v2/profiles/jobs/", { + status: 202, + body: { + job_id: "00000000-0000-7000-8000-000000000001", + status: "QUEUED", + status_url: "/v2/profiles/jobs/00000000-0000-7000-8000-000000000001/", + operation: "trigger", + entity_type: "user", + entity_count_reserved: 1, + event_id: "00000000-0000-7000-8000-000000000002", + replayed: false, + }, + }); + const mock = setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + const result = await client.generateProfile({ entityId: "alice" }); + + const call = findFetchCall(mock, "/v2/profiles/jobs/", "POST"); + expect(call).toBeDefined(); + const body = getFetchBody(call!); + expect(body.operation).toBe("trigger"); + expect(body.entity_type).toBe("user"); + expect(body.entity_id).toBe("alice"); + // A generated Idempotency-Key is always sent so the create can be retried safely. + const headers = call![1].headers as Record; + expect(headers["Idempotency-Key"]).toBeTruthy(); + expect(result.jobId).toBe("00000000-0000-7000-8000-000000000001"); + expect(result.statusUrl).toBe( + "/v2/profiles/jobs/00000000-0000-7000-8000-000000000001/", + ); + expect(result.replayed).toBe(false); + }); + + test("reuses a caller-supplied idempotency key", async () => { + const extra = new Map(); + extra.set("/v2/profiles/jobs/", { + status: 202, + body: { + job_id: "j1", + status: "QUEUED", + status_url: "/v2/profiles/jobs/j1/", + operation: "trigger", + entity_type: "user", + }, + }); + const mock = setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + await client.generateProfile({ + entityId: "alice", + idempotencyKey: "retry-key-123", + }); + + const call = findFetchCall(mock, "/v2/profiles/jobs/", "POST"); + const headers = call![1].headers as Record; + expect(headers["Idempotency-Key"]).toBe("retry-key-123"); + }); +}); + +describe("MemoryClient - profile settings", () => { + test("sends schema property names verbatim and returns them unchanged", async () => { + const schema = { + type: "object", + properties: { + favorite_topics: { + type: "array", + description: "Topics the user returns to", + items: { type: "string" }, + }, + workStyle: { + type: "string", + description: "How the user prefers to work", + }, + }, + }; + + const extra = new Map(); + extra.set("/v2/profiles/settings/", { + status: 200, + body: { + enabled: true, + entities: { + user: { + schema, + custom_instructions: "Focus on durable preferences", + }, + }, + }, + }); + const mock = setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + const result = await client.updateProfileSettings({ + enabled: true, + schema, + customInstructions: "Focus on durable preferences", + }); + + const call = findFetchCall(mock, "/v2/profiles/settings/", "POST"); + expect(call).toBeDefined(); + const body = getFetchBody(call!); + + // Mixed casing goes out exactly as written, nested under the entity type. + // Exact, not a subset match: the customer's keys must go out unchanged. + expect(body.entities).toEqual({ + user: { schema, custom_instructions: "Focus on durable preferences" }, + }); + expect(body.enabled).toBe(true); + // A flat schema is rejected by the API with "Unsupported settings". + expect("schema" in body).toBe(false); + + // And the customer's property names survive the round trip. + expect(result.entities?.user?.schema).toEqual(schema); + expect(result.entities?.user?.customInstructions).toBe( + "Focus on durable preferences", + ); + }); + + test("scopes entity-level settings under user", async () => { + const extra = new Map(); + extra.set("/v2/profiles/settings/", { + status: 200, + body: { enabled: true }, + }); + const mock = setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + await client.updateProfileSettings({ + schema: { type: "object", properties: {} }, + }); + + const body = getFetchBody( + findFetchCall(mock, "/v2/profiles/settings/", "POST")!, + ); + expect(Object.keys(body.entities as object)).toEqual(["user"]); + }); + + test("omits fields the caller did not set", async () => { + const extra = new Map(); + extra.set("/v2/profiles/settings/", { + status: 200, + body: { + enabled: false, + entities: { user: { schema: null, custom_instructions: null } }, + }, + }); + const mock = setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + await client.updateProfileSettings({ enabled: false }); + + const call = findFetchCall(mock, "/v2/profiles/settings/", "POST"); + const body = getFetchBody(call!); + expect(body.enabled).toBe(false); + // Nothing entity-scoped was passed, so no entities key is sent at all. + expect("entities" in body).toBe(false); + expect("schema" in body).toBe(false); + expect("custom_instructions" in body).toBe(false); + }); + + test("getProfileSettings reads the v2 route", async () => { + const extra = new Map(); + extra.set("/v2/profiles/settings/", { + status: 200, + body: { + enabled: true, + entities: { + user: { + schema: { properties: { favorite_topics: { type: "array" } } }, + custom_instructions: null, + }, + }, + capabilities: { full_rebuild: false }, + }, + }); + const mock = setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + const result = await client.getProfileSettings(); + + expect(findFetchCall(mock, "/v2/profiles/settings/")).toBeDefined(); + expect(result.enabled).toBe(true); + expect(result.entities?.user?.schema).toEqual({ + properties: { favorite_topics: { type: "array" } }, + }); + expect(result.capabilities?.fullRebuild).toBe(false); + }); +}); + +describe("MemoryClient - sampleProfiles()", () => { + test("sampleProfiles omits limit when unset", async () => { + const extra = new Map(); + extra.set("/v2/profiles/jobs/", { + status: 202, + body: { + job_id: "job_1", + status: "QUEUED", + status_url: "/v2/profiles/jobs/job_1/", + operation: "sample", + entity_type: "user", + sampled: 5, + results: [], + }, + }); + const mock = setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + await client.sampleProfiles(); + + const call = findFetchCall(mock, "/v2/profiles/jobs/", "POST"); + // Every job names an entity kind: the API refuses one that does not. + expect(getFetchBody(call!)).toEqual({ + operation: "sample", + entity_type: "user", + }); + }); + + test("sampleProfiles passes an explicit limit", async () => { + const extra = new Map(); + extra.set("/v2/profiles/jobs/", { + status: 202, + body: { + job_id: "job_2", + status: "QUEUED", + status_url: "/v2/profiles/jobs/job_2/", + operation: "sample", + entity_type: "user", + sampled: 3, + results: [], + }, + }); + const mock = setupMockFetch(extra); + + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + const result = await client.sampleProfiles({ limit: 3 }); + + const call = findFetchCall(mock, "/v2/profiles/jobs/", "POST"); + expect(getFetchBody(call!).operation).toBe("sample"); + expect(getFetchBody(call!).limit).toBe(3); + expect(getFetchBody(call!).entity_type).toBe("user"); + expect(result.sampled).toBe(3); + }); +}); diff --git a/mem0-ts/src/client/utils.ts b/mem0-ts/src/client/utils.ts index aca9ffbcd..8630ad470 100644 --- a/mem0-ts/src/client/utils.ts +++ b/mem0-ts/src/client/utils.ts @@ -34,6 +34,9 @@ const OPAQUE_VALUE_KEYS = new Set([ // (see issue #5738; same class as `metadata`/`structuredDataSchema`). "customCategories", "custom_categories", + // A profile's keys come from the customer's own JSON Schema. The schema itself + // is handled in `updateProfileSettings`, so that `schema` is not opaque globally. + "profile", ]); /** diff --git a/mem0/client/main.py b/mem0/client/main.py index 3a82d9e5a..d65d4f0b1 100644 --- a/mem0/client/main.py +++ b/mem0/client/main.py @@ -1,6 +1,7 @@ import hashlib import logging import os +import uuid import warnings from typing import Any, Dict, List, Optional from urllib.parse import quote @@ -39,6 +40,43 @@ setup_config() # Entity parameters that must be passed via filters, not top-level ENTITY_PARAMS = frozenset({"user_id", "agent_id", "app_id", "run_id"}) +# One collection for every generation; the operation is a body field. +PROFILE_JOBS_PATH = "/v2/profiles/jobs/" +PROFILE_SETTINGS_PATH = "/v2/profiles/settings/" + +# Distinguishes an omitted argument from an explicit ``None`` that clears a field. +_UNSET: Any = object() + + +def _profile_settings_payload( + enabled: Optional[bool], + schema: Any = _UNSET, + custom_instructions: Any = _UNSET, +) -> Dict[str, Any]: + """Build the settings body the API accepts. + + ``schema`` and ``custom_instructions`` are per user and nest under + ``entities``; only ``enabled`` is project-wide. This mirrors what + ``get_profile_settings`` returns, so the two round-trip. + + Sending them flat is rejected with ``Unsupported settings``, so this shape is + not cosmetic. ``_UNSET`` leaves a field unchanged; an explicit ``None`` clears it. + """ + + payload: Dict[str, Any] = {} + if enabled is not None: + payload["enabled"] = enabled + + entity_settings: Dict[str, Any] = {} + if schema is not _UNSET: + entity_settings["schema"] = schema + if custom_instructions is not _UNSET: + entity_settings["custom_instructions"] = custom_instructions + + if entity_settings: + payload["entities"] = {"user": entity_settings} + return payload + def _validate_and_trim_search_query(query: str) -> str: if not isinstance(query, str): @@ -452,7 +490,9 @@ class MemoryClient: payload = {k: v for k, v in payload.items() if v is not None or k == "expiration_date"} if not payload: - raise ValueError("At least one of text, metadata, timestamp, or expiration_date must be provided for update.") + raise ValueError( + "At least one of text, metadata, timestamp, or expiration_date must be provided for update." + ) capture_client_event("client.update", self, {"memory_id": memory_id, "sync_type": "sync"}) params = self._prepare_params() @@ -763,6 +803,174 @@ class MemoryClient: capture_client_event("client.get_summary", self, {"sync_type": "sync"}) return response.json() + @api_error_handler + def get_profile(self, entity_id: str) -> Dict[str, Any]: + """Get the memory profile for a single user. + + Branch on ``status``, not on an empty ``profile``: generation is + asynchronous, so a known user without a profile yet is a normal response. + + Args: + entity_id: The user's id, as you supplied it on ``add`` (e.g. "alice"). + + Returns: + Dict with ``profile``, ``status``, ``entity_type``, ``entity_id``, + ``updated_at`` and ``generation_count``. ``status`` is one of + "succeeded", "pending", "failed", "not_enabled" or "insufficient_data". + + Raises: + AuthenticationError: If authentication fails. + NotFoundError: If no such user exists in the project. + """ + + response = self.client.get(f"/v2/entities/user/{_encode_path_segment(entity_id)}/profile/") + response.raise_for_status() + capture_client_event("client.get_profile", self, {"sync_type": "sync"}) + return response.json() + + @api_error_handler + def generate_profile(self, entity_id: str, idempotency_key: Optional[str] = None) -> Dict[str, Any]: + """Generate or refresh the profile for a single user, now. + + Profiles are otherwise built once a user crosses an internal message + threshold, so a new user has none for its first few memories. Returns as + soon as the work is queued: poll :meth:`get_profile` and branch on ``status``. + + Args: + entity_id: The user's id, as you supplied it on ``add``. + idempotency_key: Optional key that makes the create idempotent. Reuse + the same value to safely retry a lost request without starting + (and being billed for) a second job. A fresh key is generated when + omitted. + + Returns: + Dict containing ``job_id``, ``status``, ``status_url``, ``operation``, + ``entity_type``, ``entity_count_reserved``, ``event_id`` and + ``replayed``. Poll :meth:`get_profile` and branch on ``status``. + + Raises: + ValidationError: If profiles are not enabled and configured for the + project. + NotFoundError: If no such user exists in the project. + """ + + response = self.client.post( + PROFILE_JOBS_PATH, + json={"operation": "trigger", "entity_type": "user", "entity_id": entity_id}, + headers={"Idempotency-Key": idempotency_key or uuid.uuid4().hex}, + ) + response.raise_for_status() + capture_client_event("client.generate_profile", self, {"sync_type": "sync"}) + return response.json() + + @api_error_handler + def get_profile_settings(self) -> Dict[str, Any]: + """Get the profile settings for the current project. + + Returns: + Dict with ``enabled`` and ``capabilities`` at the top level, and + ``entities`` holding each entity type's ``schema`` and + ``custom_instructions``. + """ + + response = self.client.get(PROFILE_SETTINGS_PATH) + response.raise_for_status() + capture_client_event("client.get_profile_settings", self, {"sync_type": "sync"}) + return response.json() + + @api_error_handler + def update_profile_settings( + self, + enabled: Optional[bool] = None, + schema: Any = _UNSET, + custom_instructions: Any = _UNSET, + ) -> Dict[str, Any]: + """Update the profile settings for the current project. + + Only the arguments you pass are written. + + Args: + enabled: Turn profile generation on or off. Project-wide. + schema: JSON Schema for the profile. Every property needs a + ``description``. Pass ``None`` to clear it; omit to leave it + unchanged. Applies to user profiles. + custom_instructions: Extra guidance for the extraction step. Pass + ``None`` to clear it; omit to leave it unchanged. Applies to user + profiles. + + Returns: + Dict with the settings as stored after the update, in the same + shape :meth:`get_profile_settings` returns. + + Raises: + ValidationError: If the schema is not a valid profile schema. + """ + + payload = _profile_settings_payload(enabled, schema, custom_instructions) + response = self.client.post(PROFILE_SETTINGS_PATH, json=payload) + response.raise_for_status() + capture_client_event( + "client.update_profile_settings", + self, + {"keys": list(payload.keys()), "sync_type": "sync"}, + ) + return response.json() + + @api_error_handler + def sample_profiles(self, limit: Optional[int] = None, idempotency_key: Optional[str] = None) -> Dict[str, Any]: + """Generate profiles for a few real users, to check a schema. + + Real generations against real memories, and the results are kept. The + profiles are written to those users and count toward usage. + + Args: + limit: How many users to sample, 1-10. Defaults to the server value. + idempotency_key: Optional key that makes the create idempotent. Reuse + the same value to safely retry without starting a second sample + run. A fresh key is generated when omitted. + + Returns: + Dict containing ``job_id``, ``status``, ``status_url``, ``sampled`` + and the ``entity_ids`` that were picked. Poll + :meth:`get_profile_job` with ``status_url`` until the status is terminal. + + Raises: + ValidationError: If profiles are not enabled and configured. + RateLimitError: If a sample run was already started very recently. + """ + + payload = self._prepare_params({"limit": limit}) + payload["operation"] = "sample" + payload["entity_type"] = "user" + response = self.client.post( + PROFILE_JOBS_PATH, + json=payload, + headers={"Idempotency-Key": idempotency_key or uuid.uuid4().hex}, + ) + response.raise_for_status() + capture_client_event("client.sample_profiles", self, {"sync_type": "sync"}) + return response.json() + + @api_error_handler + def get_profile_job(self, job_id_or_status_url: str) -> Dict[str, Any]: + """Read one generation job. + + Accepts the ``status_url`` from a create call, or a bare job id. Prefer + passing ``status_url`` so a route change needs no client update. + + Returns: + Dict whose ``job`` key holds the job: ``status``, ``total``, + ``completed``, ``succeeded``, ``failed`` and ``skipped``. ``total`` is + null until ``enumeration_complete``. + """ + + path = job_id_or_status_url + if not path.startswith("/"): + path = f"{PROFILE_JOBS_PATH}{path}/" + response = self.client.get(path) + response.raise_for_status() + return response.json() + @api_error_handler def get_project(self, fields: Optional[List[str]] = None) -> Dict[str, Any]: """Get instructions or categories for the current project. @@ -1361,7 +1569,9 @@ class AsyncMemoryClient: payload = {k: v for k, v in payload.items() if v is not None or k == "expiration_date"} if not payload: - raise ValueError("At least one of text, metadata, timestamp, or expiration_date must be provided for update.") + raise ValueError( + "At least one of text, metadata, timestamp, or expiration_date must be provided for update." + ) capture_client_event("client.update", self, {"memory_id": memory_id, "sync_type": "async"}) params = self._prepare_params() @@ -1658,6 +1868,176 @@ class AsyncMemoryClient: capture_client_event("client.get_summary", self, {"sync_type": "async"}) return response.json() + @api_error_handler + async def get_profile(self, entity_id: str) -> Dict[str, Any]: + """Get the memory profile for a single user. + + Branch on ``status``, not on an empty ``profile``: generation is + asynchronous, so a known user without a profile yet is a normal response. + + Args: + entity_id: The user's id, as you supplied it on ``add`` (e.g. "alice"). + + Returns: + Dict with ``profile``, ``status``, ``entity_type``, ``entity_id``, + ``updated_at`` and ``generation_count``. ``status`` is one of + "succeeded", "pending", "failed", "not_enabled" or "insufficient_data". + + Raises: + AuthenticationError: If authentication fails. + NotFoundError: If no such user exists in the project. + """ + + response = await self.async_client.get(f"/v2/entities/user/{_encode_path_segment(entity_id)}/profile/") + response.raise_for_status() + capture_client_event("client.get_profile", self, {"sync_type": "async"}) + return response.json() + + @api_error_handler + async def generate_profile(self, entity_id: str, idempotency_key: Optional[str] = None) -> Dict[str, Any]: + """Generate or refresh the profile for a single user, now. + + Profiles are otherwise built once a user crosses an internal message + threshold, so a new user has none for its first few memories. Returns as + soon as the work is queued: poll :meth:`get_profile` and branch on ``status``. + + Args: + entity_id: The user's id, as you supplied it on ``add``. + idempotency_key: Optional key that makes the create idempotent. Reuse + the same value to safely retry a lost request without starting + (and being billed for) a second job. A fresh key is generated when + omitted. + + Returns: + Dict containing ``job_id``, ``status``, ``status_url``, ``operation``, + ``entity_type``, ``entity_count_reserved``, ``event_id`` and + ``replayed``. Poll :meth:`get_profile` and branch on ``status``. + + Raises: + ValidationError: If profiles are not enabled and configured for the + project. + NotFoundError: If no such user exists in the project. + """ + + response = await self.async_client.post( + PROFILE_JOBS_PATH, + json={"operation": "trigger", "entity_type": "user", "entity_id": entity_id}, + headers={"Idempotency-Key": idempotency_key or uuid.uuid4().hex}, + ) + response.raise_for_status() + capture_client_event("client.generate_profile", self, {"sync_type": "async"}) + return response.json() + + @api_error_handler + async def get_profile_settings(self) -> Dict[str, Any]: + """Get the profile settings for the current project. + + Returns: + Dict with ``enabled`` and ``capabilities`` at the top level, and + ``entities`` holding each entity type's ``schema`` and + ``custom_instructions``. + """ + + response = await self.async_client.get(PROFILE_SETTINGS_PATH) + response.raise_for_status() + capture_client_event("client.get_profile_settings", self, {"sync_type": "async"}) + return response.json() + + @api_error_handler + async def update_profile_settings( + self, + enabled: Optional[bool] = None, + schema: Any = _UNSET, + custom_instructions: Any = _UNSET, + ) -> Dict[str, Any]: + """Update the profile settings for the current project. + + Only the arguments you pass are written. + + Args: + enabled: Turn profile generation on or off. Project-wide. + schema: JSON Schema for the profile. Every property needs a + ``description``. Pass ``None`` to clear it; omit to leave it + unchanged. Applies to user profiles. + custom_instructions: Extra guidance for the extraction step. Pass + ``None`` to clear it; omit to leave it unchanged. Applies to user + profiles. + + Returns: + Dict with the settings as stored after the update, in the same + shape :meth:`get_profile_settings` returns. + + Raises: + ValidationError: If the schema is not a valid profile schema. + """ + + payload = _profile_settings_payload(enabled, schema, custom_instructions) + response = await self.async_client.post(PROFILE_SETTINGS_PATH, json=payload) + response.raise_for_status() + capture_client_event( + "client.update_profile_settings", + self, + {"keys": list(payload.keys()), "sync_type": "async"}, + ) + return response.json() + + @api_error_handler + async def sample_profiles( + self, limit: Optional[int] = None, idempotency_key: Optional[str] = None + ) -> Dict[str, Any]: + """Generate profiles for a few real users, to check a schema. + + Real generations against real memories, and the results are kept. The + profiles are written to those users and count toward usage. + + Args: + limit: How many users to sample, 1-10. Defaults to the server value. + idempotency_key: Optional key that makes the create idempotent. Reuse + the same value to safely retry without starting a second sample + run. A fresh key is generated when omitted. + + Returns: + Dict containing ``job_id``, ``status``, ``status_url``, ``sampled`` + and the ``entity_ids`` that were picked. Poll + :meth:`get_profile_job` with ``status_url`` until the status is terminal. + + Raises: + ValidationError: If profiles are not enabled and configured. + RateLimitError: If a sample run was already started very recently. + """ + + payload = self._prepare_params({"limit": limit}) + payload["operation"] = "sample" + payload["entity_type"] = "user" + response = await self.async_client.post( + PROFILE_JOBS_PATH, + json=payload, + headers={"Idempotency-Key": idempotency_key or uuid.uuid4().hex}, + ) + response.raise_for_status() + capture_client_event("client.sample_profiles", self, {"sync_type": "async"}) + return response.json() + + @api_error_handler + async def get_profile_job(self, job_id_or_status_url: str) -> Dict[str, Any]: + """Read one generation job. + + Accepts the ``status_url`` from a create call, or a bare job id. Prefer + passing ``status_url`` so a route change needs no client update. + + Returns: + Dict whose ``job`` key holds the job: ``status``, ``total``, + ``completed``, ``succeeded``, ``failed`` and ``skipped``. ``total`` is + null until ``enumeration_complete``. + """ + + path = job_id_or_status_url + if not path.startswith("/"): + path = f"{PROFILE_JOBS_PATH}{path}/" + response = await self.async_client.get(path) + response.raise_for_status() + return response.json() + @api_error_handler async def get_project(self, fields: Optional[List[str]] = None) -> Dict[str, Any]: """Get instructions or categories for the current project. diff --git a/pyproject.toml b/pyproject.toml index 73c5cdf71..ddb3d7153 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "hatchling.build" [project] name = "mem0ai" -version = "2.1.0" +version = "2.2.0" description = "Long-term memory for AI Agents" authors = [ { name = "Mem0", email = "support@mem0.ai" } diff --git a/tests/test_client_profiles.py b/tests/test_client_profiles.py new file mode 100644 index 000000000..c2ea0eff3 --- /dev/null +++ b/tests/test_client_profiles.py @@ -0,0 +1,272 @@ +"""Tests for the MemoryClient profile methods. + +These assert request construction — path, verb, body — rather than echoing a +mocked response back. The profile payload itself is the customer's own JSON +Schema shape, so the tests also pin that the SDK passes it through untouched. +""" + +import asyncio +from unittest.mock import AsyncMock, MagicMock, patch + +import pytest + + +@pytest.fixture +def mock_memory_client(): + """A MemoryClient whose transport is mocked.""" + with patch("mem0.client.main.httpx.Client") as mock_httpx: + mock_http_client = MagicMock() + mock_http_client.get.return_value = MagicMock( + json=lambda: {"org_id": "org1", "project_id": "proj1", "user_email": "test@test.com"}, + raise_for_status=lambda: None, + ) + mock_httpx.return_value = mock_http_client + + with patch("mem0.client.main.capture_client_event"): + from mem0.client.main import MemoryClient + + client = MemoryClient(api_key="test-api-key") + # The constructor pings through this same mock; drop that call. + mock_http_client.get.reset_mock() + yield client + + +def _assert_job_call(post_mock, expected_json): + """One jobs collection, operation in the body, idempotency key per attempt.""" + post_mock.assert_called_once() + args, kwargs = post_mock.call_args + assert args[0] == "/v2/profiles/jobs/" + assert kwargs["json"] == expected_json + assert kwargs["headers"]["Idempotency-Key"] + + +def _mock_response(payload): + response = MagicMock() + response.json.return_value = payload + response.raise_for_status.return_value = None + return response + + +class TestGetProfile: + def test_reads_the_v2_entity_route(self, mock_memory_client): + mock_memory_client.client.get.return_value = _mock_response( + {"profile": {}, "status": "pending", "entity_type": "user", "entity_id": "alice"} + ) + + mock_memory_client.get_profile("alice") + + mock_memory_client.client.get.assert_called_once_with("/v2/entities/user/alice/profile/") + + def test_encodes_path_segments(self, mock_memory_client): + """An id with a slash must not open a new path segment.""" + mock_memory_client.client.get.return_value = _mock_response({"profile": {}, "status": "pending"}) + + mock_memory_client.get_profile("tenant/alice") + + mock_memory_client.client.get.assert_called_once_with("/v2/entities/user/tenant%2Falice/profile/") + + def test_returns_the_envelope_verbatim(self, mock_memory_client): + """The customer's schema keys reach the caller exactly as stored.""" + payload = { + "profile": {"favorite_topics": ["hiking"], "work_style": {"preferred_hours": "mornings"}}, + "status": "succeeded", + "entity_type": "user", + "entity_id": "alice", + "updated_at": "2026-02-08T00:00:00Z", + "generation_count": 3, + } + mock_memory_client.client.get.return_value = _mock_response(payload) + + assert mock_memory_client.get_profile("alice") == payload + + +class TestGenerateProfile: + def test_posts_entity_type_and_id(self, mock_memory_client): + mock_memory_client.client.post.return_value = _mock_response( + {"job_id": "j1", "status": "QUEUED", "status_url": "/v2/profiles/jobs/j1/"} + ) + + mock_memory_client.generate_profile("alice") + + _assert_job_call( + mock_memory_client.client.post, + {"operation": "trigger", "entity_type": "user", "entity_id": "alice"}, + ) + + def test_reuses_caller_idempotency_key(self, mock_memory_client): + """A caller-supplied key lets a retry hit the same job instead of billing twice.""" + mock_memory_client.client.post.return_value = _mock_response({"job_id": "j1", "status": "QUEUED"}) + + mock_memory_client.generate_profile("alice", idempotency_key="retry-key-123") + + _, kwargs = mock_memory_client.client.post.call_args + assert kwargs["headers"]["Idempotency-Key"] == "retry-key-123" + + +class TestProfileSettings: + def test_get_reads_v2(self, mock_memory_client): + mock_memory_client.client.get.return_value = _mock_response( + {"enabled": True, "entities": {"user": {"schema": None, "custom_instructions": None}}} + ) + + mock_memory_client.get_profile_settings() + + mock_memory_client.client.get.assert_called_once_with("/v2/profiles/settings/") + + def test_update_sends_only_supplied_fields(self, mock_memory_client): + """A partial update must not blank the fields it never mentions.""" + mock_memory_client.client.post.return_value = _mock_response({"enabled": False}) + + mock_memory_client.update_profile_settings(enabled=False) + + mock_memory_client.client.post.assert_called_once_with( + "/v2/profiles/settings/", + json={"enabled": False}, + ) + + def test_update_nests_schema_under_entities(self, mock_memory_client): + """The API takes only ``enabled`` and ``entities`` at the top level. + + A flat body is rejected with ``Unsupported settings``, so this nesting is + what makes the call work at all. + """ + schema = {"type": "object", "properties": {"x": {"type": "string", "description": "d"}}} + mock_memory_client.client.post.return_value = _mock_response({"enabled": True}) + + mock_memory_client.update_profile_settings(enabled=True, schema=schema) + + _, kwargs = mock_memory_client.client.post.call_args + assert set(kwargs["json"]) == {"enabled", "entities"} + assert "schema" not in kwargs["json"] + + def test_update_targets_the_user_entity_type(self, mock_memory_client): + schema = {"type": "object", "properties": {"x": {"type": "string", "description": "d"}}} + mock_memory_client.client.post.return_value = _mock_response({"enabled": True}) + + mock_memory_client.update_profile_settings(schema=schema) + + _, kwargs = mock_memory_client.client.post.call_args + assert kwargs["json"] == {"entities": {"user": {"schema": schema}}} + + def test_update_passes_schema_verbatim(self, mock_memory_client): + schema = { + "type": "object", + "properties": { + "favorite_topics": { + "type": "array", + "description": "Topics the user returns to", + "items": {"type": "string"}, + } + }, + } + mock_memory_client.client.post.return_value = _mock_response({"enabled": True}) + + mock_memory_client.update_profile_settings(enabled=True, schema=schema, custom_instructions="Keep it durable") + + mock_memory_client.client.post.assert_called_once_with( + "/v2/profiles/settings/", + json={ + "enabled": True, + "entities": {"user": {"schema": schema, "custom_instructions": "Keep it durable"}}, + }, + ) + + def test_update_clears_fields_with_explicit_none(self, mock_memory_client): + """Explicit ``None`` clears a field; the sentinel default leaves it untouched.""" + mock_memory_client.client.post.return_value = _mock_response({"enabled": True}) + + mock_memory_client.update_profile_settings(schema=None, custom_instructions=None) + + _, kwargs = mock_memory_client.client.post.call_args + assert kwargs["json"] == {"entities": {"user": {"schema": None, "custom_instructions": None}}} + + +class TestSampleProfiles: + def test_sample_without_limit(self, mock_memory_client): + mock_memory_client.client.post.return_value = _mock_response({"sampled": 5, "entity_ids": []}) + + mock_memory_client.sample_profiles() + + _assert_job_call(mock_memory_client.client.post, {"operation": "sample", "entity_type": "user"}) + + def test_sample_with_limit(self, mock_memory_client): + mock_memory_client.client.post.return_value = _mock_response({"sampled": 3, "entity_ids": []}) + + mock_memory_client.sample_profiles(limit=3) + + _assert_job_call( + mock_memory_client.client.post, + {"operation": "sample", "limit": 3, "entity_type": "user"}, + ) + + +class TestAsyncClientParity: + """The async client must speak the same wire protocol as the sync one.""" + + @pytest.fixture + def async_client(self): + # AsyncMemoryClient validates the key synchronously, through requests. + validation = MagicMock() + validation.json.return_value = { + "org_id": "org1", + "project_id": "proj1", + "user_email": "test@test.com", + } + validation.raise_for_status.return_value = None + + with patch("mem0.client.main.httpx.AsyncClient") as mock_httpx: + mock_httpx.return_value = MagicMock() + with patch("mem0.client.main.requests.get", return_value=validation): + with patch("mem0.client.main.capture_client_event"): + from mem0.client.main import AsyncMemoryClient + + yield AsyncMemoryClient(api_key="test-api-key") + + def test_get_profile(self, async_client): + async_client.async_client.get = AsyncMock(return_value=_mock_response({"profile": {}, "status": "pending"})) + + asyncio.run(async_client.get_profile("alice")) + + async_client.async_client.get.assert_called_once_with("/v2/entities/user/alice/profile/") + + def test_generate_profile(self, async_client): + async_client.async_client.post = AsyncMock(return_value=_mock_response({"job_id": "j1", "status": "QUEUED"})) + + asyncio.run(async_client.generate_profile("alice")) + + _assert_job_call( + async_client.async_client.post, + {"operation": "trigger", "entity_type": "user", "entity_id": "alice"}, + ) + + def test_update_settings_partial(self, async_client): + async_client.async_client.post = AsyncMock(return_value=_mock_response({"enabled": True})) + + asyncio.run(async_client.update_profile_settings(enabled=True)) + + async_client.async_client.post.assert_called_once_with( + "/v2/profiles/settings/", + json={"enabled": True}, + ) + + def test_update_settings_nests_schema(self, async_client): + """The async client builds the same body as the sync one.""" + schema = {"type": "object", "properties": {"x": {"type": "string", "description": "d"}}} + async_client.async_client.post = AsyncMock(return_value=_mock_response({"enabled": True})) + + asyncio.run(async_client.update_profile_settings(enabled=True, schema=schema)) + + async_client.async_client.post.assert_called_once_with( + "/v2/profiles/settings/", + json={"enabled": True, "entities": {"user": {"schema": schema}}}, + ) + + def test_update_settings_clears_with_none(self, async_client): + async_client.async_client.post = AsyncMock(return_value=_mock_response({"enabled": True})) + + asyncio.run(async_client.update_profile_settings(custom_instructions=None)) + + async_client.async_client.post.assert_called_once_with( + "/v2/profiles/settings/", + json={"entities": {"user": {"custom_instructions": None}}}, + ) From 47a69e1e72dc562b6fdd49a9ef892229afc7508a Mon Sep 17 00:00:00 2001 From: Kartik Date: Thu, 24 Sep 2026 00:30:19 +0530 Subject: [PATCH 26/55] docs(changelog): add v2.2.1 entry for Valkey None-timestamps fix (#7425) --- docs/changelog/sdk.mdx | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docs/changelog/sdk.mdx b/docs/changelog/sdk.mdx index bf53c5d31..3f4a64202 100644 --- a/docs/changelog/sdk.mdx +++ b/docs/changelog/sdk.mdx @@ -12,6 +12,9 @@ mode: "wide" **New Features:** - **Client:** Add User Profiles to `MemoryClient` and `AsyncMemoryClient`: `get_profile()`, `generate_profile()`, `get_profile_settings()`, `update_profile_settings()`, `sample_profiles()`, and `get_profile_job()`. A profile is a structured, always-current JSON summary of one user, shaped by a JSON Schema you configure per project and filled by an LLM from that user's memories. Generation is asynchronous. Every job POST carries an `Idempotency-Key`; to retry a lost request without starting a second job, pass the same `idempotency_key` on each attempt ([#7340](https://github.com/mem0ai/mem0/pull/7340)) +**Bug Fixes:** +- **Vector Stores:** Guard against `None` timestamps in the Valkey vector store's `insert()` and `update()` paths. `created_at` and `updated_at` fields that were present in the payload but set to `None` previously passed the `"created_at" not in payload` / `"updated_at" in payload` checks and raised `TypeError` when `datetime.fromisoformat()` received `None`. Both paths now use `.get()` with a truthiness check so `None` values fall through to the default, matching the Redis provider's behavior ([#6993](https://github.com/mem0ai/mem0/pull/6993)) + From 43849c6e9d4d773b83a8144b6373aedc67241a5d Mon Sep 17 00:00:00 2001 From: Kartik Date: Thu, 24 Sep 2026 17:53:29 +0530 Subject: [PATCH 27/55] feat(integrations): migrate and validate standalone Hermes Mem0 plugin (#7372) --- docs/integrations/hermes.mdx | 208 ++++--- docs/llms.txt | 2 +- integrations/AGENTS.md | 1 + integrations/hermes-plugin-mem0/.gitignore | 3 + integrations/hermes-plugin-mem0/LICENSE | 236 ++++++++ integrations/hermes-plugin-mem0/README.md | 131 ++++ integrations/hermes-plugin-mem0/__init__.py | 504 ++++++++++++++++ integrations/hermes-plugin-mem0/_backend.py | 336 +++++++++++ .../hermes-plugin-mem0/_openai_llm.py | 66 ++ .../hermes-plugin-mem0/_oss_providers.py | 53 ++ integrations/hermes-plugin-mem0/_setup.py | 567 ++++++++++++++++++ integrations/hermes-plugin-mem0/plugin.yaml | 5 + .../hermes-plugin-mem0/pyproject.toml | 17 + .../hermes-plugin-mem0/tests/smoke_hermes.py | 178 ++++++ .../hermes-plugin-mem0/tests/test_plugin.py | 286 +++++++++ server/requirements.txt | 2 +- 16 files changed, 2501 insertions(+), 94 deletions(-) create mode 100644 integrations/hermes-plugin-mem0/.gitignore create mode 100644 integrations/hermes-plugin-mem0/LICENSE create mode 100644 integrations/hermes-plugin-mem0/README.md create mode 100644 integrations/hermes-plugin-mem0/__init__.py create mode 100644 integrations/hermes-plugin-mem0/_backend.py create mode 100644 integrations/hermes-plugin-mem0/_openai_llm.py create mode 100644 integrations/hermes-plugin-mem0/_oss_providers.py create mode 100644 integrations/hermes-plugin-mem0/_setup.py create mode 100644 integrations/hermes-plugin-mem0/plugin.yaml create mode 100644 integrations/hermes-plugin-mem0/pyproject.toml create mode 100644 integrations/hermes-plugin-mem0/tests/smoke_hermes.py create mode 100644 integrations/hermes-plugin-mem0/tests/test_plugin.py diff --git a/docs/integrations/hermes.mdx b/docs/integrations/hermes.mdx index 26de7221c..f1d385144 100644 --- a/docs/integrations/hermes.mdx +++ b/docs/integrations/hermes.mdx @@ -1,9 +1,9 @@ --- title: Hermes Agent -description: "Add long-term memory to Hermes agents using Mem0 Platform, a self-hosted server, or local OSS mode with background fact extraction." +description: "Add persistent memory to Hermes Agent with Mem0 Cloud, a self-hosted server, or the in-process OSS SDK." --- -Add long-term memory to [Hermes Agent](https://github.com/NousResearch/hermes-agent), a self-improving AI agent CLI by Nous Research. Hermes has a pluggable memory system, and Mem0 is one of the supported providers. Once enabled, Mem0 learns facts from your conversations and surfaces relevant ones for the current question, without slowing down the chat. +Add long-term memory to [Hermes Agent](https://github.com/NousResearch/hermes-agent), a self-improving AI agent CLI by Nous Research. The [standalone Mem0 plugin](https://github.com/mem0ai/mem0/tree/main/integrations/hermes-plugin-mem0) learns facts from conversations and recalls relevant memories for the current question. You can run Mem0 in three ways: @@ -17,11 +17,15 @@ Hermes runs a built-in memory system (file-based `MEMORY.md` and `USER.md`) alon ### 1. Current-turn recall (bounded wait) -When you send a message, Hermes searches your stored memories for the current question and waits up to 3 seconds for results. If they arrive in time, they are injected into the system prompt so the model can see them. If the backend is slower, Hermes skips the injection and the model can still call `mem0_search` itself — so a slow backend never blocks a turn. +When you send a message, Hermes searches your stored memories for the current question and waits up to 3 seconds for results. If they arrive in time, they are injected into the system prompt so the model can see them. If the backend is slower, Hermes skips the injection and the model can still call `mem0_search` itself after the bounded recall wait. ### 2. Background fact extraction (sync) -Once the model finishes, Hermes sends the `(user message, assistant response)` pair to Mem0 in a background thread. Mem0 extracts facts automatically (for example, "user prefers Python" or "user works at Acme Corp"), so you never have to tell it what to remember. Each write is tagged with the gateway channel it came from. +Once the model finishes, the plugin sends the user message and assistant response to Mem0 in a background thread for fact extraction. Each write includes the agent identifier and gateway channel. + + + Automatic capture truncates each message to **450 characters by default in every mode**, preferring a sentence boundary. Adjust `sync_max_chars` for your model's context limit. Capture is best effort: if the previous sync is still running after a five-second wait, the next turn is skipped. Use `mem0_add` to store specific text verbatim. + ## Agent Tools @@ -29,21 +33,33 @@ When Mem0 is active, the model gets four tools it can call during a conversation | Tool | Description | Parameters | |------|-------------|------------| -| `mem0_search` | Semantic search by meaning, ranked by relevance | `query` (required), `top_k` (default 10, max 50), `rerank` (default `false`, Platform mode only) | +| `mem0_search` | Semantic search by meaning, ranked by relevance | `query` (required), `top_k` (default 10, max 50), `rerank` (uses the configured default, Platform mode only) | | `mem0_add` | Store a fact verbatim, with no LLM extraction | `content` (required) | | `mem0_update` | Update a memory's text by ID | `memory_id`, `text` (both required) | | `mem0_delete` | Delete a memory by ID | `memory_id` (required) | ## Installation -Install Hermes Agent: +Install [Hermes Agent](https://github.com/NousResearch/hermes-agent) with memory-provider plugin support and Python 3.11 or later. Once the plugin directory is available on Mem0's main branch, install it from the repository subdirectory: ```bash -curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash -source ~/.bashrc +hermes plugins install mem0ai/mem0/integrations/hermes-plugin-mem0 +hermes plugins enable mem0 +hermes memory setup +hermes memory status ``` -The `mem0ai` package is installed automatically when you enable the Mem0 provider, so there is no manual pip step. OSS providers may need extra packages (for example `qdrant-client`, `psycopg2-binary`, or `ollama`), which the setup flow installs for you when you pick them. +Select **mem0** in setup and choose one of the modes below. Start a fresh Hermes conversation after setup. + +Hermes installers with plugin dependency support install `mem0ai>=2.0.10,<3` and `httpx>=0.27,<1` from the plugin's `pyproject.toml`. Older hosts such as Hermes v0.21.3 require those packages to be installed explicitly into the Hermes Python environment. The OSS setup flow installs additional provider packages as needed. + + + Hermes versions that still bundle Mem0 prefer the bundled provider. Use a Hermes release that has completed the standalone-provider migration; installing this plugin alone does not replace the bundled implementation. Existing users should keep their current configuration; see [Migration for existing users](#migration-for-existing-users). + + + + Run the setup wizard in an interactive terminal. On Hermes hosts whose `hermes memory setup --help` lists only a provider argument, options such as `--mode`, `--host`, and `--oss-llm` are rejected by Hermes before the plugin runs. Use `hermes memory setup mem0` or the manual configuration below. Redirected input cannot select the mode picker and falls back to Platform. + ## Platform Setup @@ -52,10 +68,10 @@ Platform mode uses managed Mem0 Cloud and is the fastest way to start. ### Option 1: Interactive wizard (recommended) ```bash -hermes memory setup +hermes memory setup mem0 ``` -Select **mem0**, choose **Platform**, and paste your API key when prompted. The wizard writes the non-secret settings to `~/.hermes/mem0.json` and keeps the key in `~/.hermes/.env`. +Choose **Platform** and paste your API key when prompted. The wizard writes settings to `$HERMES_HOME/mem0.json` and keeps the key in that profile's `.env`. The default Hermes home is `~/.hermes`; named profiles use their own home directory. Get your API key from app.mem0.ai. @@ -63,17 +79,25 @@ Select **mem0**, choose **Platform**, and paste your API key when prompted. The ```bash hermes config set memory.provider mem0 -echo "MEM0_API_KEY=your-api-key" >> ~/.hermes/.env ``` -Then in your `config.yaml`: +Add your key to the active Hermes profile's `.env`: -```yaml -memory: - provider: mem0 +```dotenv +MEM0_API_KEY=your-api-key ``` -That's it. Mem0 runs automatically from here. +Set these values in the active profile's `mem0.json`, choosing a stable user identity: + +```json +{ + "mode": "platform", + "host": "", + "user_id": "my-hermes-user" +} +``` + +Remove any stale `MEM0_HOST` from the environment and profile `.env`, and remove an old inline `api_key` from `mem0.json` so the new `.env` key is used. The config command sets `memory.provider: mem0` in that profile's `config.yaml`. Restart Hermes and check `hermes memory status`. ## Self-Hosted Server Setup @@ -82,48 +106,47 @@ Run the [Mem0 server](https://github.com/mem0ai/mem0/tree/main/server) (FastAPI ### Interactive ```bash -hermes memory setup -# Select "mem0", then "Self-hosted server", and enter the server URL +hermes memory setup mem0 +# Choose "Self-hosted server", then enter the server URL and API key ``` -### With flags +### Manual configuration -```bash -hermes memory setup mem0 --mode selfhosted \ - --host http://localhost:8888 \ - --api-key your-admin-api-key +Select `mem0` with `hermes config set memory.provider mem0`. Set these values in the active profile's `mem0.json`: + +```json +{ + "mode": "platform", + "host": "http://localhost:8888", + "user_id": "my-hermes-user" +} ``` -### With environment variables +Add the server key to that profile's `.env`: -```bash -echo "MEM0_HOST=http://localhost:8888" >> ~/.hermes/.env -echo "MEM0_API_KEY=your-admin-api-key" >> ~/.hermes/.env +```dotenv +MEM0_API_KEY=your-admin-api-key ``` +Remove an old inline `api_key` from `mem0.json` so the `.env` key is used. `MEM0_HOST` can also supply the server URL, but a non-empty `host` in `mem0.json` overrides it. Keep `mode` set to `platform` for the HTTP server backend. + Then start a fresh Hermes session and call `mem0_search` — it connects to your server. The plugin authenticates with `X-API-Key` and uses the server's `/search` and `/memories` routes. The API key is optional only for servers running with `AUTH_DISABLED`. Setting `host` routes to the self-hosted server automatically. Don't combine it with `mode: oss` — OSS takes precedence and ignores `host`. ## OSS (Self-Hosted) Setup -OSS mode runs Mem0 entirely on your own infrastructure: your LLM, your embedder, and your vector store. No data is sent to Mem0 Cloud, and no Mem0 API key is required. +OSS mode runs the Mem0 SDK in the Hermes process with your chosen LLM, embedder, and vector store. It does not use Mem0 Cloud or require a Mem0 API key. Data goes to the model services you configure; use local Ollama models and local storage for a fully local setup. ### Interactive ```bash -hermes memory setup -# Select "mem0", then "Open Source (self-hosted)" +hermes memory setup mem0 +# Choose "Open Source" # Follow the prompts for LLM, embedder, and vector store ``` -### With flags - -```bash -hermes memory setup mem0 --mode oss \ - --oss-llm openai --oss-llm-key sk-... \ - --oss-vector qdrant -``` +The wizard uses the listed default OpenAI models and local Qdrant storage. For custom OpenAI-compatible endpoints, deployment names, or a Qdrant server, use manual configuration below. ### Supported providers @@ -133,52 +156,24 @@ hermes memory setup mem0 --mode oss \ | Embedder | `openai` (default `text-embedding-3-small`), `ollama` (local, default `nomic-embed-text`) | | Vector store | `qdrant` (local path or server), `pgvector` | -### Flag reference - -| Flag | Description | -|------|-------------| -| `--mode` | `platform`, `selfhosted`, or `oss` | -| `--api-key` | Platform API key, or the admin key of a self-hosted server | -| `--host` | Self-hosted server URL (with `--mode selfhosted`) | -| `--oss-llm` | LLM provider (`openai` or `ollama`, default `openai`) | -| `--oss-llm-key` | LLM API key (for `openai`) | -| `--oss-llm-model` | Override the LLM model | -| `--oss-llm-url` | LLM base URL (for `ollama` or a custom endpoint) | -| `--oss-embedder` | Embedder provider (default `openai`) | -| `--oss-embedder-key` | Embedder API key | -| `--oss-embedder-model` | Override the embedder model | -| `--oss-embedder-url` | Embedder base URL (for `ollama` or a custom endpoint) | -| `--oss-vector` | Vector store (`qdrant` or `pgvector`, default `qdrant`) | -| `--oss-vector-path` | Local Qdrant storage path | -| `--oss-vector-url` | Qdrant server URL | -| `--oss-vector-host`, `--oss-vector-port` | PGVector or remote Qdrant host and port | -| `--oss-vector-user`, `--oss-vector-password`, `--oss-vector-dbname` | PGVector connection details | -| `--user-id` | Canonical user identifier | -| `--dry-run` | Preview the resolved config without writing it | - -## Switching Modes - -You can move between the three modes at any time. Run the setup command again, or edit `~/.hermes/mem0.json` directly. +### Manual configuration ```bash -# Platform to OSS -hermes memory setup mem0 --mode oss --oss-llm-key sk-... - -# OSS to Platform -hermes memory setup mem0 --mode platform --api-key sk-... - -# Platform to a self-hosted server -hermes memory setup mem0 --mode selfhosted --host http://localhost:8888 - -# Preview without writing anything -hermes memory setup mem0 --mode oss --oss-llm-key sk-... --dry-run +hermes config set memory.provider mem0 ``` -A self-hosted `~/.hermes/mem0.json` looks like this: +Add the model key to the active profile's `.env`: + +```dotenv +OPENAI_API_KEY=your-model-api-key +``` + +Set the following in that profile's `mem0.json`. Use your existing storage path when migrating; for a new named profile, choose a path inside that profile's home. ```json { "mode": "oss", + "user_id": "my-hermes-user", "oss": { "llm": {"provider": "openai", "config": {"model": "gpt-5-mini", "is_reasoning_model": true}}, "embedder": {"provider": "openai", "config": {"model": "text-embedding-3-small"}}, @@ -187,33 +182,65 @@ A self-hosted `~/.hermes/mem0.json` looks like this: } ``` +For an OpenAI-compatible service such as Azure's `/openai/v1` endpoint, add `OPENAI_BASE_URL` to the profile's `.env` and set each `model` to its deployed name. Both the LLM and embedder use this endpoint unless their `config.openai_base_url` overrides it. The main Hermes chat model is configured separately; this JSON configures Mem0's extraction and embedding models. + +For a Qdrant server, replace `vector_store.config.path` with `url`, for example `"url": "http://localhost:6333"`. Manual setup does not install optional provider dependencies: install `qdrant-client`, `psycopg2-binary`, or `ollama` in the **Hermes Python environment** as needed for your selected providers. Start a fresh session and verify a memory write and search; `hermes memory status` reports configuration availability, not a full backend health check. + +Desktop sessions in the same process and profile share local Qdrant storage when their OSS settings match. Operations are serialized, and storage closes after the last session releases it. Conflicting settings are rejected without changing existing memories; close active sessions before changing models or credentials. For concurrent CLI and Desktop processes, use a Qdrant server or the self-hosted Mem0 HTTP API instead of sharing a local directory. + +## Switching Modes + +Run `hermes memory setup mem0` in an interactive terminal and choose the new mode, or edit the active profile's `mem0.json` using the examples above. Switching backends does not transfer memories between them. Preserve existing OSS storage paths when editing configuration. When returning to Platform, set `mode` to `platform`, clear `host`, and remove any stale `MEM0_HOST` setting from your environment and profile `.env`. + ## Configuration -Behavioral settings live in `~/.hermes/mem0.json` and are written for you by `hermes memory setup`. Only the secret `MEM0_API_KEY` belongs in `~/.hermes/.env`. +Settings live in `$HERMES_HOME/mem0.json` and are written by `hermes memory setup`. API keys normally live in that profile's `.env`; distinct OpenAI LLM/embedder keys and database credentials are stored in the OSS configuration. Setup writes these files atomically with owner-only permissions. + +When editing these files manually, restrict both `.env` and `mem0.json` to their owner (`chmod 600` on Unix). Keep configuration and secrets in the same active Hermes profile. + +`MEM0_MODE`, `MEM0_HOST`, `MEM0_USER_ID`, and `MEM0_AGENT_ID` supply environment defaults. Non-empty values in `mem0.json` take precedence. `MEM0_API_KEY` supplies the Cloud or server key unless `api_key` is set in the file. | Key | Default | Description | |-----|---------|-------------| | `mode` | `platform` | `platform` (Mem0 Cloud) or `oss` (self-managed, in-process). Self-hosted server routing is set via `host` | | `host` | none | Self-hosted Mem0 server URL. When set, the plugin talks HTTP to your server instead of the cloud | | `api_key` | none | Mem0 Platform API key, or the admin key of a self-hosted server. Stored in `.env` as `MEM0_API_KEY` | -| `user_id` | `hermes-user` | Identifier that scopes memories. See cross-channel behavior below | +| `user_id` | gateway user ID, then `hermes-user` | Identifier that scopes memories. See cross-channel behavior below | | `agent_id` | `hermes` | Agent identifier attached to writes | -| `rerank` | `false` | Rerank search results for relevance (Platform mode only) | +| `rerank` | `false` | Platform reranking for recall and tool searches that omit `rerank` | +| `sync_max_chars` | `450` | Per-message character cap for automatic fact extraction in every mode | +| `oss` | `{}` | OSS LLM, embedder, and vector-store configuration | ### Cross-channel memories Hermes can run from the CLI and from gateways like Telegram, Slack, and Discord. The `user_id` setting controls how memories are scoped across them: -- **Set a `user_id`** and it applies to every gateway, so one person gets a single merged memory store no matter where they talk to the agent. -- **Leave it unset** (or at the default `hermes-user`) and each gateway uses its own native id, keeping per-platform memories separate. +- **Set a `user_id` other than `hermes-user`** and it applies to every gateway, so one person gets a single merged memory store no matter where they talk to the agent. +- **Leave it unset** (or at the default `hermes-user`) and each gateway uses its own native ID when available, falling back to `hermes-user`. -Either way, every write is tagged with `metadata.channel` (for example `telegram` or `cli`), so per-channel views are still possible at query time. +Every write is tagged with `metadata.channel` (for example `telegram` or `cli`). Plugin searches filter by user identity across sessions; they do not restrict recall to the current channel or session. + +## Migration for Existing Users + +Keep `memory.provider: mem0`, `mem0.json`, `MEM0_*` settings, user identity, and OSS database paths unchanged. Moving from the bundled provider to this standalone plugin does not require rerunning setup or moving stored memories. + +Automatic migration depends on Hermes rollout as well as this repository: + +1. Users need a Hermes build containing [PR #114569](https://github.com/NousResearch/hermes-agent/pull/114569). +2. Hermes maintainers must approve a catalog entry named `mem0` with `repo: https://github.com/mem0ai/mem0`, `subdir: integrations/hermes-plugin-mem0`, and a reviewed full commit SHA. +3. The bundled Mem0 provider must be removed so the standalone provider can load. + +With these in place, Hermes installs a missing configured provider during `hermes update` across profiles or at agent startup. Startup installation respects `security.allow_lazy_installs`. Offline or disabled installation needs manual action; merging the plugin directory alone does not complete automatic migration. + +CLI setup and status are supported. This plugin does not ship a Desktop configuration panel or provider-specific CLI commands. ## Reliability -- **Circuit breaker**: if Mem0 fails five times in a row, Hermes pauses calls for two minutes, then retries. The agent keeps working without memory during that window. Expected client errors, like a 404 on a missing memory id, do not count toward tripping the breaker. -- **Non-blocking**: fact extraction runs in a background daemon thread, and current-turn recall waits at most 3 seconds, so a slow or failed call never blocks your conversation. -- **Thread-safe**: the client uses lazy initialization with locking, and the background sync and recall threads are guarded so concurrent gateway messages cannot produce duplicate memories. +- **Circuit breaker**: five consecutive backend failures pause calls for two minutes. The agent can continue without memory during that window. Expected update/delete errors such as a missing memory do not trip the breaker. +- **Bounded waits**: recall waits up to three seconds. Capture runs in the background, but an overlapping turn may wait up to five seconds for the previous sync before being skipped. +- **Graceful shutdown**: shutdown and Python process exit wait for active recall and capture workers before closing the backend. Backend network timeouts still apply. Self-hosted HTTP capture uses a 120-second read timeout and a 30-second connection timeout; other self-hosted HTTP operations use 30 seconds. +- **Best-effort capture**: there is no durable queue. Forced termination, including Hermes' 30-second exit watchdog, can interrupt pending writes even while graceful shutdown is waiting. +- **OSS data protection**: an embedding dimension mismatch fails initialization without deleting the existing collection or table. ## Troubleshooting @@ -248,15 +275,12 @@ curl http://localhost:11434/api/tags - `mem0_add` stores text verbatim with no extraction. Ordinary conversation turns are extracted automatically by the background sync. - Search is semantic, so try a broader query. -- Confirm `user_id` is the same across sessions (check `~/.hermes/mem0.json`). +- Confirm `user_id` is the same across sessions (check `$HERMES_HOME/mem0.json`). +- Check `sync_max_chars`: facts beyond the per-message limit are not sent for extraction. -## Key Features +### OSS: embedding dimension mismatch -1. **Three ways to run**: managed Platform, a self-hosted server, or fully local OSS, switchable at any time. -2. **Current-turn recall**: memories for the current question are injected within a 3-second window, with `mem0_search` as the model's own backstop. -3. **Automatic extraction**: Mem0 extracts and deduplicates facts from each exchange for you. -4. **Non-blocking and fault tolerant**: background threads plus a circuit breaker keep the agent responsive even when Mem0 is unreachable. -5. **Additive memory**: works alongside Hermes' built-in file memory (`MEMORY.md`, `USER.md`). +Restore the embedding model and dimensions that created the existing collection, or choose a new collection and migrate data explicitly. The plugin leaves the original collection intact when dimensions differ. diff --git a/docs/llms.txt b/docs/llms.txt index 2a939cbe3..12dbdd339 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -257,7 +257,7 @@ If the user is on a pre-current major (Python < 2, TS < 3, or a Platform call st - [Agno](https://docs.mem0.ai/integrations/agno) [Platform]: Use when the user is on Agno. - [Camel AI](https://docs.mem0.ai/integrations/camel-ai) [Both]: Use when the user is on Camel AI. - [ChatDev](https://docs.mem0.ai/integrations/chatdev) [Platform]: Use when the user is on ChatDev. -- [Hermes](https://docs.mem0.ai/integrations/hermes) [Both]: Use when the user is on Hermes. +- [Hermes](https://docs.mem0.ai/integrations/hermes) [Both]: Use when installing or configuring the standalone Hermes memory plugin, or migrating from the bundled Mem0 provider. - [Pi Agent](https://docs.mem0.ai/integrations/pi-agent) [Platform]: Use when adding automatic capture, prompt recall, scoped memory, and six memory commands to Pi Agent. - [DeepSeek Harness](https://docs.mem0.ai/integrations/deepseek-plugin) [Platform]: Use when adding automatic recall, completed-turn capture, and native search/add tools to DeepSeek Harness. - [OpenAI Agents SDK](https://docs.mem0.ai/integrations/openai-agents-sdk) [Platform]: Use when the user is on the OpenAI Agents SDK. diff --git a/integrations/AGENTS.md b/integrations/AGENTS.md index 221c8206f..e7814523f 100644 --- a/integrations/AGENTS.md +++ b/integrations/AGENTS.md @@ -6,6 +6,7 @@ Agent and editor integrations. Most packages are self-contained; coding-agent pl |-----------|---------|-------|------|------| | `vercel-ai-sdk/` | `@mem0/vercel-ai-provider` | tsup (CJS+ESM) | ESLint + Prettier | jest + vitest (edge/node) | | `openclaw/` | `@mem0/openclaw-mem0` | tsup (ESM) | none | vitest | +| `hermes-plugin-mem0/` | Standalone Hermes memory provider | none | ruff + isort | pytest (host-stubbed offline); live CLI/Desktop validation | | `agent-plugin-core/` | Shared Python/TypeScript behavior, skill templates, builds, and conformance | Python build script | ruff + tsc | pytest + node:test | | `mem0-agent-plugin/` | One portable Agent Plugins v1 package | Python | ruff | shared conformance | | `claude-code-plugin/`, `cursor-plugin/`, `codex-plugin/`, `kimi-plugin/`, `antigravity-plugin/` | Self-contained native plugins generated from the shared Python core | Python | ruff | pytest | diff --git a/integrations/hermes-plugin-mem0/.gitignore b/integrations/hermes-plugin-mem0/.gitignore new file mode 100644 index 000000000..00f2d38d8 --- /dev/null +++ b/integrations/hermes-plugin-mem0/.gitignore @@ -0,0 +1,3 @@ +__pycache__/ +*.pyc +.venv/ diff --git a/integrations/hermes-plugin-mem0/LICENSE b/integrations/hermes-plugin-mem0/LICENSE new file mode 100644 index 000000000..5ee05954c --- /dev/null +++ b/integrations/hermes-plugin-mem0/LICENSE @@ -0,0 +1,236 @@ + 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 [2023] [Taranjeet Singh] + + 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. + +Third-party software +-------------------- + +hermes-plugin-mem0 + +Mem0 contributions are licensed under the Apache License, Version 2.0. + +This plugin includes code from Nous Research's hermes-plugin-mem0: +https://github.com/NousResearch/hermes-plugin-mem0 +Source commit: 3fc36950b2b7c19cdd81c6de99f10d2cbed850af + +The imported code retains the following MIT license and copyright notice: + +MIT License + +Copyright (c) 2025 Nous Research + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/integrations/hermes-plugin-mem0/README.md b/integrations/hermes-plugin-mem0/README.md new file mode 100644 index 000000000..ad4d2f87e --- /dev/null +++ b/integrations/hermes-plugin-mem0/README.md @@ -0,0 +1,131 @@ +# Mem0 for Hermes Agent + +Persistent memory for [Hermes Agent](https://github.com/NousResearch/hermes-agent), powered by [Mem0](https://mem0.ai). + +This standalone plugin recalls relevant memories before a response and extracts facts from conversations afterward. It works alongside Hermes' file-based memory and supports Mem0 Cloud, a self-hosted Mem0 server, or the in-process OSS SDK. + +## Features + +- **Automatic recall and capture** across conversations. +- **Four agent tools** to search, add, update, and delete memories. +- **Three backend modes** with interactive setup through `hermes memory setup`. +- **User-scoped memories** with agent and channel metadata on writes. + +## Setup + +### 1. Install + +Requires [Hermes Agent](https://github.com/NousResearch/hermes-agent) with memory-provider plugin support and Python 3.11 or later. After this directory is merged to Mem0's main branch: + +```bash +hermes plugins install mem0ai/mem0/integrations/hermes-plugin-mem0 +hermes plugins enable mem0 +``` + +Hermes installers with plugin dependency support install `mem0ai>=2.0.10,<3` and `httpx>=0.27,<1` from this directory's `pyproject.toml`. On older hosts such as Hermes v0.21.3, install those requirements into the **Hermes Python environment** explicitly. The OSS setup wizard installs additional provider packages as needed. + +> Hermes versions that still bundle Mem0 prefer the bundled provider. Use a Hermes release that has completed the standalone-provider migration; installing this plugin alone does not replace the bundled implementation. See [Existing users and migration](#existing-users-and-migration). + +### 2. Configure + +```bash +hermes memory setup mem0 +``` + +Run this in an interactive terminal and choose a backend: + +| Mode | What you need | +|------|----------------| +| **Platform** (default) | A Mem0 API key from [app.mem0.ai](https://app.mem0.ai/dashboard/api-keys) | +| **Self-hosted server** | A running [Mem0 server](../../server), its URL, and its API key unless authentication is disabled | +| **OSS** | An LLM, embedder, and vector store; no Mem0 API key needed | + +For a self-hosted server, choose **Self-hosted server** and enter its URL and API key. Requests use `X-API-Key` and the server's `/search` and `/memories` routes. Setting `host` selects this backend unless `mode` is `oss`. + +For the in-process SDK, choose **Open Source**. The wizard offers OpenAI or Ollama and local Qdrant or PGVector. Use manual configuration for custom OpenAI-compatible endpoints, deployment names, or a Qdrant server. OSS does not use Mem0 Cloud; data still goes to whichever model services you configure. Run setup again to switch modes. When switching to Platform, remove any stale `MEM0_HOST` setting from the environment and profile `.env`. + +Desktop sessions in the same process and profile share local Qdrant storage when their OSS settings match. Operations are serialized, and storage closes after the last session releases it. Conflicting settings are rejected without changing existing memories; close the active sessions before changing models or credentials. Use a Qdrant server or the self-hosted Mem0 HTTP API when separate processes (for example, CLI and Desktop together) need the same store. + +Hermes hosts whose `hermes memory setup --help` lists only a provider argument reject options such as `--mode`, `--host`, and `--oss-llm` before the plugin runs. Use the interactive command above, or the [manual profile configuration](https://docs.mem0.ai/integrations/hermes) for unattended setup. Redirected input cannot select the mode picker; it falls back to Platform. + +### 3. Verify + +```bash +hermes memory status +``` + +Start a fresh Hermes conversation and ask it to remember a fact, then search for that fact in a later session using the same user identity. + +## Tools + +| Tool | Description | Parameters | +|------|-------------|------------| +| `mem0_search` | Search memories by meaning | `query`, optional `top_k` (default 10, max 50) and `rerank` (Platform only) | +| `mem0_add` | Store text verbatim, without fact extraction | `content` | +| `mem0_update` | Update a memory's text | `memory_id`, `text` | +| `mem0_delete` | Delete a memory | `memory_id` | + +## Configuration + +Settings live in `$HERMES_HOME/mem0.json`; the default Hermes home is `~/.hermes`. Setup normally stores API keys in that profile's `.env`. Distinct OpenAI LLM/embedder keys and database credentials are stored in the OSS configuration. Setup writes both files atomically with owner-only permissions. + +| Key | Default | Description | +|-----|---------|-------------| +| `mode` | `platform` | `platform` for Cloud/server routing, or `oss` for the in-process SDK | +| `host` | unset | Self-hosted server URL; ignored in OSS mode | +| `user_id` | gateway user ID, then `hermes-user` | Set a stable ID to share memories across gateways | +| `agent_id` | `hermes` | Agent identifier attached to writes | +| `rerank` | `false` | Platform reranking for automatic recall and tool searches that omit `rerank` | +| `sync_max_chars` | `450` | Maximum characters per user/assistant message sent for automatic extraction | +| `oss` | `{}` | OSS LLM, embedder, and vector-store configuration written by setup | + +`MEM0_MODE`, `MEM0_HOST`, `MEM0_USER_ID`, and `MEM0_AGENT_ID` provide environment defaults; non-empty file settings override them. `MEM0_API_KEY` supplies the Cloud or server key when `api_key` is not set in the file. + +An explicit `user_id` other than `hermes-user` takes precedence over a gateway's native user ID. Searches use that user identity across sessions; writes attach `agent_id` and `metadata.channel`. + +## Automatic recall and capture + +Recall waits up to three seconds for memories relevant to the current message. If results are late, the model can still call `mem0_search`. + +After a turn, a background worker sends the user message and assistant response for extraction. Each message is truncated to **450 characters by default in every mode**, preferring a sentence boundary. Increase `sync_max_chars` to suit your model's context limit. Explicit `mem0_add` calls store their supplied text verbatim. + +Capture is best effort: if the previous sync remains busy after a five-second wait, the new turn is skipped. There is no durable queue. Five consecutive backend failures pause calls for two minutes before retrying. + +Graceful shutdown waits for active recall and capture workers before closing the backend, including at Python process exit. Backend network timeouts still apply: self-hosted HTTP capture has a 120-second read timeout and a 30-second connection timeout; other self-hosted HTTP operations use 30 seconds. Forced termination, including Hermes' 30-second exit watchdog, can still interrupt pending writes. + +## Existing users and migration + +Keep `memory.provider: mem0`, your existing `mem0.json`, `MEM0_*` settings, user identity, and OSS storage paths. Moving the plugin does not require moving memories or rerunning setup. + +Automatic migration also requires coordination in Hermes: + +1. A Hermes build containing [migration support from PR #114569](https://github.com/NousResearch/hermes-agent/pull/114569). +2. An approved catalog entry named `mem0`, pointing to `https://github.com/mem0ai/mem0`, with `subdir: integrations/hermes-plugin-mem0` and a reviewed full commit SHA. +3. Removal of Hermes' bundled Mem0 provider, which otherwise takes precedence. + +With those in place, Hermes can install a missing configured provider during `hermes update` or at agent startup. Startup installation respects `security.allow_lazy_installs`; disabled or offline installation requires manual action. Merging this directory alone does not register the catalog entry or complete rollout. + +The plugin supports CLI setup/status. It does not include a Desktop configuration panel or provider-specific CLI commands. + +## Troubleshooting + +- **Mem0 unavailable:** run `hermes memory status`. Check the API key and backend connectivity; after five consecutive failures the circuit breaker waits two minutes. +- **Memories missing:** confirm the same user identity across sessions and check `sync_max_chars`. Automatic extraction may omit facts; use `mem0_add` to store exact text. +- **OSS connection refused:** check the configured model/vector service, or filesystem permissions for local Qdrant. +- **Embedding dimension mismatch:** initialization fails without deleting existing data. Restore the previous embedding model/dimensions, or use a new collection and migrate data explicitly. + +## Development + +From the Mem0 repository root, with `ruff` and `isort` installed: + +```bash +ruff check integrations/hermes-plugin-mem0 +isort --check-only --profile black integrations/hermes-plugin-mem0 +``` + +Validate changes in an isolated Hermes profile using live CLI and Desktop sessions. Check memory +add/search/update/delete, automatic capture and recall, overlapping Desktop sessions, and persistence after restart. + +## License + +[Apache-2.0](LICENSE) for Mem0 contributions. Includes code from [Nous Research's standalone Mem0 provider](https://github.com/NousResearch/hermes-plugin-mem0/tree/3fc36950b2b7c19cdd81c6de99f10d2cbed850af) under MIT; its original license and copyright notice are preserved in the third-party section of [LICENSE](LICENSE). diff --git a/integrations/hermes-plugin-mem0/__init__.py b/integrations/hermes-plugin-mem0/__init__.py new file mode 100644 index 000000000..1ab504753 --- /dev/null +++ b/integrations/hermes-plugin-mem0/__init__.py @@ -0,0 +1,504 @@ +"""Mem0 memory plugin — MemoryProvider interface. + +Server-side fact extraction and semantic search via the Mem0 Platform API (cloud), a +self-hosted Mem0 server (MEM0_HOST, HTTP), or OSS Memory. Secrets live in $HERMES_HOME/.env +(MEM0_API_KEY, MEM0_HOST); settings in $HERMES_HOME/mem0.json via `hermes memory setup`: +mode ("platform"|"oss"), host, user_id (canonical id across gateways; unset → gateway-native +id), agent_id. MEM0_* env vars remain a fallback. +""" + +from __future__ import annotations + +import atexit +import json +import logging +import threading +import time +from contextlib import suppress +from pathlib import Path +from typing import Any, Dict, List + +from agent.memory_provider import MemoryProvider, spawn_context_thread +from agent.secret_scope import get_secret +from tools.registry import tool_error +from utils import atomic_json_write, read_json_or_empty + +logger = logging.getLogger(__name__) + +# Circuit breaker: after _BREAKER_THRESHOLD consecutive failures, pause API +# calls for _BREAKER_COOLDOWN_SECS to avoid hammering a down server. +_BREAKER_THRESHOLD, _BREAKER_COOLDOWN_SECS, _PREFETCH_WAIT_SECS = 5, 120, 3 +_CLIENT_ERROR_TYPES = ("MemoryNotFoundError", "ValidationError") +# Placeholder user_id. initialize() treats it as "no operator-configured user_id" +# so legacy mem0.json files written by the wizard don't override gateway-native ids. +_DEFAULT_USER_ID = "hermes-user" + +# sync_turn sends the whole turn to the backend for fact extraction. OSS embedding +# models often have small context windows (bge-small-zh-v1.5: 512 tokens ≈ 500 chars; +# jina-embeddings-v3: 8192), and oversized turns make backend.add() raise — Ollama +# answers HTTP 500, hosted APIs return INPUT_TOKEN_LIMIT_EXCEEDED — which _try only +# logs, silently dropping the turn's memory extraction. Cap each message up front. +# The default fits a 512-token embedder (measured: 450 OK, 600 -> HTTP 500 on +# bge-small-zh-v1.5:f16); ``sync_max_chars`` in mem0.json raises it for larger windows. +_SYNC_MSG_MAX_CHARS = 450 + + +# Sentence ends recognized when trimming a synced message. Deliberately unordered: +# the LAST boundary of ANY kind wins, so one CJK stop early in a mixed-script turn +# cannot outrank a Latin stop near the end of the window. ``".\n"`` is not listed — +# its index can never exceed the bare ``"."`` it starts with. +_SYNC_SENTENCE_ENDS = ("。", "!", "?", ".", "!", "?") + + +def _truncate_for_sync(text: str, max_len: int = _SYNC_MSG_MAX_CHARS) -> str: + """Cap a synced message at its last sentence boundary within ``max_len``. + + Short messages pass through unchanged; long ones keep the last complete + sentence inside the window so fact extraction still sees coherent statements, + with a hard cut as fallback when no boundary exists (or one only appears in + the first third of the window, which usually means unsegmented input). + """ + if len(text) <= max_len: + return text + window = text[:max_len] + cut = max(window.rfind(sep) for sep in _SYNC_SENTENCE_ENDS) + if cut > max_len // 3: + return text[:cut + 1] + return text[:max_len] + + +def _is_client_error(exc: Exception) -> bool: + """True for user-caused errors (bad ID, not found) that should NOT trip circuit breaker.""" + err_str = str(exc).lower() + return type(exc).__name__ in _CLIENT_ERROR_TYPES or any(s in err_str for s in ("404", "not found", "valid uuid")) + + +def _load_config() -> dict: + """Env vars provide defaults; $HERMES_HOME/mem0.json overrides individual keys. + Layering avoids a silent failure when the JSON file exists but lacks fields + like ``api_key`` that the user set in ``.env``.""" + from hermes_constants import get_hermes_home + + # Identity (user/agent id), host and mode are .env values like the key: read them through the + # profile scope too, or a secondary profile's memories land in the default profile's account. + # A scope-less multiplex caller raises here on purpose — that is a spawn-site bug, and + # swallowing it would silently route the turn's memories to the default profile. + config = {"mode": get_secret("MEM0_MODE", "") or "platform", "host": get_secret("MEM0_HOST", "") or "", + "agent_id": get_secret("MEM0_AGENT_ID", "") or "hermes", "oss": {}} + if user_id := get_secret("MEM0_USER_ID", ""): # only when explicitly configured, so initialize() can fall back to the gateway-native id + config["user_id"] = user_id + file_cfg = read_json_or_empty(get_hermes_home() / "mem0.json") + config.update({k: v for k, v in file_cfg.items() if v is not None and v != ""}) + # MEM0_API_KEY authenticates the Platform and self-hosted HTTP backends; pure OSS mode builds its + # backend from the local ``oss`` config and has no platform credential to resolve, so a profile + # scope WITHOUT the key must still load an OSS config (#99121 as it stands today: the caller is + # scoped, the scope is just empty). Decided after mem0.json overrode the env defaults because + # the file may be what selects ``oss``. Scope-less callers already raised above. + if config.get("mode", "platform") == "oss": + config.setdefault("api_key", "") + elif not config.get("api_key"): + config["api_key"] = get_secret("MEM0_API_KEY", "") + return config + + +def _schema(name: str, description: str, properties: dict[str, tuple[str, str]], required: list[str]) -> dict: + props = {k: {"type": t, "description": d} for k, (t, d) in properties.items()} + return {"name": name, "description": description, "parameters": {"type": "object", "properties": props, "required": required}} + + +TOOL_SCHEMAS = [ + _schema("mem0_search", "Search the user's memories by meaning; returns facts ranked by relevance. Use this before answering any question that may depend on what you know about the user (preferences, facts, history, people, projects, past decisions). For multi-part or multi-hop questions, call it several times — vary the wording and run follow-up searches on what earlier results reveal; one search is rarely enough.", + {"query": ("string", "What to search for."), "top_k": ("integer", "Max results (default: 10, max: 50)."), "rerank": ("boolean", "Rerank results for relevance (default: false, platform mode only).")}, ["query"]), + _schema("mem0_add", "Store a durable fact about the user, verbatim (no LLM extraction). Call this the moment the user states a lasting preference, correction, decision, or personal detail worth recalling on future turns — don't wait to be asked to remember. Skip transient chit-chat and facts you've already stored.", + {"content": ("string", "The fact to store.")}, ["content"]), + _schema("mem0_update", "Replace the text of an existing memory by its ID (take the ID from a mem0_search result). Use when a stored fact has changed or was wrong — correct it in place instead of adding a duplicate.", + {"memory_id": ("string", "Memory UUID to update."), "text": ("string", "New text content.")}, ["memory_id", "text"]), + _schema("mem0_delete", "Delete a memory by its ID (take the ID from a mem0_search result). Use when a stored fact is obsolete or the user asks you to forget it; prefer mem0_update if the fact merely changed.", + {"memory_id": ("string", "Memory UUID to delete.")}, ["memory_id"]), +] + +_PROMPT_BODY = ( + "You have persistent memory of this user from past conversations. You should call mem0_search before answering anything that could depend on prior context (the user's preferences, facts, history, people, projects, or earlier decisions) — do not rely on the chat window alone, and do not assume you have no memory.\n" + "For multi-part or multi-hop questions, run several searches with different wording/angles and follow-up searches on what the first results surface; one search is rarely enough. Keep searching until you have every fact the question needs before you answer.\n" + "Tools: mem0_search to find memories, mem0_add to store facts, mem0_update and mem0_delete to manage by ID." +) + + +class Mem0MemoryProvider(MemoryProvider): + """Mem0 memory with server-side extraction and semantic search (platform, self-hosted or OSS).""" + + def __init__(self): + self._config = self._backend = self._sync_thread = self._prefetch_thread = None + self._mode, self._api_key, self._host, self._user_id, self._agent_id = "platform", "", "", _DEFAULT_USER_ID, "hermes" + self._rerank_default, self._channel = False, "cli" # channel = gateway name (cli/telegram/discord/...) + self._sync_max_chars = _SYNC_MSG_MAX_CHARS + self._prefetch_query = self._prefetch_result = "" + self._prefetch_done = self._atexit_registered = False + self._consecutive_failures, self._breaker_open_until = 0, 0.0 # circuit breaker state + self._breaker_lock, self._sync_lock, self._prefetch_lock = threading.Lock(), threading.Lock(), threading.Lock() + + @property + def name(self) -> str: + return "mem0" + + def is_available(self) -> bool: + cfg = _load_config() + if cfg.get("mode", "platform") == "oss": + return bool(cfg.get("oss", {}).get("vector_store")) + return bool(cfg.get("api_key") or cfg.get("host")) # platform needs a key; self-hosted a host (key optional with AUTH_DISABLED) + + def save_config(self, values, hermes_home): + """Merge-write config to $HERMES_HOME/mem0.json.""" + config_path = Path(hermes_home) / "mem0.json" + atomic_json_write(config_path, {**read_json_or_empty(config_path), **values}, mode=0o600) + + def get_config_schema(self): + cfg = _load_config() + api_key_required = cfg.get("mode", "platform") != "oss" and not cfg.get("host") + return [ + {"key": "api_key", "description": "Mem0 Platform API key", "secret": True, "required": api_key_required, "env_var": "MEM0_API_KEY", "url": "https://app.mem0.ai"}, + {"key": "host", "description": "Self-hosted Mem0 server URL (leave blank for cloud)", "required": False, "env_var": "MEM0_HOST"}, + {"key": "user_id", "description": "User identifier", "default": "hermes-user"}, + {"key": "agent_id", "description": "Agent identifier", "default": "hermes"}, + {"key": "rerank", "description": "Enable reranking for recall", "default": "false", "choices": ["true", "false"]}, + ] + + def post_setup(self, hermes_home: str, config: dict) -> None: + from ._setup import post_setup + post_setup(hermes_home, config) + + def _oss_hint(self, template: str, default: str = "vector store") -> str: + """OSS-only hint; ``{vs}`` is the configured vector-store provider. "" in other modes.""" + return template.format(vs=self._config.get("oss", {}).get("vector_store", {}).get("provider", default)) if self._mode == "oss" else "" + + def _create_backend(self): + # Lazy-install the mem0 SDK before the backend imports it (honors security.allow_lazy_installs); + # on failure the backend import raises the canonical error, captured below. + with suppress(Exception): + pass # dependencies come from pyproject.toml (installed by Hermes on install/enable/update) + try: + from . import _backend + if self._mode == "oss": + return _backend.OSSBackend(self._config.get("oss", {})) + return _backend.SelfHostedBackend(self._api_key, self._host) if self._host else _backend.PlatformBackend(self._api_key) + except Exception as e: + logger.error("Mem0 backend failed to initialize (%s mode): %s", self._mode, e) + self._init_error = str(e) + return None + + def _is_breaker_open(self) -> bool: + """True while the breaker is tripped; an expired cooldown resets the failure count.""" + with self._breaker_lock: + if self._consecutive_failures >= _BREAKER_THRESHOLD and time.monotonic() < self._breaker_open_until: + return True + if self._consecutive_failures >= _BREAKER_THRESHOLD: + self._consecutive_failures = 0 + return False + + def _format_error(self, prefix: str, exc: Exception) -> str: + msg = f"{prefix}: {exc}" + if any(s in str(exc).lower() for s in ("connection", "refused", "timeout")): + msg += self._oss_hint(" (check that {vs} is running)") + return msg + + def _record_success(self): + with self._breaker_lock: + self._consecutive_failures = 0 + + def _record_failure(self): + with self._breaker_lock: + self._consecutive_failures = count = self._consecutive_failures + 1 + if count >= _BREAKER_THRESHOLD: + self._breaker_open_until = time.monotonic() + _BREAKER_COOLDOWN_SECS + if count >= _BREAKER_THRESHOLD: + hint = self._oss_hint(" Check that your {vs} vector store is running and reachable.", "unknown") + logger.warning("Mem0 circuit breaker tripped after %d consecutive failures. Pausing API calls for %ds.%s", count, _BREAKER_COOLDOWN_SECS, hint) + + def _try(self, call, log, msg: str): + """Background-path wrapper: run ``call`` under the breaker; on error log ``msg`` and return None.""" + try: + result = call() + except Exception as e: + self._record_failure() + log(msg, e) + return None + self._record_success() + return result + + def initialize(self, session_id: str, **kwargs) -> None: + self._config = cfg = _load_config() + self._mode, self._api_key, self._host, self._agent_id = cfg.get("mode", "platform"), cfg.get("api_key", ""), cfg.get("host", ""), cfg.get("agent_id", "hermes") + # user_id precedence: operator-configured (env/mem0.json) > gateway-native id (kwargs) > _DEFAULT_USER_ID. + # The literal placeholder counts as unset so wizard users still get gateway-native ids. + configured = cfg.get("user_id") + self._user_id = (None if configured == _DEFAULT_USER_ID else configured) or kwargs.get("user_id") or _DEFAULT_USER_ID + # Persisted rerank preference: default for mem0_search when the model omits ``rerank``. Platform-only. + _rr = cfg.get("rerank", False) + self._rerank_default = _rr.lower() in ("true", "1", "yes") if isinstance(_rr, str) else bool(_rr) + self._channel = kwargs.get("platform") or "cli" + try: + self._sync_max_chars = int(cfg.get("sync_max_chars") or _SYNC_MSG_MAX_CHARS) + except (ValueError, TypeError): + self._sync_max_chars = _SYNC_MSG_MAX_CHARS + self._backend = self._create_backend() + if self._backend and not self._atexit_registered: + atexit.register(self.shutdown) + self._atexit_registered = True + + def _search(self, query: str, top_k: int = 10, rerank: bool = False, backend=None) -> list: + # Scoped to user_id only — by design — so recall surfaces memories from any gateway/agent under this + # principal; writes attach agent_id and metadata.channel so narrower views remain possible at query time. + return (backend or self._backend).search(query, filters={"user_id": self._user_id}, top_k=top_k, rerank=rerank) + + def _add(self, messages: list, infer: bool): + metadata = {"channel": self._channel} if self._channel else {} + return self._backend.add(messages, user_id=self._user_id, agent_id=self._agent_id, infer=infer, metadata=metadata) + + def system_prompt_block(self) -> str: + # Mirror _create_backend precedence (oss > host > platform). Rerank is a Mem0 Platform feature only. + mode_label = "OSS (self-hosted)" if self._mode == "oss" else "self-hosted (HTTP API)" if self._host else "platform (cloud API)" + rerank_note = " Rerank is available on search." if (self._mode == "platform" and not self._host) else "" + return f"# Mem0 Memory\nActive. Mode: {mode_label}. User: {self._user_id}.\n{_PROMPT_BODY}{rerank_note}" + + def on_turn_start(self, turn_number: int, message: str, **kwargs) -> None: + self._start_prefetch(message) + + def _consume_prefetch_result(self, query: str) -> str | None: + """Pop the finished prefetch body for ``query`` (None if absent or still running).""" + with self._prefetch_lock: + if self._prefetch_query != query or not self._prefetch_done: + return None + result, self._prefetch_result, self._prefetch_done = self._prefetch_result, "", False + return result + + def _start_prefetch(self, query: str) -> None: + backend = self._backend + if not query or backend is None or self._is_breaker_open(): + return + + def _run(): + results = self._try(lambda: self._search(query, rerank=self._rerank_default, backend=backend), logger.debug, "Mem0 prefetch failed: %s") + lines = [r.get("memory", "") for r in (results or []) if r.get("memory")] + body = "## Mem0 Memory\n" + "\n".join(f"- {line}" for line in lines) if lines else "" + with self._prefetch_lock: + if self._prefetch_query == query: + self._prefetch_result, self._prefetch_done = body, True + + with self._prefetch_lock: + if self._prefetch_query == query and (self._prefetch_done or (self._prefetch_thread and self._prefetch_thread.is_alive())): + return + self._prefetch_query, self._prefetch_result, self._prefetch_done = query, "", False + self._prefetch_thread = spawn_context_thread(_run, name="mem0-prefetch") + self._prefetch_thread.start() + + def prefetch(self, query: str, *, session_id: str = "") -> str: + """Recall memories for the CURRENT question with a short hot-path wait.""" + if (cached := self._consume_prefetch_result(query)) is not None: + return cached + self._start_prefetch(query) + with self._prefetch_lock: + thread = self._prefetch_thread if self._prefetch_query == query else None + if thread: + thread.join(timeout=_PREFETCH_WAIT_SECS) + return self._consume_prefetch_result(query) or "" # slow backend: skip injection; mem0_search remains the backstop + + def sync_turn(self, user_content: str, assistant_content: str, *, session_id: str = "") -> None: + """Send the turn to Mem0 for server-side fact extraction (non-blocking).""" + if self._backend is None or self._is_breaker_open(): + return + + def _sync(): + if self._backend is not None: + messages = [ + {"role": "user", "content": _truncate_for_sync(user_content, self._sync_max_chars)}, + {"role": "assistant", "content": _truncate_for_sync(assistant_content, self._sync_max_chars)}, + ] + self._try(lambda: self._add(messages, infer=True), logger.warning, "Mem0 sync failed: %s") + + with self._sync_lock: + prev = self._sync_thread + if prev and prev.is_alive(): + prev.join(timeout=5.0) + if prev.is_alive(): + return + with self._sync_lock: + self._sync_thread = spawn_context_thread(_sync, name="mem0-sync") + self._sync_thread.start() + + def get_tool_schemas(self) -> List[Dict[str, Any]]: + return list(TOOL_SCHEMAS) + + # -- tool handlers: (required params, error label, body, client-error policy) --- + # Client errors (bad ID / not found) never trip the breaker, except for mem0_add + # where they count as failures; update/delete answer them with "Memory not found". + + def _tool_search(self, args: dict) -> str: + top_k = max(1, min(int(args.get("top_k", 10)), 50)) + rerank_raw = args.get("rerank", self._rerank_default) + rerank = rerank_raw.lower() not in ("false", "0", "no") if isinstance(rerank_raw, str) else bool(rerank_raw) + results = self._search(args["query"], top_k, rerank) + if not results: + return json.dumps({"result": "No relevant memories found."}) + items = [{"id": r.get("id"), "memory": r.get("memory", ""), "score": r.get("score", 0)} for r in results] + return json.dumps({"results": items, "count": len(items)}) + + def _tool_add(self, args: dict) -> str: + result = self._add([{"role": "user", "content": args["content"]}], infer=False) + event_id = result.get("event_id") if isinstance(result, dict) else None + # Cloud add is async (server-side extraction); OSS and self-hosted store synchronously. + msg = "Fact stored." if (self._mode == "oss" or self._host) else "Fact queued for storage." + return json.dumps({"result": msg, "event_id": event_id}) + + def _ensure_owns_memory(self, memory_id: str) -> None: + """Reject a mutation on a memory that doesn't belong to the caller's user_id.""" + memory = self._backend.get(memory_id) + if not memory: + raise ValueError(f"Memory not found: {memory_id}") + owner = memory.get("user_id") if isinstance(memory, dict) else None + if owner and owner != self._user_id: + raise PermissionError(f"Memory {memory_id} does not belong to this user.") + + def _tool_update(self, args: dict) -> str: + self._ensure_owns_memory(args["memory_id"]) + return json.dumps(self._backend.update(args["memory_id"], args["text"])) + + def _tool_delete(self, args: dict) -> str: + self._ensure_owns_memory(args["memory_id"]) + return json.dumps(self._backend.delete(args["memory_id"])) + + _TOOL_HANDLERS = { + "mem0_search": (("query",), "Search failed", _tool_search, "skip"), + "mem0_add": (("content",), "Failed to store", _tool_add, "count"), + "mem0_update": (("memory_id", "text"), "Update failed", _tool_update, "not_found"), + "mem0_delete": (("memory_id",), "Delete failed", _tool_delete, "not_found"), + } + + def handle_tool_call(self, tool_name: str, args: dict, **kwargs) -> str: + if self._backend is None: + err = getattr(self, "_init_error", "unknown error") + return json.dumps({"error": f"Mem0 backend not initialized: {err}.{self._oss_hint(' Check that {vs} is running and reachable.')}"}) + if self._is_breaker_open(): + return json.dumps({"error": f"Mem0 temporarily unavailable (multiple consecutive failures). Will retry automatically.{self._oss_hint(' Check that your {vs} is running.')}"}) + if tool_name not in self._TOOL_HANDLERS: + return tool_error(f"Unknown tool: {tool_name}") + required, label, body, on_client_error = self._TOOL_HANDLERS[tool_name] + if not isinstance(args, dict): + return tool_error("Tool arguments must be an object") + if missing := next((k for k in required if not isinstance(args.get(k), str) or not args[k].strip()), None): + return tool_error(f"Missing or invalid required parameter: {missing}") + if tool_name == "mem0_search": + try: + int(args.get("top_k", 10)) + except (TypeError, ValueError, OverflowError): + return tool_error("top_k must be an integer") + try: + result = body(self, args) + except PermissionError as e: + return tool_error(str(e)) + except Exception as e: + client = _is_client_error(e) + if client and on_client_error == "not_found": + return tool_error(f"Memory not found: {args['memory_id']}") + if not client or on_client_error == "count": + self._record_failure() + return tool_error(self._format_error(label, e)) + self._record_success() + return result + + def _shutdown_backend(self): + with suppress(Exception): + if self._backend: + self._backend.close() + self._backend = None + + def shutdown(self) -> None: + for t in (self._prefetch_thread, self._sync_thread): + if t and t.is_alive(): + # Extraction can outlast five seconds. Closing storage underneath it + # loses the turn; let the backend's network timeouts bound the drain. + t.join() + self._shutdown_backend() + + +def register(ctx) -> None: + """Register Mem0 as a memory provider plugin.""" + ctx.register_memory_provider(Mem0MemoryProvider()) + + +# ---- BEGIN PLUGIN-COMPAT (revert-scheduled; see COMPAT_MANIFEST.md) ---- +# Names external plugins imported from this module before the Sep 2026 decomposition. +# Internal code MUST NOT use these (scripts/check_compat_pointers.py fails CI if it does). +# The whole block is removed by reverting the commit that added it. + +ADD_SCHEMA = { + "name": "mem0_add", + "description": ( + "Store a durable fact about the user, verbatim (no LLM extraction). " + "Call this the moment the user states a lasting preference, correction, " + "decision, or personal detail worth recalling on future turns — don't " + "wait to be asked to remember. Skip transient chit-chat and facts you've " + "already stored." + ), + "parameters": { + "type": "object", + "properties": { + "content": {"type": "string", "description": "The fact to store."}, + }, + "required": ["content"], + }, +} + +DELETE_SCHEMA = { + "name": "mem0_delete", + "description": ( + "Delete a memory by its ID (take the ID from a mem0_search " + "result). Use when a stored fact is obsolete or the user asks you to " + "forget it; prefer mem0_update if the fact merely changed." + ), + "parameters": { + "type": "object", + "properties": { + "memory_id": {"type": "string", "description": "Memory UUID to delete."}, + }, + "required": ["memory_id"], + }, +} + +SEARCH_SCHEMA = { + "name": "mem0_search", + "description": ( + "Search the user's memories by meaning; returns facts ranked by " + "relevance. Use this before answering any question that may depend on " + "what you know about the user (preferences, facts, history, people, " + "projects, past decisions). For multi-part or multi-hop questions, " + "call it several times — vary the wording and run follow-up searches " + "on what earlier results reveal; one search is rarely enough." + ), + "parameters": { + "type": "object", + "properties": { + "query": {"type": "string", "description": "What to search for."}, + "top_k": {"type": "integer", "description": "Max results (default: 10, max: 50)."}, + "rerank": {"type": "boolean", "description": "Rerank results for relevance (default: false, platform mode only)."}, + }, + "required": ["query"], + }, +} + +UPDATE_SCHEMA = { + "name": "mem0_update", + "description": ( + "Replace the text of an existing memory by its ID (take the ID from a " + "mem0_search result). Use when a stored fact has changed " + "or was wrong — correct it in place instead of adding a duplicate." + ), + "parameters": { + "type": "object", + "properties": { + "memory_id": {"type": "string", "description": "Memory UUID to update."}, + "text": {"type": "string", "description": "New text content."}, + }, + "required": ["memory_id", "text"], + }, +} +# ---- END PLUGIN-COMPAT ---- diff --git a/integrations/hermes-plugin-mem0/_backend.py b/integrations/hermes-plugin-mem0/_backend.py new file mode 100644 index 000000000..455750207 --- /dev/null +++ b/integrations/hermes-plugin-mem0/_backend.py @@ -0,0 +1,336 @@ +"""Backend abstraction for Mem0 Platform and OSS modes.""" + +from __future__ import annotations + +import logging +import os +from abc import ABC, abstractmethod +from contextlib import closing, nullcontext, suppress +from copy import deepcopy +from dataclasses import dataclass, field +from threading import RLock +from typing import Any + +logger = logging.getLogger(__name__) + + +def _add_kwargs(user_id: str, agent_id: str, infer: bool, metadata: dict | None) -> dict[str, Any]: + return {"user_id": user_id, "agent_id": agent_id, "infer": infer, **({"metadata": metadata} if metadata else {})} + + +def _unwrap_results(response: Any) -> list: + """Normalize API response — extract results list from dict or pass through.""" + return response.get("results", []) if isinstance(response, dict) else response if isinstance(response, list) else [] + + +class Mem0Backend(ABC): + """Unified interface over Platform (MemoryClient), self-hosted (HTTP) and OSS (Memory) backends. + update()/delete() are template methods: subclasses implement raw ``_update``/``_delete``.""" + + @abstractmethod + def search(self, query: str, *, filters: dict, top_k: int = 10, rerank: bool = False) -> list[dict]: ... + @abstractmethod + def add(self, messages: list, *, user_id: str, agent_id: str, infer: bool = False, metadata: dict | None = None) -> dict: ... + @abstractmethod + def get(self, memory_id: str) -> dict | None: ... + @abstractmethod + def _update(self, memory_id: str, text: str) -> None: ... + @abstractmethod + def _delete(self, memory_id: str) -> None: ... + + def update(self, memory_id: str, text: str) -> dict: + self._update(memory_id, text) + return {"result": "Memory updated.", "memory_id": memory_id} + + def delete(self, memory_id: str) -> dict: + self._delete(memory_id) + return {"result": "Memory deleted.", "memory_id": memory_id} + + def close(self) -> None: + pass + + +class PlatformBackend(Mem0Backend): + """Wraps mem0.MemoryClient for Mem0 Platform (cloud API).""" + + def __init__(self, api_key: str): + from mem0 import MemoryClient + self._client = MemoryClient(api_key=api_key) + + def search(self, query: str, *, filters: dict, top_k: int = 10, rerank: bool = False) -> list[dict]: + return _unwrap_results(self._client.search(query, filters=filters, top_k=top_k, rerank=rerank)) + + def add(self, messages: list, *, user_id: str, agent_id: str, infer: bool = False, metadata: dict | None = None) -> dict: + return self._client.add(messages, **_add_kwargs(user_id, agent_id, infer, metadata)) + + def get(self, memory_id: str) -> dict | None: + return self._client.get(memory_id) + + def _update(self, memory_id: str, text: str) -> None: + self._client.update(memory_id=memory_id, text=text) + + def _delete(self, memory_id: str) -> None: + self._client.delete(memory_id=memory_id) + + +class SelfHostedBackend(Mem0Backend): + """Direct HTTP backend for a self-hosted Mem0 server (the FastAPI ``server/``). + mem0.MemoryClient is hardwired to the cloud API (``Authorization: Token``, ``GET /v1/ping/`` in ``__init__``), + so this speaks the server's real contract: ``X-API-Key`` auth and the ``/memories`` / ``/search`` routes.""" + + def __init__(self, api_key: str, host: str, transport=None): + import httpx + headers = {"Content-Type": "application/json", **({"X-API-Key": api_key} if api_key else {})} # key omitted only for AUTH_DISABLED servers + # Connect-level retries keep one dropped SYN from counting toward the breaker. ``transport`` is injectable for tests. + self._client = httpx.Client(base_url=host.rstrip("/"), headers=headers, timeout=30.0, transport=transport or httpx.HTTPTransport(retries=2)) + self._capture_timeout = httpx.Timeout(120.0, connect=30.0) + + def _json(self, method: str, path: str, **kwargs) -> Any: + resp = self._client.request(method, path, **kwargs) + resp.raise_for_status() + return resp.json() if resp.content else {} + + def search(self, query: str, *, filters: dict, top_k: int = 10, rerank: bool = False) -> list[dict]: + # rerank is platform-only; the self-hosted /search ignores it. user_id belongs in filters (top-level is deprecated). + return _unwrap_results(self._json("POST", "/search", json={"query": query, "top_k": top_k, **({"filters": filters} if filters else {})})) + + def add(self, messages: list, *, user_id: str, agent_id: str, infer: bool = False, metadata: dict | None = None) -> dict: + # Server-side extraction takes longer than a search or verbatim write. + return self._json("POST", "/memories", json={"messages": messages, **_add_kwargs(user_id, agent_id, infer, metadata)}, + timeout=self._capture_timeout if infer else self._client.timeout) + + def get(self, memory_id: str) -> dict | None: + return self._json("GET", f"/memories/{memory_id}") + + def _update(self, memory_id: str, text: str) -> None: + self._json("PUT", f"/memories/{memory_id}", json={"text": text}) + + def _delete(self, memory_id: str) -> None: + self._json("DELETE", f"/memories/{memory_id}") + + def close(self) -> None: + with suppress(Exception): + self._client.close() + + +_DIRECT_OPENAI_PROVIDER = "hermes_openai" +_DIRECT_OPENAI_CLASS_PATH = f"{__package__}._openai_llm.DirectOpenAILLM" + + +@dataclass +class _LocalQdrantMemory: + memory: Any + config: dict + profile: str + lock: Any = field(default_factory=RLock) + users: int = 1 + + +_LOCAL_QDRANT_MEMORIES: dict[str, _LocalQdrantMemory] = {} +_LOCAL_QDRANT_LOCK = RLock() + + +def _register_direct_openai_provider() -> None: + """Register Hermes' OpenAI-only Mem0 LLM provider once per factory.""" + from mem0.configs.llms.openai import OpenAIConfig + from mem0.utils.factory import LlmFactory + provider_map = getattr(LlmFactory, "provider_to_class", None) + register_provider = getattr(LlmFactory, "register_provider", None) + if not isinstance(provider_map, dict) or not callable(register_provider): + raise RuntimeError("mem0 LlmFactory does not support the provider registration required for the Hermes OpenAI OSS backend") + if provider_map.get(_DIRECT_OPENAI_PROVIDER) != (_DIRECT_OPENAI_CLASS_PATH, OpenAIConfig): + register_provider(_DIRECT_OPENAI_PROVIDER, _DIRECT_OPENAI_CLASS_PATH, OpenAIConfig) + + +class OSSBackend(Mem0Backend): + """Wraps mem0.Memory for self-hosted (OSS) mode.""" + + def __init__(self, oss_config: dict): + from ._oss_providers import EMBEDDER_PROVIDERS, KNOWN_DIMS, LLM_PROVIDERS + + self._local_path = None + self._owner = None + self._lock = nullcontext() + self._closed = False + + def _provider_block(name: str, registry: dict) -> dict: + """Copy of oss_config[name] with the legacy ``api_base`` key mapped to the provider's canonical base-URL key.""" + block = dict(oss_config[name]) + provider_config = dict(block.get("config", {})) + legacy_base = provider_config.pop("api_base", None) + canonical_key = registry.get(str(block.get("provider") or "").strip().lower(), {}).get("base_url_key") + if legacy_base and canonical_key: + provider_config.setdefault(canonical_key, legacy_base) + if str(block.get("provider") or "").strip().lower() == "openai": + from agent.secret_scope import get_secret + + # Resolve profile secrets before comparing configurations for sharing. + provider_config["api_key"] = provider_config.get("api_key") or get_secret("OPENAI_API_KEY", "") + if not provider_config["api_key"]: + raise ValueError(f"OpenAI API key is required for the Hermes Mem0 OSS {name}") + provider_config["openai_base_url"] = ( + provider_config.get("openai_base_url") or get_secret("OPENAI_API_BASE", "") + or get_secret("OPENAI_BASE_URL", "") or "https://api.openai.com/v1" + ) + block["config"] = provider_config + return block + + vector_store = dict(oss_config["vector_store"]) + vs_config = dict(vector_store.get("config", {})) + if vs_config.get("path"): + vs_config["path"] = os.path.expanduser(vs_config["path"]) + embedder_config = oss_config.get("embedder", {}).get("config", {}) + dims = embedder_config.get("embedding_dims") or KNOWN_DIMS.get(embedder_config.get("model", "")) + if dims: + vs_config["embedding_model_dims"] = dims + remote = (vs_config.get("host") and vs_config.get("port")) or vs_config.get("url") or vs_config.get("api_key") + if (vector_store.get("provider", "qdrant") == "qdrant" and not vs_config.get("client") + and not remote and vs_config.get("https") is None): + from mem0.configs.vector_stores.qdrant import QdrantConfig + path = vs_config.get("path", QdrantConfig.model_fields["path"].default) + if path: + self._local_path = vs_config["path"] = os.path.realpath(os.path.expanduser(path)) + vector_store["config"] = vs_config + config = {"vector_store": vector_store, "llm": _provider_block("llm", LLM_PROVIDERS), "embedder": _provider_block("embedder", EMBEDDER_PROVIDERS), "version": "v1.1"} + if self._local_path: + from hermes_constants import get_hermes_home + profile = os.path.realpath(get_hermes_home()) + with _LOCAL_QDRANT_LOCK: + owner = _LOCAL_QDRANT_MEMORIES.get(self._local_path) + if owner is None: + owner = _LocalQdrantMemory(self._create_memory(config, dims), deepcopy(config), profile) + _LOCAL_QDRANT_MEMORIES[self._local_path] = owner + else: + if owner.profile != profile or owner.config != config: + raise ValueError("Local Qdrant storage is already open with a different profile or configuration. " + "Existing memories were preserved. Close its active sessions before changing settings, " + "or use a separate storage path.") + owner.users += 1 + self._owner, self._lock, self._memory = owner, owner.lock, owner.memory + else: + self._memory = self._create_memory(config, dims) + + @staticmethod + def _create_memory(config: dict, dims: int | None): + from mem0 import Memory + vector_store = config["vector_store"] + vs_config = vector_store["config"] + if dims: + OSSBackend._reject_dimension_mismatch(vector_store.get("provider", "qdrant"), vs_config, dims) + else: + logger.warning("Unknown embedding dimensions; skipping dimension-change guard for collection %r.", + vs_config.get("collection_name", "mem0")) + if str(config["llm"].get("provider") or "").strip().lower() == "openai": + # mem0 validates LlmConfig.provider before its factory lookup: build the supported OpenAI config, then swap the provider. + _register_direct_openai_provider() + from mem0.configs.base import MemoryConfig + memory_config = MemoryConfig(**config) + try: + memory_config.llm.provider = _DIRECT_OPENAI_PROVIDER + except (AttributeError, TypeError) as exc: + raise RuntimeError("mem0 MemoryConfig does not expose a mutable llm.provider for the Hermes OpenAI OSS backend") from exc + return Memory(memory_config) + return Memory.from_config(config) + + @staticmethod + def _detect_current_dims(provider: str, vs_config: dict, collection_name: str) -> int | None: + """Current embedding dimension of ``collection_name``, or None if it doesn't exist yet. + Raises on any failure to connect/inspect so the caller can decide whether to skip the guard.""" + if provider == "qdrant": + from qdrant_client import QdrantClient + path, url, host = vs_config.get("path"), vs_config.get("url"), vs_config.get("host") + if path: + client = QdrantClient(path=path) + elif url: + client = QdrantClient(url=url, api_key=vs_config.get("api_key")) + elif host: + client = QdrantClient(host=host, port=vs_config.get("port") or 6333, api_key=vs_config.get("api_key")) + else: + return None + with closing(client): + if not client.collection_exists(collection_name): + return None + vectors = client.get_collection(collection_name).config.params.vectors + # Named-vector collections expose a dict; unnamed expose an object with .size. + if isinstance(vectors, dict): + vectors = next(iter(vectors.values()), None) + return getattr(vectors, "size", None) + elif provider == "pgvector": + import psycopg2 + conn_params = {k: vs_config[k] for k in ("host", "port", "user", "password", "dbname", "sslmode") if vs_config.get(k)} + with closing(psycopg2.connect(**conn_params)) as conn: + conn.autocommit = True + with closing(conn.cursor()) as cur: + cur.execute("SELECT atttypmod FROM pg_attribute WHERE attrelid = %s::regclass AND attname = 'vector'", (collection_name,)) + row = cur.fetchone() + return row[0] if row and row[0] > 0 else None + return None + + @staticmethod + def _reject_dimension_mismatch(provider: str, vs_config: dict, expected_dims: int) -> None: + """Reject embedding dimension changes without deleting existing memories.""" + collection_name = vs_config.get("collection_name", "mem0") + try: + current_dims = OSSBackend._detect_current_dims(provider, vs_config, collection_name) + except Exception as dimension_detection_error: + logger.warning( + "Could not determine embedding dimensions for collection %r (%s): %s. Skipping dimension-change guard.", + collection_name, provider, dimension_detection_error, + ) + return + if current_dims is not None and current_dims != expected_dims: + raise ValueError( + f"Collection {collection_name!r} has {current_dims} embedding dimensions, but {expected_dims} are configured. " + "Existing memories were preserved. Restore the previous embedder or use a new collection_name." + ) + + def search(self, query: str, *, filters: dict, top_k: int = 10, rerank: bool = False) -> list[dict]: + return _unwrap_results(self._call("search", query, filters=filters, top_k=top_k)) + + def add(self, messages: list, *, user_id: str, agent_id: str, infer: bool = False, metadata: dict | None = None) -> dict: + return self._call("add", messages, **_add_kwargs(user_id, agent_id, infer, metadata)) + + def get(self, memory_id: str) -> dict | None: + return self._call("get", memory_id) + + def _update(self, memory_id: str, text: str) -> None: + self._call("update", memory_id, data=text) + + def _delete(self, memory_id: str) -> None: + self._call("delete", memory_id) + + def _call(self, method, *args, **kwargs): + # ponytail: serialize whole local SDK operations, including extraction's read/modify/write. + # Use a Qdrant server for parallel throughput or access from multiple processes. + with self._lock: + if self._closed: + raise RuntimeError("Mem0 backend is closed") + return getattr(self._memory, method)(*args, **kwargs) + + def close(self): + with self._lock: + if self._closed: + return + self._closed = True + if self._owner: + with _LOCAL_QDRANT_LOCK: + self._owner.users -= 1 + if self._owner.users == 0: + self._close_memory() + del _LOCAL_QDRANT_MEMORIES[self._local_path] + else: + self._close_memory() + + def _close_memory(self): + with suppress(Exception): + telemetry = getattr(self._memory, "telemetry", None) + if telemetry and hasattr(telemetry, "posthog"): + with suppress(Exception): + telemetry.posthog.shutdown() + vs = getattr(self._memory, "vector_store", None) + telemetry_vs = getattr(self._memory, "_telemetry_vector_store", None) + resources = (self._memory, vs, getattr(vs, "client", None), getattr(telemetry_vs, "client", None)) + for obj in {id(obj): obj for obj in resources if obj is not None}.values(): + if hasattr(obj, "close"): + with suppress(Exception): + obj.close() diff --git a/integrations/hermes-plugin-mem0/_openai_llm.py b/integrations/hermes-plugin-mem0/_openai_llm.py new file mode 100644 index 000000000..ed1296364 --- /dev/null +++ b/integrations/hermes-plugin-mem0/_openai_llm.py @@ -0,0 +1,66 @@ +"""OpenAI-only LLM adapter for Mem0 OSS mode.""" + +from __future__ import annotations + +import logging +from typing import Dict, List, Optional, Union + +from mem0.configs.llms.base import BaseLlmConfig +from mem0.configs.llms.openai import OpenAIConfig +from mem0.llms.base import LLMBase +from mem0.llms.openai import OpenAILLM + +# BaseLlmConfig fields copied into OpenAIConfig; the last two may be absent on older mem0. +_COPIED_FIELDS = ("model", "temperature", "api_key", "max_tokens", "top_p", "top_k", "enable_vision", "vision_details", "http_client_proxies") +_OPTIONAL_FIELDS = ("reasoning_effort", "is_reasoning_model") + + +class DirectOpenAILLM(OpenAILLM): + """Use OpenAI credentials and requests regardless of router environment.""" + + def __init__(self, config: Optional[Union[BaseLlmConfig, OpenAIConfig, Dict]] = None): + if config is None: + config = OpenAIConfig() + elif isinstance(config, dict): + config = OpenAIConfig(**config) + elif isinstance(config, BaseLlmConfig) and not isinstance(config, OpenAIConfig): + fields = {k: getattr(config, k) for k in _COPIED_FIELDS} + fields.update({k: getattr(config, k, None) for k in _OPTIONAL_FIELDS}) + config = OpenAIConfig(**fields) + if not config.model: + config.model = "gpt-5-mini" + # Configs predating the setup marker: keep the default model reasoning-safe + # without overriding an explicit user choice. + if config.model == "gpt-5-mini" and config.is_reasoning_model is None: + config.is_reasoning_model = True + # Bypass OpenAILLM.__init__ (it picks OpenRouter when OPENROUTER_API_KEY is + # set); LLMBase still owns validation and supported-parameter filtering. + LLMBase.__init__(self, config) + # OPENAI_API_KEY / OPENAI_BASE_URL are profile credentials: read them through the secret + # scope, never raw os.environ, or a multiplexed secondary's memory extraction runs on the + # default profile's OpenAI account (and its proxy). + from agent.secret_scope import get_secret + api_key = self.config.api_key or get_secret("OPENAI_API_KEY", "") + if not api_key: + raise ValueError("OpenAI API key is required for the Hermes Mem0 OSS provider") + from openai import OpenAI + self.client = OpenAI(api_key=api_key, base_url=self.config.openai_base_url or get_secret("OPENAI_API_BASE", "") or get_secret("OPENAI_BASE_URL", "") or "https://api.openai.com/v1", timeout=120.0) + + def generate_response(self, messages: List[Dict[str, str]], response_format=None, tools: Optional[List[Dict]] = None, tool_choice: str = "auto", **kwargs): + params = self._get_supported_params(messages=messages, **kwargs) + params.update({"model": self.config.model, "messages": messages}) + # No OpenRouter-only fields; ``store`` is opt-in so OpenAI-compatible endpoints never receive unknown fields. + if self.config.store is not None: + params["store"] = self.config.store + if response_format: + params["response_format"] = response_format + if tools: + params["tools"], params["tool_choice"] = tools, tool_choice + response = self.client.chat.completions.create(**params) + parsed_response = self._parse_response(response, tools) + if self.config.response_callback: + try: + self.config.response_callback(self, response, params) + except Exception: + logging.error("Error running Mem0 OpenAI response callback") + return parsed_response diff --git a/integrations/hermes-plugin-mem0/_oss_providers.py b/integrations/hermes-plugin-mem0/_oss_providers.py new file mode 100644 index 000000000..c6ced627f --- /dev/null +++ b/integrations/hermes-plugin-mem0/_oss_providers.py @@ -0,0 +1,53 @@ +"""OSS provider definitions for LLM, embedder, and vector store.""" + +from __future__ import annotations + +import os +from typing import Any + +from hermes_constants import get_hermes_home + +LLM_PROVIDERS: dict[str, dict[str, Any]] = { + "openai": {"label": "OpenAI", "needs_key": True, "env_var": "OPENAI_API_KEY", "default_model": "gpt-5-mini", "base_url_key": "openai_base_url"}, + "ollama": {"label": "Ollama (local)", "needs_key": False, "default_model": "llama3.1:8b", "default_url": "http://localhost:11434", "base_url_key": "ollama_base_url", "pip_dep": "ollama"}, +} + +EMBEDDER_PROVIDERS: dict[str, dict[str, Any]] = { + "openai": {"label": "OpenAI", "needs_key": True, "env_var": "OPENAI_API_KEY", "default_model": "text-embedding-3-small", "base_url_key": "openai_base_url", "dims": 1536}, + "ollama": {"label": "Ollama (local)", "needs_key": False, "default_model": "nomic-embed-text", "default_url": "http://localhost:11434", "base_url_key": "ollama_base_url", "dims": 768, "pip_dep": "ollama"}, +} + +VECTOR_PROVIDERS: dict[str, dict[str, Any]] = { + # Resolved lazily (see ``vector_default_config``): the profile home is a ContextVar at call time, + # not an import-time constant, and ``~/.hermes`` is wrong on Windows and under profiles. + "qdrant": {"label": "Qdrant", "default_config": {"path": lambda: str(get_hermes_home() / "mem0_qdrant")}, "pip_dep": "qdrant-client"}, + "pgvector": { + "label": "PGVector", + "default_config": {"host": "localhost", "port": 5432, "user": os.getenv("USER", "postgres"), "dbname": "postgres"}, + "pip_dep": "psycopg2-binary", + }, +} + +KNOWN_DIMS: dict[str, int] = {"text-embedding-3-small": 1536, "text-embedding-3-large": 3072, "text-embedding-ada-002": 1536, "nomic-embed-text": 768} + +def vector_default_config(provider_id: str) -> dict[str, Any]: + """A vector store's ``default_config`` with callable defaults resolved for the active profile.""" + return {k: (v() if callable(v) else v) for k, v in VECTOR_PROVIDERS[provider_id]["default_config"].items()} + + +SECTION_REGISTRIES = (("llm", LLM_PROVIDERS), ("embedder", EMBEDDER_PROVIDERS), ("vector_store", VECTOR_PROVIDERS)) + + +def validate_oss_config(oss_config: dict) -> list[str]: + """Validate an OSS config dict. Returns list of error strings (empty = valid).""" + errors: list[str] = [] + for section, registry in SECTION_REGISTRIES: + block = oss_config.get(section) + if not block or not isinstance(block, dict): + errors.append(f"Missing required section: {section}") + elif block.get("provider", "") not in registry: + errors.append(f"Unknown {section} provider '{block.get('provider', '')}'. Valid: {', '.join(registry.keys())}") + vs = oss_config.get("vector_store", {}) + if vs.get("provider") == "pgvector" and not vs.get("config", {}).get("user"): + errors.append("PGVector requires 'user' in vector_store.config") + return errors diff --git a/integrations/hermes-plugin-mem0/_setup.py b/integrations/hermes-plugin-mem0/_setup.py new file mode 100644 index 000000000..302129c18 --- /dev/null +++ b/integrations/hermes-plugin-mem0/_setup.py @@ -0,0 +1,567 @@ +"""Setup wizard for Mem0 plugin — interactive and flag-based modes.""" + +from __future__ import annotations + +import getpass +import json +import os +import re +import secrets +import shutil +import socket +import subprocess +import sys +import time +import urllib.error +import urllib.request +from contextlib import suppress +from pathlib import Path +from typing import Any + +from hermes_constants import get_hermes_home # noqa: F401 — patched by tests + +from ._oss_providers import ( + EMBEDDER_PROVIDERS, + KNOWN_DIMS, + LLM_PROVIDERS, + SECTION_REGISTRIES, + VECTOR_PROVIDERS, + validate_oss_config, + vector_default_config, +) + +_OLLAMA_URL = "http://localhost:11434" +_PGVECTOR_CONTAINER, _PGVECTOR_IMAGE = "hermes-pgvector", "pgvector/pgvector:pg17" + + +def _version_tuple(version: str) -> tuple[int, ...]: + """Best-effort (major, minor, patch) from a version string, tolerating pre-release suffixes like '2.1.0rc1'.""" + parts = version.split(".")[:3] + return tuple(int(m.group()) if (m := re.match(r"\d+", p)) else 0 for p in parts) + + +def _scrub(text: str, *secrets_to_hide: str) -> str: + """Replace any occurrence of the given secrets in ``text`` (e.g. before printing a subprocess error).""" + for secret in secrets_to_hide: + if secret: + text = text.replace(secret, "***") + return text + + +def _curses_select(title: str, items: list[tuple[str, str]], default: int = 0) -> int: + from hermes_cli.curses_ui import curses_radiolist + return curses_radiolist(title, [f"{label} {desc}" if desc else label for label, desc in items], selected=default, cancel_returns=default) + + +def _prompt(label: str, default: str | None = None, secret: bool = False) -> str: + """Prompt for a value with optional default and secret masking.""" + sys.stdout.write(f" {label}{f' [{default}]' if default else ''}: ") + sys.stdout.flush() + val = getpass.getpass(prompt="") if secret and sys.stdin.isatty() else sys.stdin.readline().strip() + return val or (default or "") + + +def _input(label: str, default: str) -> str: + return input(f" {label} [{default}]: ").strip() or default + + +def _masked(secret: str) -> str: + return f"...{secret[-4:]}" if len(secret) > 4 else "set" + + +def _http_get(url: str, path: str, timeout: int): + return urllib.request.urlopen(urllib.request.Request(f"{url.rstrip('/')}{path}", method="GET"), timeout=timeout) + + +def _prompt_api_key(label: str, env_var: str, hermes_home: str) -> str: + """Prompt for API key, showing masked existing value if found.""" + existing = os.environ.get(env_var, "") + if not existing: + from agent.secret_scope import load_env_file + + existing = load_env_file(Path(hermes_home) / ".env").get(env_var, "") + hint = f" (current: {_masked(existing)}, blank to keep)" if existing else "" + return getpass.getpass(f" {label} API key{hint}: ").strip() + + +def _api_key_writes(flags: dict, label: str, *, url: str | None = None, fresh_label: str | None = None) -> dict[str, str]: + """MEM0_API_KEY for .env: from --api-key, else prompt (masking any key already in the environment).""" + if flags.get("api_key"): + return {"MEM0_API_KEY": flags["api_key"]} + existing = os.environ.get("MEM0_API_KEY", "") + if url and not existing: + print(f" Get yours at {url}") + val = _prompt(f"{label} (current: {_masked(existing)}, blank to keep)" if existing else fresh_label or label, secret=True) + return {"MEM0_API_KEY": val} if val else {} + + +def _print_dry_run(summary: str, env_writes: dict, check=None) -> None: + print(f"\n [dry-run] Would save config: {summary}") + if env_writes: + print(" [dry-run] Would write API key to .env") + if check: + check() + print(" [dry-run] No files written.\n") + + +# --oss-vector- flags accepted per vector store (also the pgvector key order). +_VECTOR_FLAG_KEYS = {"qdrant": ("path", "url"), "pgvector": ("host", "port", "user", "password", "dbname")} +_FLAG_KEYS = ("mode", "api_key", "host", *(f"oss_{s}{k}" for s in ("llm", "embedder") for k in ("", "_key", "_model", "_url")), + "oss_vector", *(f"oss_vector_{k}" for ks in _VECTOR_FLAG_KEYS.values() for k in ks), "user_id") +_FLAG_DEFAULTS = {"oss_llm": "openai", "oss_embedder": "openai", "oss_vector": "qdrant"} + + +def parse_flags(argv: list[str] | None = None) -> dict[str, str]: + args = argv if argv is not None else sys.argv[1:] + flags: dict[str, Any] = {**{k: _FLAG_DEFAULTS.get(k, "") for k in _FLAG_KEYS}, "dry_run": False} + flag_map = {"--" + k.replace("_", "-"): k for k in _FLAG_KEYS} + i = 0 + while i < len(args): + if args[i] == "--dry-run": + flags["dry_run"] = True + elif args[i] in flag_map and i + 1 < len(args): + flags[flag_map[args[i]]] = args[i + 1] + i += 1 + i += 1 + return flags + + +def _model_block(flags: dict, registry: dict, prefix: str) -> tuple[str, dict, dict[str, Any]]: + """Resolve (provider_id, provider_def, config) for an LLM/embedder section from flags.""" + pid = flags.get(prefix, "openai") + pdef = registry[pid] + cfg: dict[str, Any] = {"model": flags.get(f"{prefix}_model") or pdef["default_model"]} + url = flags.get(f"{prefix}_url") or pdef.get("default_url") + if url and pdef.get("base_url_key"): + cfg[pdef["base_url_key"]] = url + return pid, pdef, cfg + + +def build_oss_config(flags: dict[str, str]) -> tuple[dict, dict[str, str]]: + """Build (oss_config for mem0.json, env_writes of secrets for .env) from parsed flags.""" + llm_id, llm_def, llm_config = _model_block(flags, LLM_PROVIDERS, "oss_llm") + if llm_id == "openai" and llm_config["model"] == "gpt-5-mini": + llm_config["is_reasoning_model"] = True + embedder_id, embedder_def, embedder_config = _model_block(flags, EMBEDDER_PROVIDERS, "oss_embedder") + dims = KNOWN_DIMS.get(embedder_config["model"]) + if dims: + embedder_config["embedding_dims"] = dims + vector_id = flags.get("oss_vector", "qdrant") + vector_config = vector_default_config(vector_id) + for key in _VECTOR_FLAG_KEYS.get(vector_id, ()): + if val := flags.get(f"oss_vector_{key}"): + if key == "port" and not val.isdigit(): + raise ValueError(f"--oss-vector-port must be a number, got {val!r}") + vector_config[key] = int(val) if key == "port" else val + if "url" in vector_config: + vector_config.pop("path", None) # a remote Qdrant URL replaces local storage + oss_config = {"llm": {"provider": llm_id, "config": llm_config}, "embedder": {"provider": embedder_id, "config": embedder_config}, "vector_store": {"provider": vector_id, "config": vector_config}} + # An embedder sharing the LLM's provider reuses the LLM key when no embedder key was given. + llm_key = flags.get("oss_llm_key") if llm_def.get("needs_key") else "" + emb_key = (flags.get("oss_embedder_key") or (flags.get("oss_llm_key") if embedder_id == llm_id else "")) if embedder_def.get("needs_key") else "" + env_writes = {d["env_var"]: k for d, k in ((llm_def, llm_key), (embedder_def, emb_key)) if k} + if llm_key and emb_key and llm_key != emb_key and llm_def["env_var"] == embedder_def["env_var"]: + # One environment variable cannot hold two accounts; save explicit keys in the private config. + llm_config["api_key"], embedder_config["api_key"] = llm_key, emb_key + env_writes.pop(llm_def["env_var"]) + return oss_config, env_writes + + +def _write_env(env_path: Path, env_writes: dict[str, str]) -> None: + env_path.parent.mkdir(parents=True, exist_ok=True) + # utf-8-sig like the canonical .env readers: a BOM'd first line would miss the key match and get duplicated. + existing_lines = env_path.read_text(encoding="utf-8-sig").splitlines() if env_path.exists() else [] + keys = [line.split("=", 1)[0].strip() if "=" in line and not line.startswith("#") else None for line in existing_lines] + new_lines = [f"{k}={env_writes[k]}" if k in env_writes else line for k, line in zip(keys, existing_lines)] + new_lines += [f"{k}={v}" for k, v in env_writes.items() if k not in keys] + from utils import atomic_write_text + + atomic_write_text(env_path, "\n".join(new_lines) + "\n", mode=0o600) + + +def _activate_provider(config: dict) -> None: + """Point config.yaml's memory.provider at mem0.""" + from hermes_cli.config import save_config + config["memory"]["provider"] = "mem0" + save_config(config) + + +def _persist_provider_config(hermes_home: str, config: dict, provider_config: dict, env_writes: dict[str, str], label: str, key_line: str, server: str | None = None) -> None: + """Shared platform/self-hosted tail: activate, write mem0.json (0600), then .env, then a saved summary.""" + _activate_provider(config) + from . import Mem0MemoryProvider + if "MEM0_API_KEY" in env_writes: + provider_config["api_key"] = "" # Let the newly saved .env key replace legacy inline credentials. + Mem0MemoryProvider().save_config(provider_config, hermes_home) + if env_writes: + _write_env(Path(hermes_home) / ".env", env_writes) + if server: + _check_selfhosted_server(server) + print("\n".join(["", f" Memory provider: {label}", *([f" Server: {server}"] if server else []), " Activation saved to config.yaml", " Provider config saved", + *([f" {key_line}"] if env_writes else []), "", " Start a new session to activate.", ""])) + + +def _setup_platform(hermes_home: str, config: dict, flags: dict[str, str]) -> None: + """Platform mode setup — prompts for API key (secret -> .env), user/agent ids and rerank (-> mem0.json).""" + from utils import read_json_or_empty + provider_config = read_json_or_empty(Path(hermes_home) / "mem0.json") + print("\n Configuring mem0:\n") + env_writes = _api_key_writes(flags, "Mem0 Platform API key", url="https://app.mem0.ai") + for key, desc, default in (("user_id", "User identifier", "hermes-user"), ("agent_id", "Agent identifier", "hermes")): + if val := flags.get(key) or _prompt(desc, default=str(provider_config.get(key) or default)): + provider_config[key] = val + choices = ["true", "false"] + current = str(provider_config.get("rerank", "false") or "").lower() + provider_config["rerank"] = choices[_curses_select(" Enable reranking for recall", [(c, "") for c in choices], default=choices.index(current) if current in choices else 0)] + if flags.get("dry_run"): + _print_dry_run(str({k: provider_config.get(k) for k in ("user_id", "agent_id", "rerank")}), env_writes) + return + # Routing checks ``host`` before platform, so clear a stale self-hosted host. "" rather than + # pop(): save_config merges into the existing mem0.json, so a popped key would survive. + provider_config.update(mode="platform", host="") + # _load_config() also seeds ``host`` from MEM0_HOST (.env); the file clear can't help there, so warn. + if os.environ.get("MEM0_HOST", "").strip(): + print(f"\n ⚠ MEM0_HOST is set in your environment ({os.environ['MEM0_HOST']}). It overrides platform mode — remove it from ~/.hermes/.env (or unset it) or Hermes will keep routing to the self-hosted server.") + _persist_provider_config(hermes_home, config, provider_config, env_writes, "mem0", "API keys saved to .env") + + +def _check_selfhosted_server(host: str) -> None: + """Best-effort reachability check for a self-hosted Mem0 server (non-fatal).""" + try: + _http_get(host, "/docs", 5) + print(f" ✓ Mem0 server reachable at {host}") + except urllib.error.HTTPError: + # Any HTTP response (401/403/404) still means something is listening. + print(f" ✓ Mem0 server responding at {host}") + except Exception: + print(f" ⚠ Could not reach {host} — check the URL and that the server is running.") + + +def _setup_selfhosted(hermes_home: str, config: dict, flags: dict[str, str]) -> None: + """Self-hosted mode — point at an existing Mem0 server: URL -> mem0.json, key -> .env (MEM0_API_KEY).""" + from utils import read_json_or_empty + provider_config = read_json_or_empty(Path(hermes_home) / "mem0.json") + print("\n Configuring mem0 (self-hosted server):\n") + host = flags.get("host") or _prompt("Mem0 server URL (e.g. http://localhost:8888)", default=provider_config.get("host") or None) + if not host: + print(" Error: a server URL is required for self-hosted mode.", file=sys.stderr) + return + host = host.rstrip("/") + env_writes = _api_key_writes(flags, "Server API key", fresh_label="Server API key (blank if AUTH_DISABLED)") + user_id = flags.get("user_id") or _prompt("User identifier", default=provider_config.get("user_id") or "hermes-user") + agent_id = _prompt("Agent identifier", default=provider_config.get("agent_id") or "hermes") + if flags.get("dry_run"): + _print_dry_run(f"host={host}, user_id={user_id}, agent_id={agent_id}", env_writes, lambda: _check_selfhosted_server(host)) + return + provider_config.update(mode="platform", host=host, user_id=user_id, agent_id=agent_id) # routing: oss > host > platform + _persist_provider_config(hermes_home, config, provider_config, env_writes, "mem0 (self-hosted)", "API key saved to .env", server=host) + + +def _print_oss_summary(oss_config: dict, env_writes: dict, dry_run: bool = False) -> None: + llm, emb = oss_config["llm"], oss_config["embedder"] + w = 0 if dry_run else 9 # final summary column-aligns the labels + lines = ["", " [dry-run] OSS config would be:" if dry_run else " ✓ Mem0 configured (OSS mode)", + f" {'LLM:':<{w}} {llm['provider']} ({llm['config'].get('model', '')})", f" {'Embedder:':<{w}} {emb['provider']} ({emb['config'].get('model', '')})", + f" {'Vector:':<{w}} {oss_config['vector_store']['provider']}"] + if dry_run: + lines += [f" Env vars: {', '.join(env_writes.keys())}"] if env_writes else [] + else: + lines += [*([" API keys saved to .env"] if env_writes else []), " Config saved to mem0.json", " Provider set in config.yaml", "", " Start a new session to activate.", ""] + print("\n".join(lines)) + + +def _finish_oss(hermes_home: str, config: dict, oss_config: dict, env_writes: dict[str, str], user_id: str, agent_id: str, pgvector_config: dict | None = None) -> None: + """Shared OSS tail: write secrets + mem0.json, install deps, activate, check, summarize.""" + from . import Mem0MemoryProvider + if env_writes: + _write_env(Path(hermes_home) / ".env", env_writes) + Mem0MemoryProvider().save_config( + {"mode": "oss", "user_id": user_id, "agent_id": agent_id, "oss": oss_config}, hermes_home + ) + _install_provider_deps(oss_config["llm"]["provider"], oss_config["embedder"]["provider"], oss_config["vector_store"]["provider"]) + if pgvector_config: + _ensure_pgvector_extension(pgvector_config) + _activate_provider(config) + _run_connectivity_checks(oss_config) + _print_oss_summary(oss_config, env_writes) + + +def _setup_oss(hermes_home: str, config: dict, flags: dict[str, str]) -> None: + """OSS mode — non-interactive when --mode was given, otherwise curses pickers.""" + if not flags.get("_mode_from_flag"): + _setup_oss_interactive(hermes_home, config) + return + try: + oss_config, env_writes = build_oss_config(flags) + except ValueError as e: + print(f" Error: {e}", file=sys.stderr) + sys.exit(1) + if errors := validate_oss_config(oss_config): + print("".join(f" Error: {e}\n" for e in errors), end="", file=sys.stderr) + sys.exit(1) + if flags.get("dry_run"): + _print_oss_summary(oss_config, env_writes, dry_run=True) + _run_connectivity_checks(oss_config) + print(" [dry-run] No files written.\n") + return + _finish_oss(hermes_home, config, oss_config, env_writes, flags.get("user_id") or os.getenv("USER", "hermes-user"), "hermes") + + +def _docker(*args: str, timeout: int, **kwargs) -> subprocess.CompletedProcess: + return subprocess.run(["docker", *args], capture_output=True, timeout=timeout, stdin=subprocess.DEVNULL, **kwargs) + + +def _pg_ready(host: str, port: int, wait: int) -> bool: + """Wait up to ``wait`` seconds for the port, then report whether PostgreSQL answers.""" + _wait_for_port(host, port, timeout=wait) + return _check_pgvector(host, port)[0] + + +def _ensure_pgvector(host: str = "localhost", port: int = 5432) -> dict | None: + """Ensure pgvector is reachable, offering Docker if not; returns the started container's vector_config, else None.""" + if _check_pgvector(host, port)[0]: + print(f" ✓ PostgreSQL reachable at {host}:{port}") + return None + print(f" PostgreSQL not reachable at {host}:{port}") + if not shutil.which("docker"): + print(" Docker not found. Install Docker to auto-start pgvector,\n or run PostgreSQL with pgvector manually.") + return None + with suppress(Exception): # restart our own container if it exists but is stopped + result = _docker("inspect", _PGVECTOR_CONTAINER, "--format", "{{.State.Status}}", timeout=10, text=True, encoding='utf-8', errors='replace') + if result.returncode == 0 and "exited" in result.stdout: + print(f" Found stopped container '{_PGVECTOR_CONTAINER}', restarting...") + _docker("start", _PGVECTOR_CONTAINER, timeout=15) + if _pg_ready(host, port, 15): + print(" ✓ PostgreSQL container restarted") + return None + if input(" Start pgvector via Docker? [Y/n]: ").strip().lower() not in ("", "y", "yes"): + print(" Skipping Docker setup. Make sure PostgreSQL with pgvector is running.") + return None + password = secrets.token_urlsafe(24) + try: + print(f" Pulling {_PGVECTOR_IMAGE}...") + _docker("pull", _PGVECTOR_IMAGE, timeout=120) + print(f" Starting container '{_PGVECTOR_CONTAINER}' on port {port}...") + _docker("run", "-d", "--name", _PGVECTOR_CONTAINER, "-e", f"POSTGRES_PASSWORD={password}", "-p", f"127.0.0.1:{port}:5432", _PGVECTOR_IMAGE, timeout=30, check=True) + if _pg_ready(host, port, 20): + print(f" ✓ pgvector running on {host}:{port}") + else: + print(" Warning: Container started but PostgreSQL not yet accepting connections.\n It may need a few more seconds. Config will be saved; retry later.") + return {"host": host, "port": port, "user": "postgres", "password": password, "dbname": "postgres"} + except subprocess.CalledProcessError as e: + print(f" Failed to start Docker container: {_scrub(str(e), password)}") + except Exception as e: + print(f" Docker error: {_scrub(str(e), password)}") + return None + + +def _ensure_ollama(models: list[str]) -> bool: + """Ensure Ollama is running and ``models`` are pulled; False when the user must handle it manually.""" + ollama_bin = shutil.which("ollama") + if not (ok := _check_ollama(_OLLAMA_URL)[0]): + if not ollama_bin: + print(" Ollama not found. Install it:\n curl -fsSL https://ollama.com/install.sh | sh\n Or on macOS: brew install ollama") + return False + print(" Ollama installed but not running. Starting...") + try: + subprocess.Popen([ollama_bin, "serve"], stdin=subprocess.DEVNULL, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL) + _wait_for_port("localhost", 11434, timeout=10) + if ok := _check_ollama(_OLLAMA_URL)[0]: + print(" ✓ Ollama started") + except Exception as e: + print(f" Could not start Ollama: {e}") + if not ok: + print(" Warning: Ollama not reachable. Models cannot be pulled.") + return False + for model in models: + try: + names = [m.get("name", "") for m in json.loads(_http_get(_OLLAMA_URL, "/api/tags", 5).read()).get("models", [])] + except Exception: + names = [] + if any(model in n or model.split(":")[0] in n for n in names): + print(f" ✓ Model '{model}' available") + continue + print(f" Pulling '{model}'... (this may take a few minutes)") + try: + subprocess.run([ollama_bin or "ollama", "pull", model], timeout=600, stdin=subprocess.DEVNULL) + print(f" ✓ Model '{model}' pulled") + except Exception as e: + print(f" Warning: Could not pull '{model}': {e}\n Run manually: ollama pull {model}") + return True + + +def _ensure_pgvector_extension(pg_config: dict) -> None: + try: + import psycopg2 + except ImportError: + return + defaults = {"host": "localhost", "port": 5432, "user": "postgres", "dbname": "postgres"} + try: + conn = psycopg2.connect(**(defaults | {k: v for k, v in pg_config.items() if k in defaults or (k == "password" and v)})) + conn.autocommit = True + conn.cursor().execute("CREATE EXTENSION IF NOT EXISTS vector") + conn.close() + print(" ✓ pgvector extension enabled") + except Exception as e: + print(f" Warning: Could not enable pgvector extension: {e}") + + +def _wait_for_port(host: str, port: int, timeout: int = 15) -> None: + deadline = time.monotonic() + timeout + while time.monotonic() < deadline: + try: + socket.create_connection((host, port), timeout=1).close() + return + except OSError: + time.sleep(0.5) + + +# Picker descriptions: LLM/embedder show model (+ URL); vector stores by provider id (default: the id itself). +_VECTOR_DESCRIPTIONS = {"qdrant": lambda cfg: cfg.get("path", "local storage"), "pgvector": lambda cfg: f"{cfg.get('host', 'localhost')}:{cfg.get('port', 5432)}"} + + +def _configure_model_provider(kind: str, registry: dict, hermes_home: str, env_writes: dict[str, str], llm: tuple[str, dict] | None = None) -> tuple[str, dict, str, str | None]: + """Pick an LLM/embedder provider, collect its key, and (for Ollama) model + URL -> (id, definition, model, url). + For the embedder (``llm`` given), a provider shared with the LLM reuses the LLM key instead of prompting again.""" + items = [(v["label"], f"{v.get('default_model', '')} ({v['default_url']})" if v.get("default_url") else v.get("default_model", "")) for v in registry.values()] + pid = list(registry)[_curses_select(f"{kind} Provider", items, 0)] + pdef = registry[pid] + model, url = pdef["default_model"], pdef.get("default_url") + if pdef["needs_key"]: + if llm is None or pid != llm[0]: + if key := _prompt_api_key(pdef["label"] if llm is None else f"{pdef['label']} embedder", pdef["env_var"], hermes_home): + env_writes[pdef["env_var"]] = key + elif llm[1].get("env_var") in env_writes: + env_writes[pdef["env_var"]] = env_writes[llm[1]["env_var"]] + if pid == "ollama": + model = _input(f"{kind} model", pdef["default_model"]) + url = _input("Ollama URL", pdef["default_url"]) + return pid, pdef, model, url + + +def _setup_oss_interactive(hermes_home: str, config: dict) -> None: + env_writes: dict[str, str] = {} + llm_id, llm_def, llm_model, llm_url = _configure_model_provider("LLM", LLM_PROVIDERS, hermes_home, env_writes) + embedder_id, _, embedder_model, embedder_url = _configure_model_provider("Embedder", EMBEDDER_PROVIDERS, hermes_home, env_writes, llm=(llm_id, llm_def)) + vector_items = [(v["label"], _VECTOR_DESCRIPTIONS.get(pid, lambda cfg: pid)(vector_default_config(pid))) for pid, v in VECTOR_PROVIDERS.items()] + vector_id = list(VECTOR_PROVIDERS)[_curses_select("Vector Store", vector_items, 0)] + # Auto-setup: ensure Ollama is running and models are pulled; ensure pgvector is reachable (offer Docker if not). + ollama_models = [m for pid, m in ((llm_id, llm_model), (embedder_id, embedder_model)) if pid == "ollama"] + if ollama_models: + _ensure_ollama(ollama_models) + pgvector_config = _ensure_pgvector() if vector_id == "pgvector" else None + if vector_id == "pgvector" and not pgvector_config: # native PostgreSQL: prompt for connection details (user first, historical order) + pg = {k: _input(f"PostgreSQL {label}", d) for k, label, d in (("user", "user", os.getenv("USER", "postgres")), ("host", "host", "localhost"), ("port", "port", "5432"), ("dbname", "database", "postgres"))} + pg_password = getpass.getpass(" PostgreSQL password (blank if none): ").strip() + pgvector_config = {**pg, "port": int(pg["port"]), **({"password": pg_password} if pg_password else {})} + user_id = _input("User ID", os.getenv("USER", "hermes-user")) + agent_id = _input("Agent ID", "hermes") + flags = { + "oss_llm": llm_id, "oss_llm_model": llm_model, "oss_llm_url": llm_url or "", + "oss_llm_key": env_writes.get(llm_def["env_var"], "") if llm_def.get("env_var") else "", + "oss_embedder": embedder_id, "oss_embedder_model": embedder_model, "oss_embedder_url": embedder_url or "", + "oss_vector": vector_id, "user_id": user_id, + } + flags.update({f"oss_vector_{key}": str(val) for key, val in (pgvector_config or {}).items() if val}) + oss_config, _ = build_oss_config(flags) + _finish_oss(hermes_home, config, oss_config, env_writes, user_id, agent_id, pgvector_config) + + +def _install_provider_deps(llm_id: str, embedder_id: str, vector_id: str) -> None: + deps = {registry[pid]["pip_dep"] for (_, registry), pid in zip(SECTION_REGISTRIES, (llm_id, embedder_id, vector_id)) if registry.get(pid, {}).get("pip_dep")} + for dep in sorted(deps): + print(f" Installing {dep}...") + try: + # Environment-aware install: sealed hosted venvs redirect to the durable data-volume target instead of /opt/hermes. + from tools.lazy_deps import install_specs + outcome = install_specs([dep], timeout=60) + except Exception: + outcome = None + print(f" ✓ Installed {dep}" if outcome is not None and outcome.ok else f" Warning: cannot install {dep}: {outcome.reason}" if outcome is not None and outcome.blocked + else f" Warning: Could not install {dep}. Install manually: uv pip install {dep}") + if deps: + import importlib + importlib.invalidate_caches() + + +def _probe(fn, ok: str, fail: str, exc=Exception) -> tuple[bool, str]: + """Run ``fn``; (True, ok) on success, (False, "fail: ") on ``exc``.""" + try: + fn() + return True, ok + except exc as e: + return False, f"{fail}: {e}" + + +def _check_qdrant_path(path: str) -> tuple[bool, str]: + """Check that qdrant local storage parent dir is writable.""" + parent = Path(path).expanduser().parent + return _probe(lambda: parent.mkdir(parents=True, exist_ok=True), f"Directory writable: {parent}", f"Cannot write to {parent}", OSError) + + +def _check_ollama(url: str) -> tuple[bool, str]: + return _probe(lambda: _http_get(url, "/api/tags", 3), "Ollama reachable", f"Ollama not reachable at {url}") + + +def _check_pgvector(host: str, port: int) -> tuple[bool, str]: + return _probe(lambda: socket.create_connection((host, port), timeout=3).close(), f"PGVector reachable at {host}:{port}", f"PGVector not reachable at {host}:{port}") + + +def _warn_unless(check: tuple[bool, str]) -> None: + ok, msg = check + if not ok: + print(f" Warning: {msg}") + + +def _run_connectivity_checks(oss_config: dict) -> None: + vs = oss_config.get("vector_store", {}) + cfg = vs.get("config", {}) + if vs.get("provider") == "qdrant": + path, url = cfg.get("path"), cfg.get("url") + if path: + _warn_unless(_check_qdrant_path(path)) + elif url: + _warn_unless(_probe(lambda: _http_get(url, "/healthz", 3), "Qdrant reachable", f"Qdrant not reachable at {url}")) + elif vs.get("provider") == "pgvector": + _warn_unless(_check_pgvector(cfg.get("host", "localhost"), cfg.get("port", 5432))) + llm = oss_config.get("llm", {}) + if llm.get("provider") == "ollama": + _warn_unless(_check_ollama(llm.get("config", {}).get("ollama_base_url", _OLLAMA_URL))) + + +_MODE_HANDLERS = {"oss": _setup_oss, "selfhosted": _setup_selfhosted, "self-hosted": _setup_selfhosted, "platform": _setup_platform} +# Interactive picker order: Platform, Self-hosted server, Open Source. +_MODE_ITEMS = [("Platform", "Mem0 Cloud API (lightweight, just needs an API key)"), ("Self-hosted server", "Connect to an existing self-hosted Mem0 server (Docker/FastAPI)"), ("Open Source", "Run Mem0 locally (self-hosted LLM + vector store)")] +_MODE_PICKER = (_setup_platform, _setup_selfhosted, _setup_oss) + + +def post_setup(hermes_home: str, config: dict) -> None: + """Entry point for `hermes memory setup`: routes on --mode (platform / selfhosted / oss), else shows a picker. + OSS is non-interactive only when the mode came from the flag.""" + with suppress(ImportError): # mem0ai must meet the minimum version from plugin.yaml + import mem0 + installed_ver = getattr(mem0, "__version__", None) + if installed_ver and _version_tuple(installed_ver) < (2, 0, 10): + print(f"\n ⚠ mem0ai {installed_ver} installed but >=2.0.10 required.\n Run: uv pip install --python {sys.executable} 'mem0ai>=2.0.10'") + flags = parse_flags(sys.argv[1:]) + handler = _MODE_HANDLERS.get(flags["mode"]) + flags["_mode_from_flag"] = handler is not None + if handler is None: + handler = _MODE_PICKER[_curses_select(" Select mode", _MODE_ITEMS, 0)] + handler(hermes_home, config, flags) + + +# ---- BEGIN PLUGIN-COMPAT (revert-scheduled; see COMPAT_MANIFEST.md) ---- +# Names external plugins imported from this module before the Sep 2026 decomposition. +# Internal code MUST NOT use these (scripts/check_compat_pointers.py fails CI if it does). +# The whole block is removed by reverting the commit that added it. + +def has_oss_flags() -> bool: + """Check if OSS-related flags are present in sys.argv.""" + flags = parse_flags(sys.argv[1:]) + if flags["mode"] == "oss": + return True + if any(flags.get(k) for k in ("oss_llm_key", "oss_vector_path", "oss_vector_url")): + return True + return False +# ---- END PLUGIN-COMPAT ---- diff --git a/integrations/hermes-plugin-mem0/plugin.yaml b/integrations/hermes-plugin-mem0/plugin.yaml new file mode 100644 index 000000000..c6ae10acc --- /dev/null +++ b/integrations/hermes-plugin-mem0/plugin.yaml @@ -0,0 +1,5 @@ +name: mem0 +version: 1.3.0 +description: "Mem0 — server-side LLM fact extraction with semantic search, automatic deduplication, and opt-in reranking (platform mode)." +pip_dependencies: + - mem0ai>=2.0.10,<3 diff --git a/integrations/hermes-plugin-mem0/pyproject.toml b/integrations/hermes-plugin-mem0/pyproject.toml new file mode 100644 index 000000000..962237b28 --- /dev/null +++ b/integrations/hermes-plugin-mem0/pyproject.toml @@ -0,0 +1,17 @@ +[project] +name = "hermes-plugin-mem0" +version = "1.3.0" +description = "Hermes Agent memory provider plugin: mem0" +requires-python = ">=3.11" +license = { text = "Apache-2.0 AND MIT" } +# Installed into the Hermes venv by `hermes plugins install` / `enable` and re-applied after +# every `hermes update` (hermes-agent#113851). Keep upper bounds: Hermes pins its own deps exactly +# and refuses a plugin whose requirements cannot resolve against them. +dependencies = [ + "mem0ai>=2.0.10,<3", + "httpx>=0.27,<1", +] + +[project.optional-dependencies] +postgres = ['psycopg2-binary>=2.9,<3'] +qdrant = ['qdrant-client>=1.9,<2'] diff --git a/integrations/hermes-plugin-mem0/tests/smoke_hermes.py b/integrations/hermes-plugin-mem0/tests/smoke_hermes.py new file mode 100644 index 000000000..14fdcc0ac --- /dev/null +++ b/integrations/hermes-plugin-mem0/tests/smoke_hermes.py @@ -0,0 +1,178 @@ +"""Real Hermes + Mem0 SDK + local Qdrant; only the model API is simulated. + +HERMES_SOURCE=/path/to/hermes-agent python tests/smoke_hermes.py +Requires the Hermes dependencies, mem0ai, and qdrant-client in the active environment. +All configuration, credentials, and database files are temporary. +""" + +import importlib +import io +import json +import os +import shutil +import sys +import tempfile +import threading +from contextlib import redirect_stdout +from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer +from pathlib import Path +from unittest.mock import patch + + +class ModelAPI(BaseHTTPRequestHandler): + calls = [] + + def log_message(self, *args): + pass + + def do_POST(self): + if self.headers.get("Authorization") != "Bearer local-test": + self.send_error(401) + return + body = json.loads(self.rfile.read(int(self.headers["Content-Length"]))) + self.calls.append(self.path) + if self.path == "/v1/embeddings": + result = { + "object": "list", + "data": [{"object": "embedding", "index": i, "embedding": [1.0, 0.0, 0.0]} + for i, _ in enumerate(body["input"])], + "model": "test-embedding", + "usage": {"prompt_tokens": 1, "total_tokens": 1}, + } + elif self.path == "/v1/chat/completions": + result = { + "id": "test-completion", "object": "chat.completion", "created": 0, "model": "gpt-4.1-mini", + "choices": [{"index": 0, "finish_reason": "stop", "message": {"role": "assistant", "content": + json.dumps({"facts": ["Prefers green tea."], "memory": [ + {"id": "0", "text": "Prefers green tea.", "event": "ADD"}]})}}], + } + else: + self.send_error(404) + return + encoded = json.dumps(result).encode() + self.send_response(200) + self.send_header("Content-Type", "application/json") + self.send_header("Content-Length", str(len(encoded))) + self.end_headers() + self.wfile.write(encoded) + + +def main(): + hermes_source = Path(os.environ["HERMES_SOURCE"]).resolve() + sys.path.insert(0, str(hermes_source)) + with tempfile.TemporaryDirectory() as temporary: + home = Path(temporary) + os.environ.update(HERMES_HOME=temporary, MEM0_DIR=str(home / "mem0-data"), MEM0_TELEMETRY="false") + (home / "mem0-data").mkdir() + server = ThreadingHTTPServer(("127.0.0.1", 0), ModelAPI) + worker = threading.Thread(target=server.serve_forever, daemon=True) + worker.start() + try: + url = f"http://127.0.0.1:{server.server_port}/v1" + config = { + "mode": "oss", "user_id": "existing-user", "agent_id": "hermes", + "oss": { + "llm": {"provider": "openai", "config": { + "model": "gpt-4.1-mini", "api_key": "local-test", "openai_base_url": url}}, + "embedder": {"provider": "openai", "config": { + "model": "test-embedding", "embedding_dims": 3, + "api_key": "local-test", "openai_base_url": url}}, + "vector_store": {"provider": "qdrant", "config": {"path": str(home / "qdrant")}}, + }, + } + (home / "mem0.json").write_text(json.dumps(config)) + destination = home / "plugins" / "mem0" + shutil.copytree(Path(__file__).resolve().parents[1], destination) + import plugins.memory as memory_plugins + from agent.memory_manager import MemoryManager + + # Simulate bundled-provider removal only inside this test process. + memory_plugins._MEMORY_PLUGINS_DIR = home / "empty-bundled" + memory_plugins._MEMORY_PLUGINS_DIR.mkdir() + assert memory_plugins.find_provider_dir("mem0") == destination + provider = memory_plugins.load_memory_provider("mem0", register_skills=False) + assert provider is not None and provider.__class__.__module__.startswith("_hermes_user_memory.") + setup = importlib.import_module(f"{provider.__class__.__module__}._setup") + from hermes_cli.memory_setup import cmd_setup_provider, cmd_status + + output = io.StringIO() + arguments = ["hermes", "memory", "setup", "mem0", "--mode", "platform", "--api-key", "local-test"] + with patch.object(sys, "argv", arguments), patch.object(sys, "stdin", io.StringIO("\n\n")): + with patch.object(setup, "_curses_select", return_value=0), redirect_stdout(output): + cmd_setup_provider("mem0") + assert json.loads((home / "mem0.json").read_text())["user_id"] == "existing-user" + provider.save_config(config, home) + assert (home / "mem0.json").stat().st_mode & 0o777 == 0o600 + with redirect_stdout(output): + cmd_status(None) + assert "installed ✓" in output.getvalue() and "available ✓" in output.getvalue() + assert (home / ".env").stat().st_mode & 0o777 == 0o600 + manager = MemoryManager() + manager.add_provider(provider) + manager.initialize_all("smoke-session", platform="cli", user_id="gateway-user") + assert provider._backend is not None, getattr(provider, "_init_error", "initialization failed") + + def tool(name, **arguments): + result = json.loads(manager.handle_tool_call(name, arguments)) + assert "error" not in result, result + return result + + try: + assert tool("mem0_add", content="Prefers Python.")["result"] == "Fact stored." + memories = tool("mem0_search", query="language")["results"] + assert len(memories) == 1 and memories[0]["memory"] == "Prefers Python." + memory_id = memories[0]["id"] + tool("mem0_update", memory_id=memory_id, text="Prefers Rust.") + assert "Prefers Rust." in provider.prefetch("language preference") + assert tool("mem0_search", query="language")["results"][0]["memory"] == "Prefers Rust." + tool("mem0_delete", memory_id=memory_id) + assert tool("mem0_search", query="language")["result"] == "No relevant memories found." + manager.sync_all("I prefer green tea.", "Noted.", session_id="smoke-session") + assert provider._user_id == "existing-user" + finally: + manager.shutdown_all() + assert provider._backend is None + # A changed embedder must fail without destroying the existing collection. + config["oss"]["embedder"]["config"]["embedding_dims"] = 4 + provider.save_config(config, home) + mismatched = type(provider)() + mismatched.initialize("mismatched-session") + assert mismatched._backend is None and "Existing memories were preserved" in mismatched._init_error + config["oss"]["embedder"]["config"]["embedding_dims"] = 3 + # Resolve embedder credentials from the active profile, not another profile's process env. + del config["oss"]["embedder"]["config"]["api_key"] + del config["oss"]["embedder"]["config"]["openai_base_url"] + provider.save_config(config, home) + from agent.secret_scope import ( + reset_secret_scope, + set_multiplex_active, + set_secret_scope, + ) + + resumed = type(provider)() + with patch.dict(os.environ, {"OPENAI_API_KEY": "wrong-profile", "OPENAI_API_BASE": "http://127.0.0.1:1/v1"}): + set_multiplex_active(True) + token = set_secret_scope({"OPENAI_API_KEY": "local-test", "OPENAI_BASE_URL": url}) + try: + resumed.initialize("resumed-session", user_id="different-gateway-user") + finally: + reset_secret_scope(token) + set_multiplex_active(False) + try: + assert resumed._backend is not None + found = json.loads(resumed.handle_tool_call("mem0_search", {"query": "drink"})) + assert "results" in found, found + assert found["results"][0]["memory"] == "Prefers green tea." + finally: + resumed.shutdown() + assert "/v1/chat/completions" in ModelAPI.calls + print("PASS: external Hermes loader, CLI setup/status, real Mem0/Qdrant CRUD, recall, background extraction,") + print(" existing identity, profile credentials, private files, shutdown, dimension safety and persistence across restart. Model responses simulated locally.") + finally: + server.shutdown() + server.server_close() + worker.join(timeout=5) + + +if __name__ == "__main__": + main() diff --git a/integrations/hermes-plugin-mem0/tests/test_plugin.py b/integrations/hermes-plugin-mem0/tests/test_plugin.py new file mode 100644 index 000000000..6993948b7 --- /dev/null +++ b/integrations/hermes-plugin-mem0/tests/test_plugin.py @@ -0,0 +1,286 @@ +"""Offline regressions for the standalone Hermes plugin.""" + +import contextvars +import importlib +import importlib.util +import json +import sys +import threading +import types +from pathlib import Path +from unittest.mock import Mock + +import pytest + +ROOT = Path(__file__).resolve().parents[1] + + +@pytest.fixture +def plugin(monkeypatch, tmp_path): + def spawn(target, *, name): + return threading.Thread(target=contextvars.copy_context().run, args=(target,), name=name) + + def atomic_write_text(path, value, *, mode): + path.write_text(value) + path.chmod(mode) + + modules = { + "agent.memory_provider": {"MemoryProvider": object, "spawn_context_thread": spawn}, + "agent.secret_scope": {"get_secret": lambda key, default="": default}, + "tools.registry": {"tool_error": lambda message: json.dumps({"error": message})}, + "utils": { + "read_json_or_empty": lambda path: json.loads(path.read_text()) if path.exists() else {}, + "atomic_json_write": lambda path, value, **kwargs: atomic_write_text(path, json.dumps(value), **kwargs), + "atomic_write_text": atomic_write_text, + }, + "hermes_constants": {"get_hermes_home": lambda: tmp_path}, + } + for name, values in modules.items(): + module = types.ModuleType(name) + module.__dict__.update(values) + monkeypatch.setitem(sys.modules, name, module) + spec = importlib.util.spec_from_file_location("standalone_mem0", ROOT / "__init__.py") + module = importlib.util.module_from_spec(spec) + monkeypatch.setitem(sys.modules, spec.name, module) + spec.loader.exec_module(module) + monkeypatch.setattr(module.atexit, "register", lambda *args: None) + yield module + for name in list(sys.modules): + if name.startswith("standalone_mem0."): + monkeypatch.delitem(sys.modules, name) + + +def test_dimension_mismatch_preserves_qdrant_collection(plugin, monkeypatch): + backend = importlib.import_module(f"{plugin.__name__}._backend") + client = Mock() + client.collection_exists.return_value = True + client.get_collection.return_value.config.params.vectors = types.SimpleNamespace(size=1536) + monkeypatch.setitem(sys.modules, "qdrant_client", types.SimpleNamespace(QdrantClient=Mock(return_value=client))) + with pytest.raises(ValueError, match="1536.*768"): + backend.OSSBackend._reject_dimension_mismatch("qdrant", {"path": "/unused"}, 768) + client.delete_collection.assert_not_called() + client.close.assert_called_once() + + +def test_dimension_mismatch_preserves_pgvector_table(plugin, monkeypatch): + backend = importlib.import_module(f"{plugin.__name__}._backend") + cursor, connection = Mock(), Mock() + cursor.fetchone.return_value = (1536,) + connection.cursor.return_value = cursor + driver = types.SimpleNamespace(connect=Mock(return_value=connection), sql=Mock()) + monkeypatch.setitem(sys.modules, "psycopg2", driver) + with pytest.raises(ValueError, match="1536.*768"): + backend.OSSBackend._reject_dimension_mismatch("pgvector", {"user": "test"}, 768) + assert cursor.execute.call_count == 1 + assert cursor.execute.call_args.args[0].startswith("SELECT") + connection.close.assert_called_once() + + +def test_setup_keeps_credentials_private_and_preserves_existing_values(plugin, tmp_path): + setup = importlib.import_module(f"{plugin.__name__}._setup") + path = tmp_path / ".env" + path.write_text("EXISTING=value\nMEM0_API_KEY=old\n") + path.chmod(0o644) + setup._write_env(path, {"MEM0_API_KEY": "new"}) + assert path.read_text() == "EXISTING=value\nMEM0_API_KEY=new\n" + assert path.stat().st_mode & 0o777 == 0o600 + + +def test_oss_setup_keeps_database_password_private(plugin, tmp_path, monkeypatch): + setup = importlib.import_module(f"{plugin.__name__}._setup") + for name in ("_install_provider_deps", "_activate_provider", "_run_connectivity_checks"): + monkeypatch.setattr(setup, name, Mock()) + config = {"llm": {"provider": "openai", "config": {}}, "embedder": {"provider": "openai", "config": {}}, + "vector_store": {"provider": "pgvector", "config": {"password": "test-password"}}} + setup._finish_oss(str(tmp_path), {}, config, {}, "existing-user", "hermes") + path = tmp_path / "mem0.json" + assert json.loads(path.read_text())["user_id"] == "existing-user" + assert path.stat().st_mode & 0o777 == 0o600 + + +def test_optional_server_key_and_prefetch_rerank(plugin, monkeypatch): + monkeypatch.setattr(plugin, "_load_config", lambda: {"host": "http://localhost:8888", "rerank": True}) + provider = plugin.Mem0MemoryProvider() + assert not next(field for field in provider.get_config_schema() if field["key"] == "api_key")["required"] + backend = Mock() + backend.search.return_value = [{"memory": "Prefers Python"}] + monkeypatch.setattr(provider, "_create_backend", lambda: backend) + provider.initialize("test-session") + try: + assert "Prefers Python" in provider.prefetch("language") + assert backend.search.call_args.kwargs["rerank"] is True + finally: + provider.shutdown() + + +def test_invalid_tool_arguments_never_reach_backend(plugin, monkeypatch): + provider = plugin.Mem0MemoryProvider() + provider._backend = Mock() + for args in (None, {"query": []}, {"query": " "}, {"query": "fact", "top_k": "invalid"}): + assert "error" in json.loads(provider.handle_tool_call("mem0_search", args)) + provider._backend.search.assert_not_called() + assert provider._consecutive_failures == 0 + + +def test_selfhosted_http_auth_and_tool_routes(plugin): + import httpx + + backend = importlib.import_module(f"{plugin.__name__}._backend") + requests = [] + + def respond(request): + requests.append(request) + return httpx.Response(200, json={"results": [{"id": "existing", "memory": "Prefers Python"}]}) + + client = backend.SelfHostedBackend("test-key", "http://localhost:8888", transport=httpx.MockTransport(respond)) + try: + client.add([], user_id="existing-user", agent_id="hermes", infer=True) + assert requests[-1].headers["X-API-Key"] == "test-key" + assert json.loads(requests[-1].content)["user_id"] == "existing-user" + assert client.search("language", filters={"user_id": "existing-user"})[0]["id"] == "existing" + assert json.loads(requests[-1].content)["filters"] == {"user_id": "existing-user"} + client.update("existing", "Prefers Rust") + assert json.loads(requests[-1].content) == {"text": "Prefers Rust"} + client.delete("existing") + assert [(r.method, r.url.path) for r in requests] == [ + ("POST", "/memories"), ("POST", "/search"), ("PUT", "/memories/existing"), ("DELETE", "/memories/existing") + ] + finally: + client.close() + + +@pytest.mark.parametrize("mode", ["platform", "selfhosted"]) +def test_setup_rotates_legacy_file_key(plugin, monkeypatch, tmp_path, mode): + setup = importlib.import_module(f"{plugin.__name__}._setup") + (tmp_path / "mem0.json").write_text(json.dumps({"api_key": "old-key", "user_id": "existing-user"})) + monkeypatch.setattr(setup, "_activate_provider", Mock()) + monkeypatch.setattr(setup, "_check_selfhosted_server", Mock()) + monkeypatch.setattr(setup, "_prompt", lambda label, default=None, **kwargs: default or "") + monkeypatch.setattr(setup, "_curses_select", lambda *args, **kwargs: 0) + setup._MODE_HANDLERS[mode](str(tmp_path), {}, {"api_key": "new-key", "host": "http://localhost:8888"}) + monkeypatch.setattr(plugin, "get_secret", lambda key, default="": "new-key" if key == "MEM0_API_KEY" else default) + assert plugin._load_config()["api_key"] == "new-key" + assert "old-key" not in (tmp_path / "mem0.json").read_text() + assert "MEM0_API_KEY=new-key" in (tmp_path / ".env").read_text() + + +def test_platform_setup_honors_user_id_flag(plugin, monkeypatch, tmp_path): + setup = importlib.import_module(f"{plugin.__name__}._setup") + monkeypatch.setattr(setup, "_activate_provider", Mock()) + monkeypatch.setattr(setup, "_prompt", lambda label, default=None, **kwargs: default or "") + monkeypatch.setattr(setup, "_curses_select", lambda *args, **kwargs: 0) + setup._setup_platform(str(tmp_path), {}, {"api_key": "new-key", "user_id": "chosen-user"}) + assert plugin._load_config()["user_id"] == "chosen-user" + + +@pytest.mark.parametrize("scoped_key", ["profile-key", ""]) +def test_oss_embedder_never_uses_another_profiles_credentials(plugin, monkeypatch, scoped_key): + backend = importlib.import_module(f"{plugin.__name__}._backend") + memory = Mock() + monkeypatch.setitem(sys.modules, "mem0", types.SimpleNamespace(Memory=memory)) + qdrant_config = types.SimpleNamespace(model_fields={"path": types.SimpleNamespace(default=None)}) + monkeypatch.setitem( + sys.modules, "mem0.configs.vector_stores.qdrant", types.SimpleNamespace(QdrantConfig=qdrant_config) + ) + monkeypatch.setenv("OPENAI_API_KEY", "other-profile-key") + monkeypatch.setenv("OPENAI_API_BASE", "https://other-profile.invalid/v1") + secrets = {"OPENAI_API_KEY": scoped_key, "OPENAI_BASE_URL": "https://profile.invalid/v1"} + monkeypatch.setattr(sys.modules["agent.secret_scope"], "get_secret", lambda key, default="": secrets.get(key, default)) + config = { + "llm": {"provider": "ollama", "config": {}}, + "embedder": {"provider": "openai", "config": {}}, + "vector_store": {"provider": "qdrant", "config": {}}, + } + if not scoped_key: + with pytest.raises(ValueError, match="OpenAI API key"): + backend.OSSBackend(config) + memory.from_config.assert_not_called() + else: + backend.OSSBackend(config) + resolved = memory.from_config.call_args.args[0]["embedder"]["config"] + assert resolved["api_key"] == scoped_key + assert resolved["openai_base_url"] == "https://profile.invalid/v1" + assert config["embedder"]["config"] == {} + + +def test_pgvector_setup_never_removes_existing_container(plugin, monkeypatch): + setup = importlib.import_module(f"{plugin.__name__}._setup") + monkeypatch.setattr(setup, "_check_pgvector", lambda *args: (False, "unreachable")) + monkeypatch.setattr(setup.shutil, "which", lambda name: "/test/docker") + monkeypatch.setattr("builtins.input", lambda prompt: "y") + calls = [] + + def docker(*args, **kwargs): + calls.append(args) + if args[0] == "run": + raise setup.subprocess.CalledProcessError(1, "docker run: container name already exists") + return types.SimpleNamespace(returncode=0, stdout="paused") + + monkeypatch.setattr(setup, "_docker", docker) + assert setup._ensure_pgvector() is None + assert not any(args[0] == "rm" for args in calls) + + +def test_platform_dry_run_does_not_print_stored_secrets(plugin, monkeypatch, tmp_path, capsys): + setup = importlib.import_module(f"{plugin.__name__}._setup") + config = {"api_key": "old-secret", "oss": {"vector_store": {"config": {"password": "db-secret"}}}} + path = tmp_path / "mem0.json" + path.write_text(json.dumps(config)) + monkeypatch.setattr(setup, "_prompt", lambda label, default=None, **kwargs: default or "") + monkeypatch.setattr(setup, "_curses_select", lambda *args, **kwargs: 0) + setup._setup_platform(str(tmp_path), {}, {"api_key": "new-secret", "dry_run": True}) + output = capsys.readouterr().out + assert all(secret not in output for secret in ("old-secret", "db-secret", "new-secret")) + assert json.loads(path.read_text()) == config + assert not (tmp_path / ".env").exists() + + +def test_oss_setup_preserves_distinct_llm_and_embedder_keys(plugin): + setup = importlib.import_module(f"{plugin.__name__}._setup") + config, env = setup.build_oss_config({"oss_llm_key": "llm-key", "oss_embedder_key": "embedder-key"}) + assert config["llm"]["config"].get("api_key", env.get("OPENAI_API_KEY")) == "llm-key" + assert config["embedder"]["config"].get("api_key", env.get("OPENAI_API_KEY")) == "embedder-key" + + +def test_direct_openai_llm_uses_scoped_credentials(plugin, monkeypatch): + llm_mod = importlib.import_module(f"{plugin.__name__}._openai_llm") + openai_mock = types.SimpleNamespace(OpenAI=Mock(return_value=Mock())) + monkeypatch.setitem(sys.modules, "openai", openai_mock) + monkeypatch.setenv("OPENROUTER_API_KEY", "should-be-ignored") + monkeypatch.setenv("OPENAI_API_KEY", "env-key-should-be-ignored") + secrets = {"OPENAI_API_KEY": "scoped-key", "OPENAI_API_BASE": "", "OPENAI_BASE_URL": ""} + monkeypatch.setattr(sys.modules["agent.secret_scope"], "get_secret", lambda key, default="": secrets.get(key, default)) + llm_mod.DirectOpenAILLM({"api_key": "", "model": "gpt-5-mini"}) + call_kwargs = openai_mock.OpenAI.call_args.kwargs + assert call_kwargs["api_key"] == "scoped-key" + assert "openrouter" not in call_kwargs.get("base_url", "").lower() + + +def test_direct_openai_llm_rejects_missing_key(plugin, monkeypatch): + llm_mod = importlib.import_module(f"{plugin.__name__}._openai_llm") + monkeypatch.setattr(sys.modules["agent.secret_scope"], "get_secret", lambda key, default="": "") + with pytest.raises(ValueError, match="API key"): + llm_mod.DirectOpenAILLM({"api_key": "", "model": "gpt-5-mini"}) + + +def test_selfhosted_keyless_omits_auth_header(plugin): + import httpx + + backend = importlib.import_module(f"{plugin.__name__}._backend") + requests = [] + + def respond(request): + requests.append(request) + return httpx.Response(200, json={"results": []}) + + client = backend.SelfHostedBackend("", "http://localhost:8888", transport=httpx.MockTransport(respond)) + client.search("test", filters={"user_id": "u"}) + assert "X-API-Key" not in requests[0].headers + client.close() + + +def test_initialize_tolerates_non_numeric_sync_max_chars(plugin, monkeypatch): + monkeypatch.setattr(plugin, "_load_config", lambda: {"sync_max_chars": "not-a-number"}) + provider = plugin.Mem0MemoryProvider() + provider.initialize("test-session") + assert provider._sync_max_chars == plugin._SYNC_MSG_MAX_CHARS diff --git a/server/requirements.txt b/server/requirements.txt index 33a11c55c..e42309ebd 100644 --- a/server/requirements.txt +++ b/server/requirements.txt @@ -3,7 +3,7 @@ uvicorn==0.34.0 pydantic[email]==2.10.4 mem0ai>=0.1.48 python-dotenv==1.2.2 -psycopg>=3.2.8 +psycopg[binary]>=3.2.8,<4.0.0 psycopg-pool>=3.2.6,<4.0.0 # Bundled LLM/embedder providers. Extend by adding the provider's package From f4acc89a298ac7573fcd50faf46a4bfa7aeedb15 Mon Sep 17 00:00:00 2001 From: Kartik Date: Thu, 24 Sep 2026 18:00:54 +0530 Subject: [PATCH 28/55] docs: remove memory types page and preserve redirects (#7437) --- docs/core-concepts/how-it-works.mdx | 4 +- docs/core-concepts/memory-types.mdx | 118 ------------------ docs/docs.json | 7 +- docs/integrations/camel-ai.mdx | 6 +- docs/llms.txt | 1 - docs/platform/overview.mdx | 4 +- docs/platform/platform-vs-oss.mdx | 2 +- docs/templates/feature_guide_template.mdx | 2 +- .../parameters_reference_template.mdx | 6 +- docs/vibecoding.mdx | 4 +- mem0-ts/src/client/mem0.types.ts | 2 + mem0/memory/main.py | 4 + 12 files changed, 24 insertions(+), 136 deletions(-) delete mode 100644 docs/core-concepts/memory-types.mdx diff --git a/docs/core-concepts/how-it-works.mdx b/docs/core-concepts/how-it-works.mdx index 5998b4f3c..1be360c79 100644 --- a/docs/core-concepts/how-it-works.mdx +++ b/docs/core-concepts/how-it-works.mdx @@ -89,8 +89,8 @@ On Mem0 Platform, these stores are managed for you. In OSS, you choose and opera ## Next steps - - Choose the right scope for user, agent, run, and session memory. + + Organize Platform memories by user, agent, app, and run. Add, search, update, and delete memories from your app. diff --git a/docs/core-concepts/memory-types.mdx b/docs/core-concepts/memory-types.mdx deleted file mode 100644 index a2a18e077..000000000 --- a/docs/core-concepts/memory-types.mdx +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: Memory Types -description: "What memory_type actually does in Mem0: procedural memory is implemented, semantic and episodic are not." -icon: "tag" -iconType: "solid" ---- - -# Memory Types - -Mem0's Python SDK exposes a `memory_type` parameter on `add()`. The underlying `MemoryType` enum defines three values, but only one of them is wired up. This page states plainly which is which so you don't build against a type that doesn't exist yet. - -## Status - -| Type | Enum value | Status | Notes | -| --- | --- | --- | --- | -| Procedural memory | `procedural_memory` | **Implemented** | Python OSS only (`Memory`/`AsyncMemory`). Pass `memory_type="procedural_memory"` and `agent_id` to `add()`. Not available on the Platform `MemoryClient`, and not available in the TypeScript SDK (OSS or Platform). | -| Semantic memory | `semantic_memory` | **Not implemented** | Defined in the `MemoryType` enum but never read anywhere else in the codebase. Passing it to `add()` raises a validation error. There is no evidence in this repo of a roadmap date for this. | -| Episodic memory | `episodic_memory` | **Not implemented** | Same as above: defined, never wired into the extraction pipeline, rejected by validation, no documented roadmap. | - - - Only `procedural_memory` is a real, working value. Calling `memory.add(messages, memory_type="semantic_memory")` (or `episodic_memory`) is rejected and tells you to pass `procedural_memory` instead. Sync `Memory.add()` raises `Mem0ValidationError`; `AsyncMemory.add()` raises a plain `ValueError`. - - -## Procedural memory - -Procedural memory stores step-by-step task knowledge (how an agent performs a workflow) rather than facts about a user. It requires `agent_id`: - -```python -from mem0 import Memory - -memory = Memory() - -memory.add( - [ - {"role": "user", "content": "Book a flight from SFO to NYC"}, - {"role": "assistant", "content": "1. Search flights. 2. Filter by price. 3. Confirm booking."}, - ], - agent_id="travel-agent", - memory_type="procedural_memory", -) -``` - -Omit `memory_type` entirely and Mem0 stores the messages as an ordinary memory: there is no semantic/episodic pathway for it to fall into. Any other explicit value is rejected by validation rather than quietly falling back to an ordinary memory. - -## How every other memory is scoped - -Outside of the `procedural_memory` special case, Mem0 does not sort memories into named types. Every memory is scoped by the identifiers you pass in, and the same identifiers are used to retrieve it later: - -- **`user_id`**: ties a memory to a specific person or account. -- **`agent_id`**: ties a memory to a specific agent or assistant persona. -- **`run_id`**: ties a memory to a specific session, task, or conversation thread. -- **`app_id`** (Platform only): ties a memory to a specific application or tenant, in addition to the three above. See Entity-Scoped Memory. - -At least one identifier is required on `add()`. Passing more than one narrows the scope further (for example, `user_id` + `run_id` together). - -```python -from mem0 import Memory - -memory = Memory() - -memory.add( - "I'm Alex and I prefer boutique hotels.", - user_id="alex", - run_id="trip-planning-2025", -) - -results = memory.search( - "Any hotel preferences?", - filters={"user_id": "alex", "run_id": "trip-planning-2025"}, -) -``` - - - Use `run_id` when you want a set of memories to stay tied to one session or task; use `user_id` alone for anything that should persist across every session for that person. - - -## How memories are extracted and updated - -When `infer=True` (the default) on `add()`, Mem0 runs a single pipeline rather than routing through separate type-specific paths: - -1. **Context gathering**: pulls the most recent messages already stored for the same `user_id`/`agent_id`/`run_id` scope. -2. **Existing memory retrieval**: embeds the new messages and runs a vector search against memories already in that same scope, to find candidates that might need to change. -3. **Extraction**: a single LLM call compares the new messages against the retrieved candidates and decides, per fact, whether to `ADD`, `UPDATE`, `DELETE`, or leave a memory alone. - -Alongside this, both OSS and Platform extract named entities (people, places, organizations) from memory text and use shared entities between memories to boost related results at search time. On Platform, that entity graph is also queryable directly; see Graph Memory. In OSS, entities only affect ranking, there is no separate graph to query. - - - Avoid storing secrets or unredacted PII in memories: they are retrievable by design. Encrypt or hash sensitive values before calling `add()`. - - -## Put it into practice - - - - - - - diff --git a/docs/docs.json b/docs/docs.json index 969ebad35..4371c1ffe 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -54,7 +54,6 @@ "icon": "brain", "pages": [ "core-concepts/how-it-works", - "core-concepts/memory-types", "core-concepts/memory-operations/add", "core-concepts/memory-operations/search", "core-concepts/memory-operations/update", @@ -1033,7 +1032,11 @@ }, { "source": "/concepts/memory-scoring", - "destination": "/core-concepts/memory-types" + "destination": "/core-concepts/how-it-works" + }, + { + "source": "/core-concepts/memory-types", + "destination": "/core-concepts/how-it-works" }, { "source": "/cookbooks/research-copilot", diff --git a/docs/integrations/camel-ai.mdx b/docs/integrations/camel-ai.mdx index 1eb715b20..342291819 100644 --- a/docs/integrations/camel-ai.mdx +++ b/docs/integrations/camel-ai.mdx @@ -130,10 +130,10 @@ print(response.msgs[0].content) Get an API key and save your first memory. - - How user, agent, app, and run memory differ. + + Organize memories by user, agent, app, and run. The core memory operations, end to end. diff --git a/docs/platform/platform-vs-oss.mdx b/docs/platform/platform-vs-oss.mdx index 92bcc27b4..8a79ab351 100644 --- a/docs/platform/platform-vs-oss.mdx +++ b/docs/platform/platform-vs-oss.mdx @@ -39,7 +39,7 @@ The core memory loop is identical on both: `add`, `search`, `get`, `get_all`, `u - **Entity scoping** by `user_id`, `agent_id`, and `run_id` - **Filter grouping**: both accept `AND`/`OR`/`NOT` wrappers, both implicitly AND a flat multi-key filter like `{"user_id": "alice", "agent_id": "a1"}`, and both accept `*` as a wildcard value. Which fields you may filter on, and which operators each field accepts, differ (see below) - **Entity-aware ranking**: both extract entities from memory text and use shared entities to boost related results at search time -- **Multimodal input**, **memory expiration** (`expiration_date`), **reranking**, **procedural memory** (Python), and **custom extraction instructions** (`custom_instructions`) +- **Multimodal input**, **memory expiration** (`expiration_date`), **reranking**, and **custom extraction instructions** (`custom_instructions`) - Python and JavaScript SDKs, plus a REST API (self-hosted via `server/`, or hosted) ## What's actually different diff --git a/docs/templates/feature_guide_template.mdx b/docs/templates/feature_guide_template.mdx index fc502f88b..7582f3a47 100644 --- a/docs/templates/feature_guide_template.mdx +++ b/docs/templates/feature_guide_template.mdx @@ -124,7 +124,7 @@ Walk through a real request/response. Include sample payloads and highlight nota {/* DEBUG: verify CTA targets */} - + Understand how Mem0 ranks memories under the hood. diff --git a/docs/templates/parameters_reference_template.mdx b/docs/templates/parameters_reference_template.mdx index f86cb7745..b31d1b442 100644 --- a/docs/templates/parameters_reference_template.mdx +++ b/docs/templates/parameters_reference_template.mdx @@ -38,7 +38,6 @@ client.memories.add( user_id: str, memory: str, metadata: Optional[dict] = None, - memory_type: Literal["session", "long_term"] = "session", ) ``` @@ -47,13 +46,13 @@ await mem0.memories.add({ userId: string; memory: string; metadata?: Record; - memoryType?: "session" | "long_term"; }); ``` - Defaults to session memories. Override `memory_type` for long-term storage. + [Describe defaults supported by this operation and SDK. Do not infer a + memory type or retention policy from a scoping identifier.] @@ -67,7 +66,6 @@ await mem0.memories.add({ | `user_id` | string | Yes | Unique identifier for the end user. | Must match follow-up operations. | | `memory` | string | Yes | Content to persist. | Managed & OSS. Markdown allowed. | | `metadata` | object | No | Key-value pairs for filters. | OSS stores as JSONB; limit to 2KB. | -| `memory_type` | string | No | Retention bucket | Platform supports `shared`. | Set `ttl_seconds` when you need memories to expire automatically (OSS only). diff --git a/docs/vibecoding.mdx b/docs/vibecoding.mdx index 50eb08e04..a5bf80016 100644 --- a/docs/vibecoding.mdx +++ b/docs/vibecoding.mdx @@ -96,8 +96,8 @@ time. Storage: vector embeddings. **Architecture Overview:** - Memory is scoped by user_id, agent_id, or run_id - Core operations: add, search, update, delete -- Memory types: factual (preferences, facts), episodic (past interactions), - semantic (concept relationships), working (session state) +- Store preferences, facts, and past interactions; use run_id to scope a + session. Platform does not expose a memory_type selector. - Integration pattern: retrieve relevant memories → generate response → store new memories diff --git a/mem0-ts/src/client/mem0.types.ts b/mem0-ts/src/client/mem0.types.ts index 606cf0daf..a178f4529 100644 --- a/mem0-ts/src/client/mem0.types.ts +++ b/mem0-ts/src/client/mem0.types.ts @@ -125,6 +125,8 @@ export interface Memory { categories?: Array; createdAt?: Date; updatedAt?: Date; + // TODO: Review this response field for removal in a future breaking release. + // It is not a selectable memory type; TypeScript has no procedural-memory path. memoryType?: string; score?: number; metadata?: any | null; diff --git a/mem0/memory/main.py b/mem0/memory/main.py index a8b159f14..ac75baa04 100644 --- a/mem0/memory/main.py +++ b/mem0/memory/main.py @@ -850,6 +850,8 @@ class Memory(MemoryBase): suggestion="Convert your input to a string, dictionary, or list of dictionaries." ) + # TODO: Remove procedural-memory support in a future breaking release. + # Remove memory_type and its helpers from Memory and AsyncMemory together. if agent_id is not None and memory_type == MemoryType.PROCEDURAL.value: results = self._create_procedural_memory(messages, metadata=processed_metadata, prompt=prompt) scale_threshold_notice = detect_scale_threshold_from_add_result(self, results) @@ -2502,6 +2504,8 @@ class AsyncMemory(MemoryBase): suggestion="Convert your input to a string, dictionary, or list of dictionaries." ) + # TODO: Remove procedural-memory support in a future breaking release. + # Remove memory_type and its helpers from Memory and AsyncMemory together. if agent_id is not None and memory_type == MemoryType.PROCEDURAL.value: results = await self._create_procedural_memory( messages, metadata=processed_metadata, prompt=prompt, llm=llm From 2c6ff619d12d8b8afad9b0be8731a973acd0d70a Mon Sep 17 00:00:00 2001 From: Diwakar Ray Yadav Date: Thu, 24 Sep 2026 22:16:31 +0545 Subject: [PATCH 29/55] fix(memory): exclude vector-store-rejected records from ADD results (#7066) --- mem0/memory/main.py | 56 ++++++++++---- tests/memory/test_main.py | 157 +++++++++++++++++++++++++++++++++++++- 2 files changed, 197 insertions(+), 16 deletions(-) diff --git a/mem0/memory/main.py b/mem0/memory/main.py index ac75baa04..05a55c876 100644 --- a/mem0/memory/main.py +++ b/mem0/memory/main.py @@ -22,7 +22,7 @@ from mem0.configs.prompts import ( PROCEDURAL_MEMORY_SYSTEM_PROMPT, generate_additive_extraction_prompt, ) -from mem0.exceptions import LLMError +from mem0.exceptions import LLMError, VectorStoreError from mem0.exceptions import ValidationError as Mem0ValidationError from mem0.memory.base import MemoryBase from mem0.memory.notices import ( @@ -1049,19 +1049,31 @@ class Memory(MemoryBase): all_ids = [r[0] for r in records] all_payloads = [r[3] for r in records] + # Only records confirmed to be stored make it into history, entity + # links, and the returned results — a record the store rejected must + # never be reported back as a successful ADD. + persisted_records = [] try: self.vector_store.insert( vectors=all_vectors, ids=all_ids, payloads=all_payloads, ) + persisted_records = records except Exception: # Fallback: insert one by one - for mid, vec, pay in zip(all_ids, all_vectors, all_payloads): + for rec in records: try: - self.vector_store.insert(vectors=[vec], ids=[mid], payloads=[pay]) + self.vector_store.insert(vectors=[rec[2]], ids=[rec[0]], payloads=[rec[3]]) + persisted_records.append(rec) except Exception as e: - logger.error(f"Failed to insert memory {mid}: {e}") + logger.error(f"Failed to insert memory {rec[0]}: {e}") + + if not persisted_records: + self.db.save_messages(messages, session_scope) + raise VectorStoreError( + f"Failed to insert any of the {len(records)} extracted memories into the vector store" + ) # Batch history history_records = [ @@ -1073,7 +1085,7 @@ class Memory(MemoryBase): "created_at": r[3].get("created_at"), "is_deleted": 0, } - for r in records + for r in persisted_records ] try: self.db.batch_add_history(history_records) @@ -1087,12 +1099,12 @@ class Memory(MemoryBase): # Phase 7: Batch entity linking try: - all_texts = [r[1] for r in records] + all_texts = [r[1] for r in persisted_records] all_entities = extract_entities_batch(all_texts) # 7a: Global dedup — collect unique entities across all memories global_entities = {} # normalized_key -> (entity_type, entity_text, set of memory_ids) - for idx, (memory_id, text, embedding, payload) in enumerate(records): + for idx, (memory_id, text, embedding, payload) in enumerate(persisted_records): entities = all_entities[idx] if idx < len(all_entities) else [] for entity_type, entity_text in entities: key = self._normalize_entity_text(entity_text) @@ -1196,7 +1208,7 @@ class Memory(MemoryBase): returned_memories = [ {"id": r[0], "memory": r[1], "event": "ADD"} - for r in records + for r in persisted_records ] keys, encoded_ids = process_telemetry_filters(filters) @@ -2709,6 +2721,10 @@ class AsyncMemory(MemoryBase): all_ids = [r[0] for r in records] all_payloads = [r[3] for r in records] + # Only records confirmed to be stored make it into history, entity + # links, and the returned results — a record the store rejected must + # never be reported back as a successful ADD. + persisted_records = [] try: await asyncio.to_thread( self.vector_store.insert, @@ -2716,12 +2732,22 @@ class AsyncMemory(MemoryBase): ids=all_ids, payloads=all_payloads, ) + persisted_records = records except Exception: - for mid, vec, pay in zip(all_ids, all_vectors, all_payloads): + for rec in records: try: - await asyncio.to_thread(self.vector_store.insert, vectors=[vec], ids=[mid], payloads=[pay]) + await asyncio.to_thread( + self.vector_store.insert, vectors=[rec[2]], ids=[rec[0]], payloads=[rec[3]] + ) + persisted_records.append(rec) except Exception as e: - logger.error(f"Failed to insert memory {mid} (async): {e}") + logger.error(f"Failed to insert memory {rec[0]} (async): {e}") + + if not persisted_records: + await asyncio.to_thread(self.db.save_messages, messages, session_scope) + raise VectorStoreError( + f"Failed to insert any of the {len(records)} extracted memories into the vector store" + ) # Batch history history_records = [ @@ -2733,7 +2759,7 @@ class AsyncMemory(MemoryBase): "created_at": r[3].get("created_at"), "is_deleted": 0, } - for r in records + for r in persisted_records ] try: await asyncio.to_thread(self.db.batch_add_history, history_records) @@ -2749,12 +2775,12 @@ class AsyncMemory(MemoryBase): # Phase 7: Batch entity linking try: - all_texts = [r[1] for r in records] + all_texts = [r[1] for r in persisted_records] all_entities = await asyncio.to_thread(extract_entities_batch, all_texts) # 7a: Global dedup global_entities = {} - for idx, (memory_id, text, embedding, payload) in enumerate(records): + for idx, (memory_id, text, embedding, payload) in enumerate(persisted_records): entities = all_entities[idx] if idx < len(all_entities) else [] for entity_type, entity_text in entities: key = self._normalize_entity_text(entity_text) @@ -2856,7 +2882,7 @@ class AsyncMemory(MemoryBase): returned_memories = [ {"id": r[0], "memory": r[1], "event": "ADD"} - for r in records + for r in persisted_records ] keys, encoded_ids = process_telemetry_filters(effective_filters) diff --git a/tests/memory/test_main.py b/tests/memory/test_main.py index cea7e3842..00d962c34 100644 --- a/tests/memory/test_main.py +++ b/tests/memory/test_main.py @@ -1,3 +1,4 @@ +import json import logging import time from datetime import datetime, timezone @@ -6,7 +7,7 @@ from unittest.mock import MagicMock, Mock import pytest -from mem0.exceptions import LLMError +from mem0.exceptions import LLMError, VectorStoreError from mem0.memory.main import AsyncMemory, Memory @@ -1178,3 +1179,157 @@ class TestAddPipelineEntityEmbeddingCountGuard: assert any("padding/truncating" in r.message for r in caplog.records), ( "expected count-mismatch warning was not emitted" ) + +class TestPartialInsertFailure: + """Records the vector store rejects must never be reported as successful ADDs (#6911).""" + + LLM_RESPONSE = json.dumps( + { + "memory": [ + {"text": "User's name is Aryan"}, + {"text": "User is allergic to penicillin"}, + {"text": "User works as an engineer"}, + ] + } + ) + + @pytest.fixture + def mock_memory(self, mocker): + mock_llm, _ = _setup_mocks(mocker) + + memory = Memory() + memory.config = mocker.MagicMock() + memory.config.custom_instructions = None + memory.config.custom_update_memory_prompt = None + memory.custom_instructions = None + memory.api_version = "v1.1" + memory.db.get_last_messages = MagicMock(return_value=[]) + memory.db.save_messages = MagicMock() + memory.db.batch_add_history = MagicMock() + memory.embedding_model.embed_batch = Mock(side_effect=lambda texts, action: [[0.1, 0.2, 0.3] for _ in texts]) + mocker.patch("mem0.memory.main.extract_entities_batch", return_value=[]) + mocker.patch("mem0.memory.main.capture_event") + + return memory + + def test_rejected_records_are_not_reported_as_add(self, mock_memory): + """A record rejected by the vector store must be absent from results and history.""" + poison = "User is allergic to penicillin" + real_insert = mock_memory.vector_store.insert + + def flaky_insert(vectors, ids, payloads): + if len(ids) > 1: + raise RuntimeError("batch insert rejected") + if payloads[0]["data"] == poison: + raise RuntimeError("record rejected by vector store") + return real_insert(vectors=vectors, ids=ids, payloads=payloads) + + mock_memory.vector_store.insert = Mock(side_effect=flaky_insert) + mock_memory.llm.generate_response.return_value = self.LLM_RESPONSE + + result = mock_memory._add_to_vector_store( + messages=[{"role": "user", "content": "My name is Aryan. I work as an engineer."}], + metadata={}, + filters={}, + infer=True, + ) + + assert [r["memory"] for r in result] == [ + "User's name is Aryan", + "User works as an engineer", + ] + assert all(r["event"] == "ADD" for r in result) + + history = mock_memory.db.batch_add_history.call_args.args[0] + assert {h["new_memory"] for h in history} == { + "User's name is Aryan", + "User works as an engineer", + } + + def test_all_inserts_failed_raises_vector_store_error(self, mock_memory): + """If nothing persisted, add() must raise VectorStoreError instead of reporting success.""" + mock_memory.vector_store.insert = Mock(side_effect=RuntimeError("vector store down")) + mock_memory.llm.generate_response.return_value = self.LLM_RESPONSE + + with pytest.raises(VectorStoreError, match="Failed to insert any"): + mock_memory._add_to_vector_store( + messages=[{"role": "user", "content": "test"}], + metadata={}, + filters={}, + infer=True, + ) + + # Raw messages are still saved so a later retry can re-extract them. + mock_memory.db.save_messages.assert_called_once() + + +@pytest.mark.asyncio +class TestAsyncPartialInsertFailure: + """Async mirror of TestPartialInsertFailure (#6911).""" + + LLM_RESPONSE = TestPartialInsertFailure.LLM_RESPONSE + + @pytest.fixture + def mock_async_memory(self, mocker): + mock_llm, _ = _setup_mocks(mocker) + + memory = AsyncMemory() + memory.config = mocker.MagicMock() + memory.config.custom_instructions = None + memory.config.custom_update_memory_prompt = None + memory.custom_instructions = None + memory.api_version = "v1.1" + memory.db.get_last_messages = MagicMock(return_value=[]) + memory.db.save_messages = MagicMock() + memory.db.batch_add_history = MagicMock() + memory.embedding_model.embed_batch = Mock(side_effect=lambda texts, action: [[0.1, 0.2, 0.3] for _ in texts]) + mocker.patch("mem0.memory.main.extract_entities_batch", return_value=[]) + mocker.patch("mem0.memory.main.capture_event") + + return memory + + async def test_rejected_records_are_not_reported_as_add(self, mock_async_memory): + poison = "User is allergic to penicillin" + real_insert = mock_async_memory.vector_store.insert + + def flaky_insert(vectors, ids, payloads): + if len(ids) > 1: + raise RuntimeError("batch insert rejected") + if payloads[0]["data"] == poison: + raise RuntimeError("record rejected by vector store") + return real_insert(vectors=vectors, ids=ids, payloads=payloads) + + mock_async_memory.vector_store.insert = Mock(side_effect=flaky_insert) + mock_async_memory.llm.generate_response.return_value = self.LLM_RESPONSE + + result = await mock_async_memory._add_to_vector_store( + messages=[{"role": "user", "content": "My name is Aryan. I work as an engineer."}], + metadata={}, + effective_filters={}, + infer=True, + ) + + assert [r["memory"] for r in result] == [ + "User's name is Aryan", + "User works as an engineer", + ] + + history = mock_async_memory.db.batch_add_history.call_args.args[0] + assert {h["new_memory"] for h in history} == { + "User's name is Aryan", + "User works as an engineer", + } + + async def test_all_inserts_failed_raises_vector_store_error(self, mock_async_memory): + mock_async_memory.vector_store.insert = Mock(side_effect=RuntimeError("vector store down")) + mock_async_memory.llm.generate_response.return_value = self.LLM_RESPONSE + + with pytest.raises(VectorStoreError, match="Failed to insert any"): + await mock_async_memory._add_to_vector_store( + messages=[{"role": "user", "content": "test"}], + metadata={}, + effective_filters={}, + infer=True, + ) + + mock_async_memory.db.save_messages.assert_called_once() From d675cf68adea399b475b71b38832361c34a432c8 Mon Sep 17 00:00:00 2001 From: Mohd Quamar Tyagi <104281681+Tyagiquamar@users.noreply.github.com> Date: Thu, 24 Sep 2026 22:04:57 +0530 Subject: [PATCH 30/55] fix(memory): restore Memory and AsyncMemory context-manager protocol (#7354) --- mem0/memory/main.py | 14 ++++++++++++++ tests/test_telemetry.py | 40 ++++++++++++++++++++++++++++++++++++++++ 2 files changed, 54 insertions(+) diff --git a/mem0/memory/main.py b/mem0/memory/main.py index 05a55c876..e750edbf1 100644 --- a/mem0/memory/main.py +++ b/mem0/memory/main.py @@ -2179,6 +2179,13 @@ class Memory(MemoryBase): self.db.close() self.db = None + def __enter__(self): + return self + + def __exit__(self, exc_type, exc_val, exc_tb): + self.close() + return False + def chat(self, query): raise NotImplementedError("Chat function not implemented yet.") @@ -3894,5 +3901,12 @@ class AsyncMemory(MemoryBase): self.db.close() self.db = None + async def __aenter__(self): + return self + + async def __aexit__(self, exc_type, exc_val, exc_tb): + self.close() + return False + async def chat(self, query): raise NotImplementedError("Chat function not implemented yet.") diff --git a/tests/test_telemetry.py b/tests/test_telemetry.py index fb7001a62..7c1df5c01 100644 --- a/tests/test_telemetry.py +++ b/tests/test_telemetry.py @@ -333,6 +333,25 @@ class TestMemoryLifecycle: # db attribute not set at all m.close() # should not raise due to hasattr guard + def test_context_manager_returns_self_and_closes(self): + """with-block should yield the instance and close() it on exit.""" + m = self._make_mock_memory() + db = m.db + with m as ctx: + assert ctx is m + db.close.assert_called_once_with() + assert m.db is None + + def test_context_manager_closes_on_exception(self): + """Exceptions from the with-body should propagate after close().""" + m = self._make_mock_memory() + db = m.db + with pytest.raises(RuntimeError, match="boom"): + with m: + raise RuntimeError("boom") + db.close.assert_called_once_with() + assert m.db is None + class TestAsyncMemoryLifecycle: """Verify AsyncMemory.close() and async context manager support.""" @@ -357,6 +376,27 @@ class TestAsyncMemoryLifecycle: m = AsyncMemory.__new__(AsyncMemory) m.close() # should not raise + @pytest.mark.asyncio + async def test_async_context_manager_returns_self_and_closes(self): + """async with-block should yield the instance and close() it on exit.""" + m = self._make_mock_async_memory() + db = m.db + async with m as ctx: + assert ctx is m + db.close.assert_called_once_with() + assert m.db is None + + @pytest.mark.asyncio + async def test_async_context_manager_closes_on_exception(self): + """Exceptions from the async with-body should propagate after close().""" + m = self._make_mock_async_memory() + db = m.db + with pytest.raises(RuntimeError, match="boom"): + async with m: + raise RuntimeError("boom") + db.close.assert_called_once_with() + assert m.db is None + class TestTelemetryEnvVar: """Verify the MEM0_TELEMETRY env var parsing logic.""" From 989c7da0fc8e4df6342dbb8c448af9816d60d24c Mon Sep 17 00:00:00 2001 From: Varun S G <143688508+warun7@users.noreply.github.com> Date: Thu, 24 Sep 2026 22:14:28 +0530 Subject: [PATCH 31/55] fix(oss): stop ConfigManager from injecting OpenAI's baseURL and model into other providers (#7350) --- mem0-ts/src/oss/src/config/manager.ts | 17 ++++-- mem0-ts/src/oss/tests/config-manager.test.ts | 60 ++++++++++++++++++-- 2 files changed, 69 insertions(+), 8 deletions(-) diff --git a/mem0-ts/src/oss/src/config/manager.ts b/mem0-ts/src/oss/src/config/manager.ts index b2803d1b2..d2fa34b52 100644 --- a/mem0-ts/src/oss/src/config/manager.ts +++ b/mem0-ts/src/oss/src/config/manager.ts @@ -113,7 +113,18 @@ export class ConfigManager { const userConf = userConfig.llm?.config; const provider = userConfig.llm?.provider || DEFAULT_MEMORY_CONFIG.llm.provider; - let finalModel: string | any = defaultConf.model; + // DEFAULT_MEMORY_CONFIG.llm.config holds OpenAI's own defaults (baseURL and + // model). Handing those to any other provider shadows that provider's default + // *and* its env fallback (DEEPSEEK_API_BASE, XAI_API_BASE, ...), so a config + // copied from the docs for another provider ends up pointed at OpenAI with an + // OpenAI model name. vLLM already needed a carve-out here for exactly this + // reason; every non-OpenAI provider needs it. + const usesOpenAIDefaults = + provider.toLowerCase() === "openai" || + provider.toLowerCase() === "openai_structured"; + let finalModel: string | any = usesOpenAIDefaults + ? defaultConf.model + : undefined; if (userConf?.model && typeof userConf.model === "object") { finalModel = userConf.model; @@ -131,9 +142,7 @@ export class ConfigManager { | string | undefined) ?? userConf?.url ?? - (provider.toLowerCase() === "vllm" - ? undefined - : defaultConf.baseURL); + (usesOpenAIDefaults ? defaultConf.baseURL : undefined); const temperature = userConf?.temperature ?? (llmRaw?.temperature as number | undefined); diff --git a/mem0-ts/src/oss/tests/config-manager.test.ts b/mem0-ts/src/oss/tests/config-manager.test.ts index 7c1856ad8..b3304509a 100644 --- a/mem0-ts/src/oss/tests/config-manager.test.ts +++ b/mem0-ts/src/oss/tests/config-manager.test.ts @@ -1,5 +1,6 @@ /// import { ConfigManager } from "../src/config/manager"; +import { LLMFactory } from "../src/utils/factory"; describe("ConfigManager", () => { describe("mergeConfig - dimension handling", () => { @@ -141,7 +142,7 @@ describe("ConfigManager", () => { expect(config.llm.config.url).toBe("http://my-ollama-host:11434"); }); - it("should use default baseURL when no url or baseURL provided", () => { + it("should not fall back to the OpenAI default baseURL for a non-OpenAI provider", () => { const config = ConfigManager.mergeConfig({ embedder: baseEmbedder, vectorStore: baseVectorStore, @@ -152,7 +153,9 @@ describe("ConfigManager", () => { }); expect(config.llm.config.url).toBeUndefined(); - expect(config.llm.config.baseURL).toBe("https://api.openai.com/v1"); + // OllamaLLM defaults to http://localhost:11434. The OpenAI default used to be + // injected here, which pointed OllamaLLM at OpenAI instead. + expect(config.llm.config.baseURL).toBeUndefined(); }); it("normalizes vllm_base_url to baseURL for vLLM", () => { @@ -367,14 +370,63 @@ describe("ConfigManager", () => { expect(cfg.llm.config.baseURL).toBe("http://camel:1234/v1"); }); - it("falls back to default baseURL when neither is provided for LLM", () => { + it("does not inject the OpenAI baseURL default for a non-OpenAI provider", () => { const cfg = ConfigManager.mergeConfig({ embedder: baseEmbedder, vectorStore: { provider: "memory", config: {} }, llm: { provider: "lmstudio", config: { model: "test-model" } }, }); - expect(cfg.llm.config.baseURL).toBe("https://api.openai.com/v1"); + // The provider supplies its own baseURL (http://localhost:1234/v1) when none is + // given. Injecting OpenAI's here shadowed it and sent lmstudio traffic to OpenAI. + expect(cfg.llm.config.baseURL).toBeUndefined(); + }); + + it("does not inject the OpenAI model default for a non-OpenAI provider", () => { + const cfg = ConfigManager.mergeConfig({ + embedder: baseEmbedder, + vectorStore: { provider: "memory", config: {} }, + llm: { provider: "deepseek", config: { apiKey: "k" } }, + }); + + // DeepSeekLLM falls back to "deepseek-chat" when model is unset. Injecting + // "gpt-5-mini" here made that fallback unreachable. + expect(cfg.llm.config.model).toBeUndefined(); + }); + + it("still applies the OpenAI defaults for the OpenAI providers", () => { + for (const provider of ["openai", "openai_structured"]) { + const cfg = ConfigManager.mergeConfig({ + embedder: baseEmbedder, + vectorStore: { provider: "memory", config: {} }, + llm: { provider, config: { apiKey: "k" } }, + }); + + expect(cfg.llm.config.baseURL).toBe("https://api.openai.com/v1"); + expect(cfg.llm.config.model).toBe("gpt-5-mini"); + } + }); + + it("lets each non-OpenAI provider resolve its own endpoint", () => { + const cases: Array<[string, string]> = [ + ["deepseek", "https://api.deepseek.com"], + ["xai", "https://api.x.ai/v1"], + ["lmstudio", "http://localhost:1234/v1"], + ]; + + for (const [provider, expected] of cases) { + const cfg = ConfigManager.mergeConfig({ + embedder: baseEmbedder, + vectorStore: { provider: "memory", config: {} }, + llm: { provider, config: { apiKey: "k" } }, + }); + + const built = LLMFactory.create(provider, cfg.llm.config); + // The client the provider actually built must not point at OpenAI. + const baseURL = + (built as any).openai?.baseURL ?? (built as any).baseURL; + expect(String(baseURL)).toBe(expected); + } }); }); From 8d6c001966573786d36908bfe4dfd52935749200 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 25 Sep 2026 09:58:06 +0530 Subject: [PATCH 32/55] Fix grammar & typos: correct OpenSearch spelling in changelog (#7442) Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- docs/changelog/sdk.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/changelog/sdk.mdx b/docs/changelog/sdk.mdx index 3f4a64202..5598d0d96 100644 --- a/docs/changelog/sdk.mdx +++ b/docs/changelog/sdk.mdx @@ -982,7 +982,7 @@ See the [OSS v2 to v3 migration guide](https://docs.mem0.ai/migration/oss-v2-to- **New Features:** - **OpenMemory:** Added OpenMemory support - **Neo4j:** Added weights to Neo4j model -- **AWS:** Added support for Opsearch Serverless +- **AWS:** Added support for OpenSearch Serverless - **Examples:** Added ElizaOS Example **Improvements:** From 545306db5a52bc45fa07585dd7f71ed6ea8dbed2 Mon Sep 17 00:00:00 2001 From: Abhay Singh Date: Fri, 25 Sep 2026 15:30:31 +0530 Subject: [PATCH 33/55] fix(ts-oss/turbopuffer): apply all filter operators, not just gte/lte (#6578) --- .../src/oss/src/vector_stores/turbopuffer.ts | 53 +++++++-- .../src/oss/tests/turbopuffer.unit.test.ts | 102 ++++++++++++++++++ 2 files changed, 144 insertions(+), 11 deletions(-) create mode 100644 mem0-ts/src/oss/tests/turbopuffer.unit.test.ts diff --git a/mem0-ts/src/oss/src/vector_stores/turbopuffer.ts b/mem0-ts/src/oss/src/vector_stores/turbopuffer.ts index 5134aa80a..8979818d2 100644 --- a/mem0-ts/src/oss/src/vector_stores/turbopuffer.ts +++ b/mem0-ts/src/oss/src/vector_stores/turbopuffer.ts @@ -247,23 +247,54 @@ export class TurbopufferDB implements VectorStore { } } + // Maps mem0's universal filter operators to Turbopuffer's filter tokens. + private static readonly OPERATOR_MAP: Record = { + eq: "Eq", + ne: "NotEq", + gt: "Gt", + gte: "Gte", + lt: "Lt", + lte: "Lte", + in: "In", + nin: "NotIn", + }; + private convertFilters(filters?: SearchFilters): any { if (!filters || Object.keys(filters).length === 0) return null; const conditions: any[] = []; for (const [key, value] of Object.entries(filters)) { - if ( - typeof value === "object" && - value !== null && - !Array.isArray(value) - ) { - if ("gte" in value) conditions.push([key, "Gte", value.gte]); - if ("lte" in value) conditions.push([key, "Lte", value.lte]); - if ("gt" in value) conditions.push([key, "Gt", value.gt]); - if ("lt" in value) conditions.push([key, "Lt", value.lt]); - } else { - conditions.push([key, "Eq", value]); + // "*" is a match-any wildcard: it must not constrain the query. The old + // code turned it into `[key, "Eq", "*"]`, matching nothing. + if (value === "*") { + continue; } + + // Array shorthand: { key: [a, b] } means "in". + if (Array.isArray(value)) { + conditions.push([key, "In", value]); + continue; + } + + if (typeof value === "object" && value !== null) { + // Operator dict: every operator present must hold. Previously only + // `gte` and `lte` were read, so `gt`/`lt`/`ne`/`eq`/`in`/`nin` were + // silently dropped and the filter returned unfiltered results. + for (const [op, operand] of Object.entries(value)) { + const token = TurbopufferDB.OPERATOR_MAP[op]; + if (!token) { + throw new Error( + `Unsupported Turbopuffer filter operator '${op}' for field '${key}'. ` + + `Supported operators: ${Object.keys(TurbopufferDB.OPERATOR_MAP).join(", ")}.`, + ); + } + conditions.push([key, token, operand]); + } + continue; + } + + // Scalar shorthand: equality. + conditions.push([key, "Eq", value]); } if (conditions.length === 0) return null; diff --git a/mem0-ts/src/oss/tests/turbopuffer.unit.test.ts b/mem0-ts/src/oss/tests/turbopuffer.unit.test.ts new file mode 100644 index 000000000..5dcec9f05 --- /dev/null +++ b/mem0-ts/src/oss/tests/turbopuffer.unit.test.ts @@ -0,0 +1,102 @@ +/// +/** + * Turbopuffer vector store — filter translation unit tests. + * + * Drives the private convertFilters() through the public search() API with a + * virtually-mocked @turbopuffer/turbopuffer peer, and asserts the filter tuple + * handed to ns.query(). + */ + +const mockQuery = jest.fn().mockResolvedValue({ rows: [] }); + +// The peer is an optional dependency and may not be installed; mock it +// virtually. createClient() does `new sdk.default({...})`, whose namespace() +// returns the object search() calls query() on. +jest.mock( + "@turbopuffer/turbopuffer", + () => ({ + __esModule: true, + default: class { + namespace() { + return { query: mockQuery }; + } + }, + }), + { virtual: true }, +); + +import { TurbopufferDB } from "../src/vector_stores/turbopuffer"; + +function makeStore() { + return new TurbopufferDB({ + apiKey: "test-key", + collectionName: "mem0", + } as any); +} + +async function filterFor(filters: any): Promise { + mockQuery.mockClear(); + await makeStore().search([0.1, 0.2, 0.3], 5, filters); + return mockQuery.mock.calls[0][0].filters; +} + +describe("TurbopufferDB convertFilters", () => { + it("maps every operator, not just gte/lte", async () => { + expect(await filterFor({ age: { gt: 18 } })).toEqual(["age", "Gt", 18]); + expect(await filterFor({ age: { lt: 65 } })).toEqual(["age", "Lt", 65]); + expect(await filterFor({ age: { ne: 40 } })).toEqual(["age", "NotEq", 40]); + expect(await filterFor({ role: { eq: "admin" } })).toEqual([ + "role", + "Eq", + "admin", + ]); + expect(await filterFor({ tier: { in: ["a", "b"] } })).toEqual([ + "tier", + "In", + ["a", "b"], + ]); + expect(await filterFor({ tier: { nin: ["x"] } })).toEqual([ + "tier", + "NotIn", + ["x"], + ]); + }); + + it("applies every operator in a compound range (AND), not just the first", async () => { + const filter = await filterFor({ age: { gt: 18, lt: 65 } }); + expect(filter[0]).toBe("And"); + expect(filter[1]).toEqual( + expect.arrayContaining([ + ["age", "Gt", 18], + ["age", "Lt", 65], + ]), + ); + }); + + it("treats a bare array value as an 'in' filter", async () => { + expect(await filterFor({ tier: ["gold", "silver"] })).toEqual([ + "tier", + "In", + ["gold", "silver"], + ]); + }); + + it("keeps scalar equality working", async () => { + expect(await filterFor({ user_id: "u1" })).toEqual(["user_id", "Eq", "u1"]); + }); + + it("skips a '*' wildcard value instead of matching it literally", async () => { + // Only the real agent_id clause survives; user_id: "*" contributes nothing. + expect(await filterFor({ user_id: "*", agent_id: "a1" })).toEqual([ + "agent_id", + "Eq", + "a1", + ]); + }); + + it("throws on an unsupported operator rather than silently dropping it", async () => { + await expect( + makeStore().search([0.1, 0.2, 0.3], 5, { name: { startsWith: "a" } }), + ).rejects.toThrow(/Unsupported Turbopuffer filter operator 'startsWith'/); + }); +}); From ccd216cff058e6a45ef12464ef9653dec9b0e512 Mon Sep 17 00:00:00 2001 From: Yash Singh <123385188+yashs33244@users.noreply.github.com> Date: Fri, 25 Sep 2026 15:53:35 +0530 Subject: [PATCH 34/55] fix(vector_stores/turbopuffer): apply all filter operators instead of dropping them (#6564) --- mem0/vector_stores/turbopuffer.py | 24 ++++++++++++++--- tests/vector_stores/test_turbopuffer.py | 34 +++++++++++++++++++++++++ 2 files changed, 54 insertions(+), 4 deletions(-) diff --git a/mem0/vector_stores/turbopuffer.py b/mem0/vector_stores/turbopuffer.py index bef4b40b2..76281fc96 100644 --- a/mem0/vector_stores/turbopuffer.py +++ b/mem0/vector_stores/turbopuffer.py @@ -131,6 +131,18 @@ class TurbopufferDB(VectorStoreBase): )) return results + # Maps mem0 filter operators to their Turbopuffer equivalents. + OPERATOR_MAP = { + "eq": "Eq", + "ne": "NotEq", + "gt": "Gt", + "gte": "Gte", + "lt": "Lt", + "lte": "Lte", + "in": "In", + "nin": "NotIn", + } + def _convert_filters(self, filters: Optional[Dict]): """ Convert mem0 filters to Turbopuffer filter format. @@ -143,10 +155,14 @@ class TurbopufferDB(VectorStoreBase): conditions = [] for key, value in filters.items(): if isinstance(value, dict): - if "gte" in value: - conditions.append((key, "Gte", value["gte"])) - if "lte" in value: - conditions.append((key, "Lte", value["lte"])) + for op, operand in value.items(): + tpuf_op = self.OPERATOR_MAP.get(op) + if tpuf_op is None: + raise ValueError( + f"Unsupported filter operator '{op}' for field '{key}'. " + f"Supported operators: {sorted(self.OPERATOR_MAP)}" + ) + conditions.append((key, tpuf_op, operand)) else: conditions.append((key, "Eq", value)) diff --git a/tests/vector_stores/test_turbopuffer.py b/tests/vector_stores/test_turbopuffer.py index d1915b94e..e1b9233bb 100644 --- a/tests/vector_stores/test_turbopuffer.py +++ b/tests/vector_stores/test_turbopuffer.py @@ -276,6 +276,40 @@ class TestConvertFilters: assert ("user_id", "Eq", "u1") in conditions assert ("score", "Gte", 0.5) in conditions + def test_gt_operator_not_dropped(self, db): + """Regression: {"gt": ...} was silently dropped, returning unfiltered results.""" + result = db._convert_filters({"age": {"gt": 18}}) + assert result == ("age", "Gt", 18) + + @pytest.mark.parametrize( + "op,expected_token", + [ + ("eq", "Eq"), + ("ne", "NotEq"), + ("gt", "Gt"), + ("gte", "Gte"), + ("lt", "Lt"), + ("lte", "Lte"), + ("in", "In"), + ("nin", "NotIn"), + ], + ) + def test_all_operators_mapped(self, db, op, expected_token): + operand = [1, 2] if op in ("in", "nin") else 5 + result = db._convert_filters({"age": {op: operand}}) + assert result == ("age", expected_token, operand) + + def test_multiple_operators_on_one_field(self, db): + result = db._convert_filters({"age": {"gt": 18, "lt": 65}}) + assert result[0] == "And" + conditions = result[1] + assert ("age", "Gt", 18) in conditions + assert ("age", "Lt", 65) in conditions + + def test_unknown_operator_raises(self, db): + with pytest.raises(ValueError, match="Unsupported filter operator"): + db._convert_filters({"age": {"between": [1, 2]}}) + # ── search ─────────────────────────────────────────────────────────── From fb6d5e1917dd28def068821d86356e602aff446a Mon Sep 17 00:00:00 2001 From: Ayaan Gazali Date: Fri, 25 Sep 2026 03:50:09 -0700 Subject: [PATCH 35/55] fix(llms/aws_bedrock): iterate Converse content blocks for Anthropic text (#6369) --- mem0/llms/aws_bedrock.py | 15 ++++++++--- tests/llms/test_aws_bedrock.py | 48 ++++++++++++++++++++++++++++++++++ 2 files changed, 60 insertions(+), 3 deletions(-) diff --git a/mem0/llms/aws_bedrock.py b/mem0/llms/aws_bedrock.py index 20b7f3883..7fabbd22d 100644 --- a/mem0/llms/aws_bedrock.py +++ b/mem0/llms/aws_bedrock.py @@ -579,11 +579,20 @@ class AWSBedrockLLM(LLMBase): # Use converse API for Anthropic models response = self.client.converse(**converse_params) - # Parse Converse API response + # Parse Converse API response. Claude reasoning models can emit a + # `reasoningContent` block before the `text` block, so iterate to + # find the first block that carries text instead of indexing + # content[0] (same approach as the MiniMax branch below). if hasattr(response, 'output') and hasattr(response.output, 'message'): - return response.output.message.content[0].text + for block in response.output.message.content: + if hasattr(block, 'text'): + return block.text + return "" elif 'output' in response and 'message' in response['output']: - return response['output']['message']['content'][0]['text'] + for block in response['output']['message']['content']: + if 'text' in block: + return block['text'] + return "" else: return str(response) diff --git a/tests/llms/test_aws_bedrock.py b/tests/llms/test_aws_bedrock.py index f683f8c3f..ecb960d09 100644 --- a/tests/llms/test_aws_bedrock.py +++ b/tests/llms/test_aws_bedrock.py @@ -506,3 +506,51 @@ class TestParseResponseLegacy: response = {"body": body} result = llm._parse_response(response, tools=None) assert result == "hello from ai21" + + +class TestAnthropicConverseContentParsing: + """The Anthropic Converse branch must not assume content[0] is the text + block: Claude reasoning models emit a reasoningContent block before the + text block, and some stop conditions produce an empty content array. The + parser iterates for the first block carrying text, like the MiniMax branch. + """ + + def test_text_after_reasoning_content_block(self, mock_boto3): + mock_boto3.converse.return_value = { + "output": { + "message": { + "content": [ + {"reasoningContent": {"reasoningText": {"text": "step by step..."}}}, + {"text": "final answer"}, + ] + } + } + } + llm = _make_llm("anthropic.claude-3-5-sonnet-20240620-v1:0", mock_boto3) + + assert llm.generate_response(MESSAGES) == "final answer" + + def test_empty_content_returns_empty_string(self, mock_boto3): + mock_boto3.converse.return_value = {"output": {"message": {"content": []}}} + llm = _make_llm("anthropic.claude-3-5-sonnet-20240620-v1:0", mock_boto3) + + assert llm.generate_response(MESSAGES) == "" + + def test_plain_text_content_still_returned(self, mock_boto3): + mock_boto3.converse.return_value = _converse_response("plain answer") + llm = _make_llm("anthropic.claude-3-5-sonnet-20240620-v1:0", mock_boto3) + + assert llm.generate_response(MESSAGES) == "plain answer" + + def test_object_style_response_iterates_blocks(self, mock_boto3): + # Defensive attr-style branch: object wrapper with a reasoning block first. + from types import SimpleNamespace + + reasoning_block = SimpleNamespace(reasoningContent={"reasoningText": {"text": "hmm"}}) + text_block = SimpleNamespace(text="object answer") + mock_boto3.converse.return_value = SimpleNamespace( + output=SimpleNamespace(message=SimpleNamespace(content=[reasoning_block, text_block])) + ) + llm = _make_llm("anthropic.claude-3-5-sonnet-20240620-v1:0", mock_boto3) + + assert llm.generate_response(MESSAGES) == "object answer" From a2d8a8a849810e887757d2be7d716cf894c5627c Mon Sep 17 00:00:00 2001 From: Yash Singh <123385188+yashs33244@users.noreply.github.com> Date: Fri, 25 Sep 2026 16:21:16 +0530 Subject: [PATCH 36/55] fix(vector_stores/s3_vectors): make search score metric-aware (#6547) --- mem0/vector_stores/s3_vectors.py | 12 +++++++- tests/vector_stores/test_s3_vectors.py | 39 ++++++++++++++++++++++++++ 2 files changed, 50 insertions(+), 1 deletion(-) diff --git a/mem0/vector_stores/s3_vectors.py b/mem0/vector_stores/s3_vectors.py index da059a409..55dadb878 100644 --- a/mem0/vector_stores/s3_vectors.py +++ b/mem0/vector_stores/s3_vectors.py @@ -69,6 +69,16 @@ class S3Vectors(VectorStoreBase): else: raise + def _distance_to_score(self, raw_distance: Optional[float]) -> Optional[float]: + if raw_distance is None: + return None + # Euclidean distance is unbounded, so 1 - distance would collapse most + # scores to 0. Use a bounded monotonic map instead. Cosine distance is + # in [0, 2], where 1 - distance is already a valid similarity. + if self.distance_metric == "euclidean": + return 1.0 / (1.0 + raw_distance) + return max(0.0, 1.0 - raw_distance) + def _parse_output(self, vectors: List[Dict]) -> List[OutputData]: results = [] for v in vectors: @@ -81,7 +91,7 @@ class S3Vectors(VectorStoreBase): logger.warning(f"Failed to parse metadata for key {v.get('key')}") payload = {} raw_distance = v.get("distance") - score = max(0.0, 1.0 - raw_distance) if raw_distance is not None else None + score = self._distance_to_score(raw_distance) results.append(OutputData(id=v.get("key"), score=score, payload=payload)) return results diff --git a/tests/vector_stores/test_s3_vectors.py b/tests/vector_stores/test_s3_vectors.py index 68b7fa0f6..b72db32f4 100644 --- a/tests/vector_stores/test_s3_vectors.py +++ b/tests/vector_stores/test_s3_vectors.py @@ -186,6 +186,45 @@ def test_search(mock_boto_client): assert results[0].score == pytest.approx(0.1) +def test_search_score_cosine_uses_one_minus_distance(mock_boto_client): + """Cosine metric keeps the 1 - distance similarity mapping.""" + mock_boto_client.query_vectors.return_value = {"vectors": [{"key": "id1", "distance": 0.25, "metadata": {}}]} + store = S3Vectors( + vector_bucket_name=BUCKET_NAME, + collection_name=INDEX_NAME, + embedding_model_dims=EMBEDDING_DIMS, + distance_metric="cosine", + ) + + results = store.search(query="test", vectors=[0.1, 0.2], top_k=1) + + assert results[0].score == pytest.approx(0.75) + + +def test_search_score_euclidean_uses_bounded_map(mock_boto_client): + """Euclidean distance is unbounded; scores must not collapse to 0.""" + mock_boto_client.query_vectors.return_value = { + "vectors": [ + {"key": "near", "distance": 0.5, "metadata": {}}, + {"key": "far", "distance": 4.0, "metadata": {}}, + ] + } + store = S3Vectors( + vector_bucket_name=BUCKET_NAME, + collection_name=INDEX_NAME, + embedding_model_dims=EMBEDDING_DIMS, + distance_metric="euclidean", + ) + + results = store.search(query="test", vectors=[0.1, 0.2], top_k=2) + + # 1 / (1 + d): a distance > 1 would give a negative (clamped 0) score under + # the old cosine-only formula; the bounded map keeps ranking intact. + assert results[0].score == pytest.approx(1.0 / 1.5) + assert results[1].score == pytest.approx(1.0 / 5.0) + assert results[0].score > results[1].score > 0.0 + + def test_get(mock_boto_client): """Test retrieving a vector by ID.""" mock_boto_client.get_vectors.return_value = { From 70c676c8c44d96b3032c5a8650809a2a14924734 Mon Sep 17 00:00:00 2001 From: Ratish jain <43003421+ratishjain12@users.noreply.github.com> Date: Fri, 25 Sep 2026 17:04:47 +0530 Subject: [PATCH 37/55] fix: wire dev tooling (ruff/isort/pre-commit) into hatch dev environments (#6684) --- pyproject.toml | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index ddb3d7153..b16a6c0db 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -83,7 +83,7 @@ test = [ dev = [ "ruff==0.16.0", "isort>=5.13.2", - "pytest>=8.2.2", + "pre-commit>=3.5.0", ] [tool.pytest.ini_options] @@ -111,6 +111,7 @@ features = [ "vector-stores", "llms", "extras", + "dev", ] [tool.hatch.envs.dev_py_3_11] @@ -120,6 +121,7 @@ features = [ "vector-stores", "llms", "extras", + "dev", ] [tool.hatch.envs.dev_py_3_12] @@ -129,6 +131,12 @@ features = [ "vector-stores", "llms", "extras", + "dev", +] + +[tool.hatch.envs.default] +features = [ + "dev", ] [tool.hatch.envs.default.scripts] From 5fd01d284a35a044602350d1faabaa02ee27c00d Mon Sep 17 00:00:00 2001 From: Abhay Singh Date: Fri, 25 Sep 2026 17:07:11 +0530 Subject: [PATCH 38/55] fix(ts-oss/turbopuffer): bound euclidean_squared distance to a similarity score (#6580) --- .../src/oss/src/vector_stores/turbopuffer.ts | 13 ++- .../src/oss/tests/turbopuffer.score.test.ts | 80 +++++++++++++++++++ 2 files changed, 92 insertions(+), 1 deletion(-) create mode 100644 mem0-ts/src/oss/tests/turbopuffer.score.test.ts diff --git a/mem0-ts/src/oss/src/vector_stores/turbopuffer.ts b/mem0-ts/src/oss/src/vector_stores/turbopuffer.ts index 8979818d2..30e032630 100644 --- a/mem0-ts/src/oss/src/vector_stores/turbopuffer.ts +++ b/mem0-ts/src/oss/src/vector_stores/turbopuffer.ts @@ -305,7 +305,18 @@ export class TurbopufferDB implements VectorStore { private parseRows(rows: any[]): VectorStoreResult[] { return rows.map((row) => { const { id, $dist, vector, ...rest } = row; - const score = $dist != null ? 1 - $dist : undefined; + let score: number | undefined; + if ($dist == null) { + score = undefined; + } else if (this.distanceMetric === "euclidean_squared") { + // euclidean_squared $dist is an unbounded squared distance, so 1 - $dist + // goes negative for any $dist > 1 and inverts ranking. Convert it to a + // bounded higher-is-better score, mirroring the milvus/baidu stores. + score = 1 / (1 + $dist); + } else { + // Cosine distance is in [0, 2]; 1 - $dist stays a meaningful similarity. + score = 1 - $dist; + } return { id: String(id), payload: rest, score }; }); } diff --git a/mem0-ts/src/oss/tests/turbopuffer.score.test.ts b/mem0-ts/src/oss/tests/turbopuffer.score.test.ts new file mode 100644 index 000000000..b6e8ba844 --- /dev/null +++ b/mem0-ts/src/oss/tests/turbopuffer.score.test.ts @@ -0,0 +1,80 @@ +/// +/** + * Turbopuffer vector store — score conversion unit tests. + * + * Drives parseRows() through the public search() API with a virtually-mocked + * @turbopuffer/turbopuffer peer, asserting the score returned per metric. + */ + +const mockQuery = jest.fn(); + +jest.mock( + "@turbopuffer/turbopuffer", + () => ({ + __esModule: true, + default: class { + namespace() { + return { query: mockQuery }; + } + }, + }), + { virtual: true }, +); + +import { TurbopufferDB } from "../src/vector_stores/turbopuffer"; + +function makeStore(distanceMetric?: string) { + return new TurbopufferDB({ + apiKey: "test-key", + collectionName: "mem0", + ...(distanceMetric ? { distanceMetric } : {}), + } as any); +} + +async function scoreFor( + distanceMetric: string | undefined, + row: Record, +): Promise { + mockQuery.mockResolvedValueOnce({ rows: [row] }); + const results = await makeStore(distanceMetric).search([0.1, 0.2, 0.3], 5); + return results[0].score; +} + +describe("TurbopufferDB score conversion", () => { + it("keeps cosine distance as 1 - dist (default metric)", async () => { + // cosine_distance is the default; a distance of 0.25 -> similarity 0.75. + expect(await scoreFor(undefined, { id: "a", $dist: 0.25 })).toBeCloseTo( + 0.75, + 10, + ); + }); + + it("bounds an unbounded euclidean_squared distance to a 0..1 similarity", async () => { + // $dist = 4.0 is a squared distance. 1 - 4.0 = -3.0 would invert ranking; + // 1 / (1 + 4.0) = 0.2 keeps it higher-is-better and in range. + const score = await scoreFor("euclidean_squared", { id: "a", $dist: 4.0 }); + expect(score).toBeCloseTo(0.2, 10); + expect(score!).toBeGreaterThanOrEqual(0); + expect(score!).toBeLessThanOrEqual(1); + }); + + it("ranks a nearer euclidean_squared hit above a farther one", async () => { + mockQuery.mockResolvedValueOnce({ + rows: [ + { id: "near", $dist: 1.0 }, + { id: "far", $dist: 9.0 }, + ], + }); + const results = await makeStore("euclidean_squared").search( + [0.1, 0.2, 0.3], + 5, + ); + const near = results.find((r) => r.id === "near")!; + const far = results.find((r) => r.id === "far")!; + expect(near.score!).toBeGreaterThan(far.score!); + }); + + it("preserves an undefined score when the row has no distance", async () => { + expect(await scoreFor("euclidean_squared", { id: "a" })).toBeUndefined(); + }); +}); From 8127e8bd47a8f5b6eabd178c0637e72621b9b976 Mon Sep 17 00:00:00 2001 From: Yash Singh <123385188+yashs33244@users.noreply.github.com> Date: Fri, 25 Sep 2026 17:08:20 +0530 Subject: [PATCH 39/55] fix(vector_stores/turbopuffer): make search score respect distance_metric (#6559) --- mem0/vector_stores/turbopuffer.py | 9 +++++++- tests/vector_stores/test_turbopuffer.py | 29 +++++++++++++++++++++++++ 2 files changed, 37 insertions(+), 1 deletion(-) diff --git a/mem0/vector_stores/turbopuffer.py b/mem0/vector_stores/turbopuffer.py index 76281fc96..97109704f 100644 --- a/mem0/vector_stores/turbopuffer.py +++ b/mem0/vector_stores/turbopuffer.py @@ -122,7 +122,14 @@ class TurbopufferDB(VectorStoreBase): dist = row_dict.pop("$dist", None) row_dict.pop("vector", None) - score = 1 - dist if dist is not None else None + if dist is None: + score = None + elif self.distance_metric == "euclidean_squared": + # $dist is unbounded squared-L2 (lower = closer); map to a bounded + # higher-is-better score, mirroring milvus/baidu. Cosine returns 1 - dist. + score = 1.0 / (1.0 + dist) + else: + score = 1 - dist results.append(OutputData( id=row_id, diff --git a/tests/vector_stores/test_turbopuffer.py b/tests/vector_stores/test_turbopuffer.py index e1b9233bb..df0670570 100644 --- a/tests/vector_stores/test_turbopuffer.py +++ b/tests/vector_stores/test_turbopuffer.py @@ -232,6 +232,35 @@ class TestParseOutput: def test_parse_empty_rows(self, db): assert db._parse_output([]) == [] + def test_parse_cosine_score_is_one_minus_dist(self, db): + # Default cosine metric: score = 1 - dist, unchanged by the metric fix. + results = db._parse_output([_make_row("id1", dist=0.25)]) + assert results[0].score == pytest.approx(0.75) + + def test_parse_euclidean_squared_score_is_bounded(self, mock_client): + # euclidean_squared $dist is unbounded (e.g. 4.0). 1 - dist would give -3.0, + # violating the higher-is-better contract; map it to 1/(1+dist) instead. + db = TurbopufferDB( + collection_name="test_ns", + embedding_model_dims=4, + api_key="tpuf_test_key", + region="gcp-us-central1", + distance_metric="euclidean_squared", + ) + results = db._parse_output([_make_row("id1", dist=4.0)]) + assert results[0].score == pytest.approx(0.2) + assert 0.0 <= results[0].score <= 1.0 + + def test_parse_euclidean_squared_preserves_none(self, mock_client): + db = TurbopufferDB( + collection_name="test_ns", + embedding_model_dims=4, + api_key="tpuf_test_key", + region="gcp-us-central1", + distance_metric="euclidean_squared", + ) + assert db._parse_output([_make_row("id1")])[0].score is None + # ── _convert_filters ───────────────────────────────────────────────── From 947ac798183dfbac7c3c0f37478e13fa5f17e91d Mon Sep 17 00:00:00 2001 From: Kartik Date: Fri, 25 Sep 2026 20:46:24 +0530 Subject: [PATCH 40/55] fix(ts-sdk): stop forcing pg on installs (optional ranged pg peer, optional natural) (#7450) --- docs/components/vectordbs/dbs/pgvector.mdx | 6 +++ mem0-ts/package.json | 17 +++++-- mem0-ts/pnpm-lock.yaml | 48 +++---------------- mem0-ts/src/oss/src/vector_stores/pgvector.ts | 40 +++++++++++----- .../oss/tests/missing-optional-peers.test.ts | 39 +++++++++++++++ 5 files changed, 93 insertions(+), 57 deletions(-) create mode 100644 mem0-ts/src/oss/tests/missing-optional-peers.test.ts diff --git a/docs/components/vectordbs/dbs/pgvector.mdx b/docs/components/vectordbs/dbs/pgvector.mdx index f322a0a95..ddd36c416 100644 --- a/docs/components/vectordbs/dbs/pgvector.mdx +++ b/docs/components/vectordbs/dbs/pgvector.mdx @@ -5,6 +5,12 @@ description: "Use pgvector as a vector store in Mem0 for PostgreSQL-based vector [pgvector](https://github.com/pgvector/pgvector) is an open-source vector similarity search extension for Postgres. After connecting to Postgres, run `CREATE EXTENSION IF NOT EXISTS vector;` to create the vector extension. +The TypeScript SDK loads the `pg` driver only when you use this store, so install it alongside `mem0ai`: + +```bash +npm install pg +``` + ### Usage diff --git a/mem0-ts/package.json b/mem0-ts/package.json index 3bb996079..e6f29d4cb 100644 --- a/mem0-ts/package.json +++ b/mem0-ts/package.json @@ -100,7 +100,8 @@ "tsup": "^8.3.0", "typescript": "5.5.4", "iovalkey": "^0.3.3", - "@mochow/mochow-sdk-node": "^2.1.5" + "@mochow/mochow-sdk-node": "^2.1.5", + "@types/jest": "^29.5.14" }, "dependencies": { "axios": "^1.18.0", @@ -127,8 +128,7 @@ "@qdrant/js-client-rest": "^1.18.0", "@supabase/supabase-js": "^2.49.1", "@turbopuffer/turbopuffer": "^2.0.0", - "@types/jest": "29.5.14", - "@types/pg": "8.11.0", + "@types/pg": "^8.11.0", "@upstash/vector": "^1.2.3", "better-sqlite3": "^12.6.2", "cassandra-driver": "4.8.0", @@ -141,7 +141,7 @@ "weaviate-client": "^3.0.0", "ollama": "^0.5.14", "oracledb": "^6.5.0 || ^7.0.0", - "pg": "8.11.3", + "pg": "^8.11.3", "redis": "^4.6.13", "@elastic/elasticsearch": "^9.0.0", "iovalkey": "^0.3.3", @@ -257,6 +257,15 @@ }, "oracledb": { "optional": true + }, + "pg": { + "optional": true + }, + "@types/pg": { + "optional": true + }, + "natural": { + "optional": true } }, "engines": { diff --git a/mem0-ts/pnpm-lock.yaml b/mem0-ts/pnpm-lock.yaml index 5deb30e7b..5e04cbfdd 100644 --- a/mem0-ts/pnpm-lock.yaml +++ b/mem0-ts/pnpm-lock.yaml @@ -109,11 +109,8 @@ importers: '@turbopuffer/turbopuffer': specifier: ^2.0.0 version: 2.5.0 - '@types/jest': - specifier: 29.5.14 - version: 29.5.14 '@types/pg': - specifier: 8.11.0 + specifier: ^8.11.0 version: 8.11.0 '@upstash/vector': specifier: ^1.2.3 @@ -167,8 +164,8 @@ importers: specifier: ^6.5.0 || ^7.0.0 version: 7.0.1 pg: - specifier: 8.11.3 - version: 8.11.3 + specifier: ^8.11.3 + version: 8.21.0 redis: specifier: ^4.6.13 version: 4.7.1 @@ -191,6 +188,9 @@ importers: '@types/better-sqlite3': specifier: ^7.6.13 version: 7.6.13 + '@types/jest': + specifier: ^29.5.14 + version: 29.5.14 '@types/node': specifier: ^22.7.6 version: 22.19.21 @@ -2228,10 +2228,6 @@ packages: buffer-from@1.1.2: resolution: {integrity: sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==} - buffer-writer@2.0.0: - resolution: {integrity: sha512-a7ZpuTZU1TRtnwyCNW3I5dc0wWNC3VR9S++Ewyk2HHZdrO3CQJqSpd+95Us590V6AL7JqUAH2IwZ/398PmNFgw==} - engines: {node: '>=4'} - buffer@5.7.1: resolution: {integrity: sha512-EHcyIPBQ4BSGlvjB16k5KgAJ27CIsHY/2JBmCRReo48y9rQ3MaUzWX3KVlBa4U7MyX02HdVj0K7C3WaB3ju7FQ==} @@ -3846,9 +3842,6 @@ packages: package-json-from-dist@1.0.1: resolution: {integrity: sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==} - packet-reader@1.0.0: - resolution: {integrity: sha512-HAKu/fG3HpHFO0AA8WE8q2g+gBJaZ9MG7fcKk+IJPLTGAD6Psw4443l+9DGRbOIh3/aXr7Phy0TjilYivJo5XQ==} - pad-left@2.1.0: resolution: {integrity: sha512-HJxs9K9AztdIQIAIa/OIazRAUW/L6B9hbQDxO4X07roW3eo9XqZc2ur9bn1StH9CnbbI9EgvejHQX7CBpCF1QA==} engines: {node: '>=0.10.0'} @@ -3920,15 +3913,6 @@ packages: resolution: {integrity: sha512-o2XFanIMy/3+mThw69O8d4n1E5zsLhdO+OPqswezu7Z5ekP4hYDqlDjlmOpYMbzY2Br0ufCwJLdDIXeNVwcWFg==} engines: {node: '>=10'} - pg@8.11.3: - resolution: {integrity: sha512-+9iuvG8QfaaUrrph+kpF24cXkH1YOOUeArRNYIxq1viYHZagBxrTno7cecY1Fa44tJeZvaoG+Djpkc3JwehN5g==} - engines: {node: '>= 8.0.0'} - peerDependencies: - pg-native: '>=3.0.1' - peerDependenciesMeta: - pg-native: - optional: true - pg@8.21.0: resolution: {integrity: sha512-AUP1EYJuHraQGsVoCQVIcM7TEJVGtDzxWtGFZd8rds9d+CCXlU5Js1rYgfLNvxy9iJrpHjGrRjoi/3BT9fRyiA==} engines: {node: '>= 16.0.0'} @@ -7593,8 +7577,6 @@ snapshots: buffer-from@1.1.2: {} - buffer-writer@2.0.0: {} - buffer@5.7.1: dependencies: base64-js: 1.5.1 @@ -9409,8 +9391,6 @@ snapshots: package-json-from-dist@1.0.1: {} - packet-reader@1.0.0: {} - pad-left@2.1.0: dependencies: repeat-string: 1.6.1 @@ -9458,10 +9438,6 @@ snapshots: pg-numeric@1.0.2: {} - pg-pool@3.14.0(pg@8.11.3): - dependencies: - pg: 8.11.3 - pg-pool@3.14.0(pg@8.21.0): dependencies: pg: 8.21.0 @@ -9486,18 +9462,6 @@ snapshots: postgres-interval: 3.0.0 postgres-range: 1.1.4 - pg@8.11.3: - dependencies: - buffer-writer: 2.0.0 - packet-reader: 1.0.0 - pg-connection-string: 2.13.0 - pg-pool: 3.14.0(pg@8.11.3) - pg-protocol: 1.14.0 - pg-types: 2.2.0 - pgpass: 1.0.5 - optionalDependencies: - pg-cloudflare: 1.4.0 - pg@8.21.0: dependencies: pg-connection-string: 2.13.0 diff --git a/mem0-ts/src/oss/src/vector_stores/pgvector.ts b/mem0-ts/src/oss/src/vector_stores/pgvector.ts index 450ffc9a5..b7f2c2f69 100644 --- a/mem0-ts/src/oss/src/vector_stores/pgvector.ts +++ b/mem0-ts/src/oss/src/vector_stores/pgvector.ts @@ -1,8 +1,11 @@ import type { Client as ClientType, ClientConfig } from "pg"; -import pkg from "pg"; -const { Client, escapeIdentifier } = pkg; import { VectorStore } from "./base"; import { SearchFilters, VectorStoreConfig, VectorStoreResult } from "../types"; +import { loadPeer } from "../utils/load_peer"; + +function escapeIdentifier(name: string): string { + return `"${name.replace(/"/g, '""')}"`; +} const SAFE_IDENTIFIER_RE = /^[a-zA-Z_][a-zA-Z0-9_]{0,127}$/; @@ -212,7 +215,7 @@ function buildClientConfig( } export class PGVector implements VectorStore { - private client: ClientType; + private client!: ClientType; private collectionName: string; private useDiskann: boolean; private useHnsw: boolean; @@ -234,13 +237,6 @@ export class PGVector implements VectorStore { ? "" : validateIdentifier(config.dbname || "vector_store", "dbname"); this.config = config; - - this.client = new Client( - buildClientConfig( - config, - this.useDirectConnection ? undefined : "postgres", - ), - ); this.initialize().catch(console.error); } @@ -257,6 +253,18 @@ export class PGVector implements VectorStore { private async _doInitialize(): Promise { try { + const pg = await loadPeer( + "pg", + "PGVector vector store", + () => import("pg"), + ); + const { Client } = pg.default ?? pg; + this.client = new Client( + buildClientConfig( + this.config, + this.useDirectConnection ? undefined : "postgres", + ), + ); await this.client.connect(); if (!this.useDirectConnection) { @@ -345,6 +353,7 @@ export class PGVector implements VectorStore { ids: string[], payloads: Record[], ): Promise { + await this.initialize(); const values = vectors.map((vector, i) => ({ id: ids[i], vector: `[${vector.join(",")}]`, @@ -368,6 +377,7 @@ export class PGVector implements VectorStore { topK: number = 5, filters?: SearchFilters, ): Promise { + await this.initialize(); try { const { conditions, @@ -406,6 +416,7 @@ export class PGVector implements VectorStore { topK: number = 5, filters?: SearchFilters, ): Promise { + await this.initialize(); const queryVector = `[${query.join(",")}]`; const { conditions, @@ -435,6 +446,7 @@ export class PGVector implements VectorStore { } async get(vectorId: string): Promise { + await this.initialize(); const result = await this.client.query( `SELECT id, payload FROM ${this.col()} WHERE id = $1`, [vectorId], @@ -453,6 +465,7 @@ export class PGVector implements VectorStore { vector: number[], payload: Record, ): Promise { + await this.initialize(); const vectorStr = `[${vector.join(",")}]`; await this.client.query( ` @@ -465,12 +478,14 @@ export class PGVector implements VectorStore { } async delete(vectorId: string): Promise { + await this.initialize(); await this.client.query(`DELETE FROM ${this.col()} WHERE id = $1`, [ vectorId, ]); } async deleteCol(): Promise { + await this.initialize(); await this.client.query(`DROP TABLE IF EXISTS ${this.col()}`); } @@ -487,6 +502,7 @@ export class PGVector implements VectorStore { filters?: SearchFilters, topK: number = 100, ): Promise<[VectorStoreResult[], number]> { + await this.initialize(); const { conditions, values: filterValues, @@ -525,10 +541,11 @@ export class PGVector implements VectorStore { } async close(): Promise { - await this.client.end(); + await this.client?.end(); } async getUserId(): Promise { + await this.initialize(); const result = await this.client.query( "SELECT user_id FROM memory_migrations LIMIT 1", ); @@ -549,6 +566,7 @@ export class PGVector implements VectorStore { } async setUserId(userId: string): Promise { + await this.initialize(); await this.client.query("DELETE FROM memory_migrations"); await this.client.query( "INSERT INTO memory_migrations (user_id) VALUES ($1)", diff --git a/mem0-ts/src/oss/tests/missing-optional-peers.test.ts b/mem0-ts/src/oss/tests/missing-optional-peers.test.ts new file mode 100644 index 000000000..910849c55 --- /dev/null +++ b/mem0-ts/src/oss/tests/missing-optional-peers.test.ts @@ -0,0 +1,39 @@ +jest.mock("pg", () => { + throw new Error("Cannot find module 'pg'"); +}); + +jest.mock("natural", () => { + throw new Error("Cannot find module 'natural'"); +}); + +describe("mem0ai/oss without pg or natural installed", () => { + beforeEach(() => { + jest.spyOn(console, "error").mockImplementation(() => {}); + }); + + afterEach(() => { + jest.restoreAllMocks(); + }); + + test("mem0ai/oss loads", async () => { + await expect(import("../src")).resolves.toHaveProperty("Memory"); + }); + + test("PGVector explains how to install pg", async () => { + const { PGVector } = await import("../src/vector_stores/pgvector"); + const store = new PGVector({ + connectionString: "postgresql://localhost:5432/db", + embeddingModelDims: 3, + } as any); + + await expect(store.initialize()).rejects.toThrow( + "The 'pg' package is required to use the PGVector vector store. Install it with: npm install pg", + ); + }); + + test("BM25 lemmatization falls back to the built-in stemmer", async () => { + const { lemmatizeForBm25 } = await import("../src/utils/lemmatization"); + + expect(lemmatizeForBm25("The dogs were running")).toBe("dog runn running"); + }); +}); From 94c3fe9f238f3dbf29c9ce98643bd71eb13077cd Mon Sep 17 00:00:00 2001 From: Kartik Date: Fri, 25 Sep 2026 23:04:12 +0530 Subject: [PATCH 41/55] chore(release): bump Python SDK to 2.2.1 and TypeScript SDK to 3.3.1 (#7456) --- docs/changelog/sdk.mdx | 22 ++++++++++++++ mem0-ts/package.json | 2 +- .../src/oss/tests/turbopuffer.score.test.ts | 22 ++++++-------- .../src/oss/tests/turbopuffer.unit.test.ts | 29 ++++++++----------- pyproject.toml | 2 +- 5 files changed, 45 insertions(+), 32 deletions(-) diff --git a/docs/changelog/sdk.mdx b/docs/changelog/sdk.mdx index 5598d0d96..14c9c014d 100644 --- a/docs/changelog/sdk.mdx +++ b/docs/changelog/sdk.mdx @@ -7,6 +7,18 @@ mode: "wide" + + +**Bug Fixes:** +- **Core:** `add()` (`Memory` and `AsyncMemory`) no longer reports records the vector store rejected as successful `ADD` events. Only records that were actually inserted are written to history, entity-linked, and returned. If none of the extracted memories could be inserted, `add()` now raises `VectorStoreError` instead of returning memories that were never stored ([#7066](https://github.com/mem0ai/mem0/pull/7066)) +- **Core:** Restore the context-manager protocol on `Memory` (`with Memory() as m:`) and `AsyncMemory` (`async with AsyncMemory() as m:`), which closes the instance on exit ([#7354](https://github.com/mem0ai/mem0/pull/7354)) +- **LLMs:** The AWS Bedrock Anthropic path now returns the first Converse content block that carries text instead of always reading `content[0]`. Claude reasoning models can emit a `reasoningContent` block before the text block, which previously made the call fail with a `KeyError` ([#6369](https://github.com/mem0ai/mem0/pull/6369)) +- **Vector Stores:** Turbopuffer filters now apply every operator (`eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `nin`). Only `gte` and `lte` were read before, so any other operator was silently dropped and the query returned unfiltered results. An unsupported operator now raises `ValueError` ([#6564](https://github.com/mem0ai/mem0/pull/6564)) +- **Vector Stores:** Turbopuffer `search()` scores now respect `distance_metric`. With `euclidean_squared`, the unbounded squared distance maps to `1 / (1 + distance)` instead of `1 - distance`, which went negative and inverted ranking for any distance above 1 ([#6559](https://github.com/mem0ai/mem0/pull/6559)) +- **Vector Stores:** S3 Vectors `search()` scores are now metric-aware. With `euclidean`, the distance maps to `1 / (1 + distance)` instead of `max(0, 1 - distance)`, which collapsed most scores to 0 ([#6547](https://github.com/mem0ai/mem0/pull/6547)) + + + **New Features:** @@ -1245,6 +1257,16 @@ See the [OSS v2 to v3 migration guide](https://docs.mem0.ai/migration/oss-v2-to- + + +**Bug Fixes:** +- **Config (OSS):** `ConfigManager` no longer injects OpenAI's default `baseURL` and `model` into non-OpenAI LLM providers. The defaults now apply only to `openai` and `openai_structured`, so a DeepSeek, xAI, or other provider config without an explicit `baseURL` or `model` falls back to that provider's own defaults and env vars (`DEEPSEEK_API_BASE`, `XAI_API_BASE`, ...) instead of pointing at OpenAI with an OpenAI model name ([#7350](https://github.com/mem0ai/mem0/pull/7350)) +- **Vector Stores:** Turbopuffer filters now apply every operator (`eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `nin`). Only the range operators were read before, so `eq`, `ne`, `in`, and `nin` were silently dropped. A `"*"` value now matches anything instead of nothing, an array value is treated as `in`, and an unsupported operator throws ([#6578](https://github.com/mem0ai/mem0/pull/6578)) +- **Vector Stores:** Turbopuffer `search()` with `euclidean_squared` now maps the unbounded squared distance to `1 / (1 + distance)` instead of `1 - distance`, which went negative and inverted ranking for any distance above 1 ([#6580](https://github.com/mem0ai/mem0/pull/6580)) +- **Packaging:** `pg`, `@types/pg`, and `natural` are now optional peer dependencies, and `pg` / `@types/pg` accept caret ranges instead of the exact `8.11.3` / `8.11.0` pins, so installing `mem0ai` no longer pulls in `pg` or conflicts with an app's own `pg` version. The PGVector store now imports `pg` only when it is used, so install it alongside `mem0ai` (`npm install pg`) if you use that store. `@types/jest` moved from peer dependencies to dev dependencies ([#7450](https://github.com/mem0ai/mem0/pull/7450)) + + + **New Features:** diff --git a/mem0-ts/package.json b/mem0-ts/package.json index e6f29d4cb..b03a73485 100644 --- a/mem0-ts/package.json +++ b/mem0-ts/package.json @@ -1,6 +1,6 @@ { "name": "mem0ai", - "version": "3.3.0", + "version": "3.3.1", "description": "The Memory Layer For Your AI Apps", "main": "./dist/index.js", "module": "./dist/index.mjs", diff --git a/mem0-ts/src/oss/tests/turbopuffer.score.test.ts b/mem0-ts/src/oss/tests/turbopuffer.score.test.ts index b6e8ba844..31db83ce3 100644 --- a/mem0-ts/src/oss/tests/turbopuffer.score.test.ts +++ b/mem0-ts/src/oss/tests/turbopuffer.score.test.ts @@ -2,24 +2,20 @@ /** * Turbopuffer vector store — score conversion unit tests. * - * Drives parseRows() through the public search() API with a virtually-mocked + * Drives parseRows() through the public search() API with a mocked * @turbopuffer/turbopuffer peer, asserting the score returned per metric. */ const mockQuery = jest.fn(); -jest.mock( - "@turbopuffer/turbopuffer", - () => ({ - __esModule: true, - default: class { - namespace() { - return { query: mockQuery }; - } - }, - }), - { virtual: true }, -); +jest.mock("@turbopuffer/turbopuffer", () => ({ + __esModule: true, + default: class { + namespace() { + return { query: mockQuery }; + } + }, +})); import { TurbopufferDB } from "../src/vector_stores/turbopuffer"; diff --git a/mem0-ts/src/oss/tests/turbopuffer.unit.test.ts b/mem0-ts/src/oss/tests/turbopuffer.unit.test.ts index 5dcec9f05..c781f3ebb 100644 --- a/mem0-ts/src/oss/tests/turbopuffer.unit.test.ts +++ b/mem0-ts/src/oss/tests/turbopuffer.unit.test.ts @@ -3,27 +3,22 @@ * Turbopuffer vector store — filter translation unit tests. * * Drives the private convertFilters() through the public search() API with a - * virtually-mocked @turbopuffer/turbopuffer peer, and asserts the filter tuple - * handed to ns.query(). + * mocked @turbopuffer/turbopuffer peer, and asserts the filter tuple handed to + * ns.query(). */ const mockQuery = jest.fn().mockResolvedValue({ rows: [] }); -// The peer is an optional dependency and may not be installed; mock it -// virtually. createClient() does `new sdk.default({...})`, whose namespace() -// returns the object search() calls query() on. -jest.mock( - "@turbopuffer/turbopuffer", - () => ({ - __esModule: true, - default: class { - namespace() { - return { query: mockQuery }; - } - }, - }), - { virtual: true }, -); +// createClient() does `new sdk.default({...})`, whose namespace() returns the +// object search() calls query() on. +jest.mock("@turbopuffer/turbopuffer", () => ({ + __esModule: true, + default: class { + namespace() { + return { query: mockQuery }; + } + }, +})); import { TurbopufferDB } from "../src/vector_stores/turbopuffer"; diff --git a/pyproject.toml b/pyproject.toml index b16a6c0db..c6c1f38d3 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "hatchling.build" [project] name = "mem0ai" -version = "2.2.0" +version = "2.2.1" description = "Long-term memory for AI Agents" authors = [ { name = "Mem0", email = "support@mem0.ai" } From abb81c88e1f738a8117d8293530fbc31a5ef8fd9 Mon Sep 17 00:00:00 2001 From: Harsh Vardhan Gupta Date: Thu, 1 Oct 2026 21:46:18 +0530 Subject: [PATCH 42/55] fix(security): resolve 7 Vanta MEDIUM Dependabot vulnerabilities (undici, ip-address, adm-zip) (#7510) Co-authored-by: Claude Opus 5.5 --- integrations/openclaw/package.json | 2 +- integrations/openclaw/pnpm-lock.yaml | 10 +++--- integrations/openclaw/pnpm-workspace.yaml | 2 +- integrations/pi-agent-plugin/package.json | 4 +-- integrations/pi-agent-plugin/pnpm-lock.yaml | 20 +++++------ .../pi-agent-plugin/pnpm-workspace.yaml | 4 +-- mem0-ts/package.json | 6 ++-- mem0-ts/pnpm-lock.yaml | 36 +++++++++---------- mem0-ts/pnpm-workspace.yaml | 6 ++-- 9 files changed, 45 insertions(+), 45 deletions(-) diff --git a/integrations/openclaw/package.json b/integrations/openclaw/package.json index 39aaeb70e..df01be01a 100644 --- a/integrations/openclaw/package.json +++ b/integrations/openclaw/package.json @@ -72,7 +72,7 @@ "@qdrant/js-client-rest": "^1.18.0", "uuid@<11.1.1": ">=11.1.1", "esbuild": ">=0.28.1", - "undici@<7.29.0": ">=7.29.0 <8.0.0", + "undici@<7.29.1": ">=7.29.1 <8.0.0", "axios@<1.18.0": ">=1.18.0 <2.0.0", "postcss@<8.5.18": ">=8.5.18 <9.0.0", "mongoose@>=9.0.0 <9.7.2": ">=9.7.2 <10.0.0" diff --git a/integrations/openclaw/pnpm-lock.yaml b/integrations/openclaw/pnpm-lock.yaml index 79dd0d10a..6e8729d46 100644 --- a/integrations/openclaw/pnpm-lock.yaml +++ b/integrations/openclaw/pnpm-lock.yaml @@ -13,7 +13,7 @@ overrides: '@qdrant/js-client-rest': ^1.18.0 uuid@<11.1.1: '>=11.1.1' esbuild: '>=0.28.1' - undici@<7.29.0: '>=7.29.0 <8.0.0' + undici@<7.29.1: '>=7.29.1 <8.0.0' axios@<1.18.0: '>=1.18.0 <2.0.0' postcss@<8.5.18: '>=8.5.18 <9.0.0' mongoose@>=9.0.0 <9.7.2: '>=9.7.2 <10.0.0' @@ -2036,8 +2036,8 @@ packages: undici-types@6.21.0: resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==} - undici@7.29.0: - resolution: {integrity: sha512-IDxfleLmmbSskfWSUATiN1nfn2rDuvnMOqb5CWR92iIfojA0Ud+ulOAAEQ57LPr9rWmsreUyf5lwyao+7GNNVw==} + undici@7.30.0: + resolution: {integrity: sha512-dkrQXeHSaoamnItlYbmzG0wFYrM0ZwDxCIg0A7aKjTyyhh9svRzCNFEzV+Vm05/yehjCzjDZ31KXfGEjYSztDQ==} engines: {node: '>=20.18.1'} util-deprecate@1.0.2: @@ -2547,7 +2547,7 @@ snapshots: dependencies: '@qdrant/openapi-typescript-fetch': 1.2.6 typescript: 5.9.3 - undici: 7.29.0 + undici: 7.30.0 '@qdrant/openapi-typescript-fetch@1.2.6': {} @@ -4121,7 +4121,7 @@ snapshots: undici-types@6.21.0: {} - undici@7.29.0: {} + undici@7.30.0: {} util-deprecate@1.0.2: {} diff --git a/integrations/openclaw/pnpm-workspace.yaml b/integrations/openclaw/pnpm-workspace.yaml index 0f9f833bc..34e812fa8 100644 --- a/integrations/openclaw/pnpm-workspace.yaml +++ b/integrations/openclaw/pnpm-workspace.yaml @@ -21,7 +21,7 @@ overrides: "@qdrant/js-client-rest": "^1.18.0" "uuid@<11.1.1": ">=11.1.1" "esbuild": ">=0.28.1" - "undici@<7.29.0": ">=7.29.0 <8.0.0" + "undici@<7.29.1": ">=7.29.1 <8.0.0" "axios@<1.18.0": ">=1.18.0 <2.0.0" "postcss@<8.5.18": ">=8.5.18 <9.0.0" "mongoose@>=9.0.0 <9.7.2": ">=9.7.2 <10.0.0" diff --git a/integrations/pi-agent-plugin/package.json b/integrations/pi-agent-plugin/package.json index fbec4db1b..56952c42f 100644 --- a/integrations/pi-agent-plugin/package.json +++ b/integrations/pi-agent-plugin/package.json @@ -72,8 +72,8 @@ "form-data@<4.0.6": ">=4.0.6", "uuid@<11.1.1": ">=11.1.1", "esbuild": ">=0.28.1", - "undici@<7.29.0": ">=7.29.0 <8.0.0", - "undici@>=8.0.0 <8.9.0": ">=8.9.0 <9.0.0", + "undici@<7.29.1": ">=7.29.1 <8.0.0", + "undici@>=8.0.0 <8.10.2": ">=8.10.2 <9.0.0", "axios@<1.18.0": ">=1.18.0 <2.0.0", "brace-expansion@>=3.0.0 <5.0.8": ">=5.0.8 <6.0.0", "postcss@<8.5.18": ">=8.5.18 <9.0.0", diff --git a/integrations/pi-agent-plugin/pnpm-lock.yaml b/integrations/pi-agent-plugin/pnpm-lock.yaml index 177023505..0a4100fc8 100644 --- a/integrations/pi-agent-plugin/pnpm-lock.yaml +++ b/integrations/pi-agent-plugin/pnpm-lock.yaml @@ -8,8 +8,8 @@ overrides: form-data@<4.0.6: '>=4.0.6' uuid@<11.1.1: '>=11.1.1' esbuild: '>=0.28.1' - undici@<7.29.0: '>=7.29.0 <8.0.0' - undici@>=8.0.0 <8.9.0: '>=8.9.0 <9.0.0' + undici@<7.29.1: '>=7.29.1 <8.0.0' + undici@>=8.0.0 <8.10.2: '>=8.10.2 <9.0.0' axios@<1.18.0: '>=1.18.0 <2.0.0' brace-expansion@>=3.0.0 <5.0.8: '>=5.0.8 <6.0.0' postcss@<8.5.18: '>=8.5.18 <9.0.0' @@ -2354,12 +2354,12 @@ packages: undici-types@7.24.6: resolution: {integrity: sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==} - undici@7.29.0: - resolution: {integrity: sha512-IDxfleLmmbSskfWSUATiN1nfn2rDuvnMOqb5CWR92iIfojA0Ud+ulOAAEQ57LPr9rWmsreUyf5lwyao+7GNNVw==} + undici@7.30.0: + resolution: {integrity: sha512-dkrQXeHSaoamnItlYbmzG0wFYrM0ZwDxCIg0A7aKjTyyhh9svRzCNFEzV+Vm05/yehjCzjDZ31KXfGEjYSztDQ==} engines: {node: '>=20.18.1'} - undici@8.10.0: - resolution: {integrity: sha512-HvltHd7avK13QIw/oLe4qoOLyoVSoafqJ2jYOrtMRBkbYT31eiBQ8O0ehRKZiEZCMEyLFQNIADpgCWC5fALvYQ==} + undici@8.11.2: + resolution: {integrity: sha512-u4UB2/IrKdU6lFxumHmmo1a3fCQO5tzQllRorfoRS63txhrB7xTpSn1PftwC4qEHkOaqP95fCWW4lJzwErwzhQ==} engines: {node: '>=22.19.0'} util-deprecate@1.0.2: @@ -2942,7 +2942,7 @@ snapshots: minimatch: 10.2.5 proper-lockfile: 4.1.2 typebox: 1.1.38 - undici: 8.10.0 + undici: 8.11.2 yaml: 2.9.0 optionalDependencies: '@mariozechner/clipboard': 0.3.9 @@ -3203,7 +3203,7 @@ snapshots: dependencies: '@qdrant/openapi-typescript-fetch': 1.2.6 typescript: 6.0.3 - undici: 7.29.0 + undici: 7.30.0 '@qdrant/openapi-typescript-fetch@1.2.6': {} @@ -4895,9 +4895,9 @@ snapshots: undici-types@7.24.6: {} - undici@7.29.0: {} + undici@7.30.0: {} - undici@8.10.0: {} + undici@8.11.2: {} util-deprecate@1.0.2: {} diff --git a/integrations/pi-agent-plugin/pnpm-workspace.yaml b/integrations/pi-agent-plugin/pnpm-workspace.yaml index 283b117cc..071ea6a55 100644 --- a/integrations/pi-agent-plugin/pnpm-workspace.yaml +++ b/integrations/pi-agent-plugin/pnpm-workspace.yaml @@ -5,8 +5,8 @@ overrides: "form-data@<4.0.6": ">=4.0.6" "uuid@<11.1.1": ">=11.1.1" "esbuild": ">=0.28.1" - "undici@<7.29.0": ">=7.29.0 <8.0.0" - "undici@>=8.0.0 <8.9.0": ">=8.9.0 <9.0.0" + "undici@<7.29.1": ">=7.29.1 <8.0.0" + "undici@>=8.0.0 <8.10.2": ">=8.10.2 <9.0.0" "axios@<1.18.0": ">=1.18.0 <2.0.0" "brace-expansion@>=3.0.0 <5.0.8": ">=5.0.8 <6.0.0" "postcss@<8.5.18": ">=8.5.18 <9.0.0" diff --git a/mem0-ts/package.json b/mem0-ts/package.json index b03a73485..c34192188 100644 --- a/mem0-ts/package.json +++ b/mem0-ts/package.json @@ -288,7 +288,7 @@ "js-yaml@<3.15.1": ">=3.15.1 <4.0.0", "js-yaml@>=4.0.0 <4.3.1": ">=4.3.1 <5.0.0", "sharp@<0.35.0": ">=0.35.0 <0.36.0", - "adm-zip@<0.6.0": ">=0.6.0 <0.7.0", + "adm-zip@<0.6.1": ">=0.6.1 <0.7.0", "langsmith@<0.6.0": "^0.6.0", "minimatch@<3.1.3": "^3.1.3", "minimatch@>=5.0.0 <5.1.8": "^5.1.8", @@ -303,7 +303,7 @@ "glob@>=10.2.0 <10.5.0": "^10.5.0", "@modelcontextprotocol/sdk": "^1.25.4", "esbuild": ">=0.28.1", - "undici@<7.29.0": ">=7.29.0 <8.0.0", + "undici@<7.29.1": ">=7.29.1 <8.0.0", "@aws-sdk/client-bedrock-runtime": "3.967.0", "@aws-sdk/client-neptune-graph": "3.966.0", "axios@<1.18.0": ">=1.18.0 <2.0.0", @@ -315,7 +315,7 @@ "thrift@<0.23.0": "^0.23.0", "mongoose@>=9.0.0 <9.7.2": ">=9.7.2 <10.0.0", "protobufjs@<7.6.5": ">=7.6.5 <8.0.0", - "ip-address@<10.3.1": ">=10.3.1 <11.0.0", + "ip-address@<10.5.1": ">=10.5.1 <11.0.0", "browserslist@<4.28.7": ">=4.28.7 <5.0.0", "mysql2@<3.23.1": ">=3.23.1 <4.0.0" } diff --git a/mem0-ts/pnpm-lock.yaml b/mem0-ts/pnpm-lock.yaml index 5e04cbfdd..27e0811f7 100644 --- a/mem0-ts/pnpm-lock.yaml +++ b/mem0-ts/pnpm-lock.yaml @@ -12,7 +12,7 @@ overrides: js-yaml@<3.15.1: '>=3.15.1 <4.0.0' js-yaml@>=4.0.0 <4.3.1: '>=4.3.1 <5.0.0' sharp@<0.35.0: '>=0.35.0 <0.36.0' - adm-zip@<0.6.0: '>=0.6.0 <0.7.0' + adm-zip@<0.6.1: '>=0.6.1 <0.7.0' langsmith@<0.6.0: ^0.6.0 minimatch@<3.1.3: ^3.1.3 minimatch@>=5.0.0 <5.1.8: ^5.1.8 @@ -27,7 +27,7 @@ overrides: glob@>=10.2.0 <10.5.0: ^10.5.0 '@modelcontextprotocol/sdk': ^1.25.4 esbuild: '>=0.28.1' - undici@<7.29.0: '>=7.29.0 <8.0.0' + undici@<7.29.1: '>=7.29.1 <8.0.0' '@aws-sdk/client-bedrock-runtime': 3.967.0 '@aws-sdk/client-neptune-graph': 3.966.0 axios@<1.18.0: '>=1.18.0 <2.0.0' @@ -39,7 +39,7 @@ overrides: thrift@<0.23.0: ^0.23.0 mongoose@>=9.0.0 <9.7.2: '>=9.7.2 <10.0.0' protobufjs@<7.6.5: '>=7.6.5 <8.0.0' - ip-address@<10.3.1: '>=10.3.1 <11.0.0' + ip-address@<10.5.1: '>=10.5.1 <11.0.0' browserslist@<4.28.7: '>=4.28.7 <5.0.0' mysql2@<3.23.1: '>=3.23.1 <4.0.0' @@ -2009,8 +2009,8 @@ packages: engines: {node: '>=0.4.0'} hasBin: true - adm-zip@0.6.0: - resolution: {integrity: sha512-XleryMhbuksdKtofnWZ9Sk+4CUTbms4Mb/EU32SZwToAyZ5RgVos/ki8n+yr0LWHOGKuakbXTuuYNHLQjhddgg==} + adm-zip@0.6.1: + resolution: {integrity: sha512-Xwrja8nx9e5o2N1my4DsKCeKpdrnACyr1wtbPxBDgGzKzKyE9kRtBFA8mWldI+RVlD7CBZNWY/wQ2+ydwOR6kQ==} engines: {node: '>=14.0'} afinn-165-financialmarketnews@3.0.0: @@ -3034,8 +3034,8 @@ packages: resolution: {integrity: sha512-4rTJX6Q5wTYEvxboXi8DsEiUo+OvqJGtLYOSGm37KpdRXsG5XJjbVtYKGJpPSWP+QT7rWscA4vsrdmzbEbenpw==} engines: {node: '>=18.12.0'} - ip-address@10.4.0: - resolution: {integrity: sha512-oSK96Grm3aP6OrS263xVxbNDGVL7rzBtYdpGqlDG8iQdoenDoTs/nkki+DflYbAEE8Xl6o5YxhxlrKvI3nqKXQ==} + ip-address@10.7.2: + resolution: {integrity: sha512-7H/2gFSIitxc0hG3nOI1glS8QLo/EHBFFLk8vEUjXY/xu0AdL8jZ9U1IzO2PUm0d2D/ofQcAifb0g6OBkt8U7w==} engines: {node: '>= 12'} is-arrayish@0.2.1: @@ -4609,8 +4609,8 @@ packages: undici-types@7.24.6: resolution: {integrity: sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==} - undici@7.29.0: - resolution: {integrity: sha512-IDxfleLmmbSskfWSUATiN1nfn2rDuvnMOqb5CWR92iIfojA0Ud+ulOAAEQ57LPr9rWmsreUyf5lwyao+7GNNVw==} + undici@7.30.0: + resolution: {integrity: sha512-dkrQXeHSaoamnItlYbmzG0wFYrM0ZwDxCIg0A7aKjTyyhh9svRzCNFEzV+Vm05/yehjCzjDZ31KXfGEjYSztDQ==} engines: {node: '>=20.18.1'} update-browserslist-db@1.3.2: @@ -6138,7 +6138,7 @@ snapshots: ms: 2.1.3 secure-json-parse: 4.1.0 tslib: 2.8.1 - undici: 7.29.0 + undici: 7.30.0 transitivePeerDependencies: - supports-color @@ -6706,7 +6706,7 @@ snapshots: dependencies: '@qdrant/openapi-typescript-fetch': 1.2.6 typescript: 5.5.4 - undici: 7.29.0 + undici: 7.30.0 '@qdrant/openapi-typescript-fetch@1.2.6': {} @@ -7178,7 +7178,7 @@ snapshots: '@turbopuffer/turbopuffer@2.5.0': dependencies: pako: 2.2.0 - undici: 7.29.0 + undici: 7.30.0 '@types/babel__core@7.20.5': dependencies: @@ -7346,7 +7346,7 @@ snapshots: acorn@8.16.0: {} - adm-zip@0.6.0: {} + adm-zip@0.6.1: {} afinn-165-financialmarketnews@3.0.0: {} @@ -7614,7 +7614,7 @@ snapshots: cassandra-driver@4.8.0: dependencies: '@types/node': 18.19.130 - adm-zip: 0.6.0 + adm-zip: 0.6.1 long: 5.2.5 chalk-template@0.4.0: @@ -8435,7 +8435,7 @@ snapshots: transitivePeerDependencies: - supports-color - ip-address@10.4.0: {} + ip-address@10.7.2: {} is-arrayish@0.2.1: {} @@ -9291,7 +9291,7 @@ snapshots: onnxruntime-node@1.24.3: dependencies: - adm-zip: 0.6.0 + adm-zip: 0.6.1 global-agent: 3.0.0 onnxruntime-common: 1.24.3 @@ -9845,7 +9845,7 @@ snapshots: socks@2.8.9: dependencies: - ip-address: 10.4.0 + ip-address: 10.7.2 smart-buffer: 4.2.0 source-map-support@0.5.13: @@ -10182,7 +10182,7 @@ snapshots: undici-types@7.24.6: {} - undici@7.29.0: {} + undici@7.30.0: {} update-browserslist-db@1.3.2(browserslist@4.28.9): dependencies: diff --git a/mem0-ts/pnpm-workspace.yaml b/mem0-ts/pnpm-workspace.yaml index 4048a653c..61017d969 100644 --- a/mem0-ts/pnpm-workspace.yaml +++ b/mem0-ts/pnpm-workspace.yaml @@ -13,7 +13,7 @@ overrides: "js-yaml@<3.15.1": ">=3.15.1 <4.0.0" "js-yaml@>=4.0.0 <4.3.1": ">=4.3.1 <5.0.0" "sharp@<0.35.0": ">=0.35.0 <0.36.0" - "adm-zip@<0.6.0": ">=0.6.0 <0.7.0" + "adm-zip@<0.6.1": ">=0.6.1 <0.7.0" "langsmith@<0.6.0": "^0.6.0" "minimatch@<3.1.3": "^3.1.3" "minimatch@>=5.0.0 <5.1.8": "^5.1.8" @@ -27,7 +27,7 @@ overrides: "glob@>=10.2.0 <10.5.0": "^10.5.0" "@modelcontextprotocol/sdk": "^1.25.4" "esbuild": ">=0.28.1" - "undici@<7.29.0": ">=7.29.0 <8.0.0" + "undici@<7.29.1": ">=7.29.1 <8.0.0" "axios@<1.18.0": ">=1.18.0 <2.0.0" "brace-expansion@<1.1.16": ">=1.1.16 <2.0.0" "brace-expansion@>=2.0.0 <2.1.4": ">=2.1.4 <3.0.0" @@ -37,7 +37,7 @@ overrides: "thrift@<0.23.0": "^0.23.0" "mongoose@>=9.0.0 <9.7.2": ">=9.7.2 <10.0.0" "protobufjs@<7.6.5": ">=7.6.5 <8.0.0" - "ip-address@<10.3.1": ">=10.3.1 <11.0.0" + "ip-address@<10.5.1": ">=10.5.1 <11.0.0" "browserslist@<4.28.7": ">=4.28.7 <5.0.0" "mysql2@<3.23.1": ">=3.23.1 <4.0.0" From c93420c49a6b14c3d446bdb156d96811908fd90a Mon Sep 17 00:00:00 2001 From: Harsh Vardhan Gupta Date: Mon, 5 Oct 2026 20:52:59 +0530 Subject: [PATCH 43/55] fix(security): resolve 13 Vanta HIGH Dependabot vulnerabilities (#7528) Co-authored-by: Claude Opus 5.5 --- integrations/deepseek-plugin/package.json | 5 + integrations/deepseek-plugin/pnpm-lock.yaml | 11 +- integrations/n8n-nodes-mem0/package.json | 4 +- integrations/n8n-nodes-mem0/pnpm-lock.yaml | 22 +- integrations/openclaw/package.json | 2 +- integrations/openclaw/pnpm-lock.yaml | 10 +- integrations/openclaw/pnpm-workspace.yaml | 2 +- integrations/pi-agent-plugin/package.json | 2 +- integrations/pi-agent-plugin/pnpm-lock.yaml | 10 +- .../pi-agent-plugin/pnpm-workspace.yaml | 2 +- integrations/vercel-ai-sdk/package.json | 4 +- integrations/vercel-ai-sdk/pnpm-lock.yaml | 12 +- .../vercel-ai-sdk/pnpm-workspace.yaml | 4 +- integrations/zapier-mem0/package.json | 2 +- integrations/zapier-mem0/pnpm-lock.yaml | 10 +- integrations/zapier-mem0/pnpm-workspace.yaml | 2 +- mem0-ts/package.json | 16 +- mem0-ts/pnpm-lock.yaml | 308 +++++++++--------- mem0-ts/pnpm-workspace.yaml | 12 +- server/dashboard/package.json | 2 +- server/dashboard/pnpm-lock.yaml | 266 +++++++-------- server/dashboard/pnpm-workspace.yaml | 8 +- 22 files changed, 365 insertions(+), 351 deletions(-) diff --git a/integrations/deepseek-plugin/package.json b/integrations/deepseek-plugin/package.json index 41a8fe7a5..8df2dc27f 100644 --- a/integrations/deepseek-plugin/package.json +++ b/integrations/deepseek-plugin/package.json @@ -60,5 +60,10 @@ "tsup": "^8.5.0", "typescript": "^5.6.0", "vitest": "^4.1.7" + }, + "pnpm": { + "overrides": { + "axios@<1.20.0": ">=1.20.0 <2.0.0" + } } } diff --git a/integrations/deepseek-plugin/pnpm-lock.yaml b/integrations/deepseek-plugin/pnpm-lock.yaml index 1444b53d4..d9fc88b8b 100644 --- a/integrations/deepseek-plugin/pnpm-lock.yaml +++ b/integrations/deepseek-plugin/pnpm-lock.yaml @@ -4,6 +4,9 @@ settings: autoInstallPeers: false excludeLinksFromLockfile: false +overrides: + axios@<1.20.0: '>=1.20.0 <2.0.0' + importers: .: @@ -575,8 +578,8 @@ packages: asynckit@0.4.0: resolution: {integrity: sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==} - axios@1.19.0: - resolution: {integrity: sha512-ht/iuYZXEjFxLH/Hkezgd7m6JKlHHXEUSneaDz8uZe1Gj5QZtCnpyDsckvAiEnT89OEbCLmnte4R4sn7P0EKFw==} + axios@1.20.0: + resolution: {integrity: sha512-r8aOh8j9cGKpgQAqpzrUHnSIc6a59Y3Xf/cv8sy1DrHCkZHzQGEuoq1tARk6qSyDdtQGSDgpb9kFlruzPvrgwg==} bundle-require@5.1.0: resolution: {integrity: sha512-3WrrOuZiyaaZPWiEt4G3+IffISVC9HYlWueJEBWED4ZH4aIAC2PnkdnuRrR94M+w6yGWn4AglWtJtBI8YqvgoA==} @@ -1610,7 +1613,7 @@ snapshots: asynckit@0.4.0: {} - axios@1.19.0: + axios@1.20.0: dependencies: follow-redirects: 1.16.0 form-data: 4.0.6 @@ -1856,7 +1859,7 @@ snapshots: mem0ai@3.1.6: dependencies: - axios: 1.19.0 + axios: 1.20.0 openai: 4.104.0(zod@3.25.76) uuid: 11.1.1 zod: 3.25.76 diff --git a/integrations/n8n-nodes-mem0/package.json b/integrations/n8n-nodes-mem0/package.json index 207dbbc7c..94e28dd8f 100644 --- a/integrations/n8n-nodes-mem0/package.json +++ b/integrations/n8n-nodes-mem0/package.json @@ -74,8 +74,8 @@ "brace-expansion@<1.1.16": ">=1.1.16 <2.0.0", "brace-expansion@>=2.0.0 <2.1.2": ">=2.1.2 <3.0.0", "brace-expansion@>=5.0.0 <5.0.8": ">=5.0.8", - "js-yaml@<3.15.1": ">=3.15.1 <4.0.0", - "js-yaml@>=4.0.0 <4.3.1": ">=4.3.1 <5.0.0" + "js-yaml@<3.15.2": ">=3.15.2 <4.0.0", + "js-yaml@>=4.0.0 <4.3.2": ">=4.3.2 <5.0.0" } } } diff --git a/integrations/n8n-nodes-mem0/pnpm-lock.yaml b/integrations/n8n-nodes-mem0/pnpm-lock.yaml index 41440b3ca..34372df52 100644 --- a/integrations/n8n-nodes-mem0/pnpm-lock.yaml +++ b/integrations/n8n-nodes-mem0/pnpm-lock.yaml @@ -11,8 +11,8 @@ overrides: brace-expansion@<1.1.16: '>=1.1.16 <2.0.0' brace-expansion@>=2.0.0 <2.1.2: '>=2.1.2 <3.0.0' brace-expansion@>=5.0.0 <5.0.8: '>=5.0.8' - js-yaml@<3.15.1: '>=3.15.1 <4.0.0' - js-yaml@>=4.0.0 <4.3.1: '>=4.3.1 <5.0.0' + js-yaml@<3.15.2: '>=3.15.2 <4.0.0' + js-yaml@>=4.0.0 <4.3.2: '>=4.3.2 <5.0.0' importers: @@ -1494,12 +1494,12 @@ packages: js-tokens@4.0.0: resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==} - js-yaml@3.15.1: - resolution: {integrity: sha512-S99WuO3HlhO3XN41EtYUNl9zzXjoJx7QvmipxsJVxtCBT0YHEFy+iOJhjSvrmV12nYhWpZaM8lPHkJm0yUMbag==} + js-yaml@3.15.2: + resolution: {integrity: sha512-6EuL879VkRA+1Cz578mKMiKvjPNEuk6+r1JaFzoSWejZmtf7xWbIyw1e3KkxlkzTIt9Taw6JBhEppG7utc1P+w==} hasBin: true - js-yaml@4.3.1: - resolution: {integrity: sha512-CY6crGq313MX8GkwvB7tzgp99vjQxY1++5y10/BKN/GUfHqWaOGQMNZkBvqSzsZKWk/ijwHlWzzkLulsGHhjWQ==} + js-yaml@4.3.2: + resolution: {integrity: sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA==} hasBin: true jsesc@3.1.0: @@ -2506,7 +2506,7 @@ snapshots: globals: 13.24.0 ignore: 5.3.2 import-fresh: 3.3.1 - js-yaml: 4.3.1 + js-yaml: 4.3.2 minimatch: 3.1.5 strip-json-comments: 3.1.1 transitivePeerDependencies: @@ -2546,7 +2546,7 @@ snapshots: camelcase: 5.3.1 find-up: 4.1.0 get-package-type: 0.1.0 - js-yaml: 3.15.1 + js-yaml: 3.15.2 resolve-from: 5.0.0 '@istanbuljs/schema@0.1.6': {} @@ -3353,7 +3353,7 @@ snapshots: imurmurhash: 0.1.4 is-glob: 4.0.3 is-path-inside: 3.0.3 - js-yaml: 4.3.1 + js-yaml: 4.3.2 json-stable-stringify-without-jsonify: 1.0.1 levn: 0.4.1 lodash.merge: 4.6.2 @@ -4173,12 +4173,12 @@ snapshots: js-tokens@4.0.0: {} - js-yaml@3.15.1: + js-yaml@3.15.2: dependencies: argparse: 1.0.10 esprima: 4.0.1 - js-yaml@4.3.1: + js-yaml@4.3.2: dependencies: argparse: 2.0.1 diff --git a/integrations/openclaw/package.json b/integrations/openclaw/package.json index df01be01a..f24bca81a 100644 --- a/integrations/openclaw/package.json +++ b/integrations/openclaw/package.json @@ -73,7 +73,7 @@ "uuid@<11.1.1": ">=11.1.1", "esbuild": ">=0.28.1", "undici@<7.29.1": ">=7.29.1 <8.0.0", - "axios@<1.18.0": ">=1.18.0 <2.0.0", + "axios@<1.20.0": ">=1.20.0 <2.0.0", "postcss@<8.5.18": ">=8.5.18 <9.0.0", "mongoose@>=9.0.0 <9.7.2": ">=9.7.2 <10.0.0" } diff --git a/integrations/openclaw/pnpm-lock.yaml b/integrations/openclaw/pnpm-lock.yaml index 6e8729d46..90d1b23b6 100644 --- a/integrations/openclaw/pnpm-lock.yaml +++ b/integrations/openclaw/pnpm-lock.yaml @@ -14,7 +14,7 @@ overrides: uuid@<11.1.1: '>=11.1.1' esbuild: '>=0.28.1' undici@<7.29.1: '>=7.29.1 <8.0.0' - axios@<1.18.0: '>=1.18.0 <2.0.0' + axios@<1.20.0: '>=1.20.0 <2.0.0' postcss@<8.5.18: '>=8.5.18 <9.0.0' mongoose@>=9.0.0 <9.7.2: '>=9.7.2 <10.0.0' @@ -857,8 +857,8 @@ packages: asynckit@0.4.0: resolution: {integrity: sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==} - axios@1.18.1: - resolution: {integrity: sha512-3nTvFlvpn9Zu/RkHUqtc7/+al4UpRW5az71ap5zccp6e8RAYEzhMTecX8Dz1wWDYrPpUoB1HAQEGEAEvUr7S9g==} + axios@1.20.0: + resolution: {integrity: sha512-r8aOh8j9cGKpgQAqpzrUHnSIc6a59Y3Xf/cv8sy1DrHCkZHzQGEuoq1tARk6qSyDdtQGSDgpb9kFlruzPvrgwg==} base-64@0.1.0: resolution: {integrity: sha512-Y5gU45svrR5tI2Vt/X9GPd3L0HNIKzGu202EjxrXMpuc2V2CiKgemAbUUsqYmZJvPtCXoUKjNZwBJzsNScUbXA==} @@ -2906,7 +2906,7 @@ snapshots: asynckit@0.4.0: {} - axios@1.18.1: + axios@1.20.0: dependencies: follow-redirects: 1.16.0 form-data: 4.0.6 @@ -3529,7 +3529,7 @@ snapshots: '@supabase/supabase-js': 2.108.1 '@types/jest': 29.5.14 '@types/pg': 8.11.0 - axios: 1.18.1 + axios: 1.20.0 better-sqlite3: 12.10.0 cloudflare: 4.5.0 compromise: 14.15.1 diff --git a/integrations/openclaw/pnpm-workspace.yaml b/integrations/openclaw/pnpm-workspace.yaml index 34e812fa8..9f2b3e97c 100644 --- a/integrations/openclaw/pnpm-workspace.yaml +++ b/integrations/openclaw/pnpm-workspace.yaml @@ -22,6 +22,6 @@ overrides: "uuid@<11.1.1": ">=11.1.1" "esbuild": ">=0.28.1" "undici@<7.29.1": ">=7.29.1 <8.0.0" - "axios@<1.18.0": ">=1.18.0 <2.0.0" + "axios@<1.20.0": ">=1.20.0 <2.0.0" "postcss@<8.5.18": ">=8.5.18 <9.0.0" "mongoose@>=9.0.0 <9.7.2": ">=9.7.2 <10.0.0" diff --git a/integrations/pi-agent-plugin/package.json b/integrations/pi-agent-plugin/package.json index 56952c42f..f6978753b 100644 --- a/integrations/pi-agent-plugin/package.json +++ b/integrations/pi-agent-plugin/package.json @@ -74,7 +74,7 @@ "esbuild": ">=0.28.1", "undici@<7.29.1": ">=7.29.1 <8.0.0", "undici@>=8.0.0 <8.10.2": ">=8.10.2 <9.0.0", - "axios@<1.18.0": ">=1.18.0 <2.0.0", + "axios@<1.20.0": ">=1.20.0 <2.0.0", "brace-expansion@>=3.0.0 <5.0.8": ">=5.0.8 <6.0.0", "postcss@<8.5.18": ">=8.5.18 <9.0.0", "mongoose@>=9.0.0 <9.7.2": ">=9.7.2 <10.0.0", diff --git a/integrations/pi-agent-plugin/pnpm-lock.yaml b/integrations/pi-agent-plugin/pnpm-lock.yaml index 0a4100fc8..8ae11c8ed 100644 --- a/integrations/pi-agent-plugin/pnpm-lock.yaml +++ b/integrations/pi-agent-plugin/pnpm-lock.yaml @@ -10,7 +10,7 @@ overrides: esbuild: '>=0.28.1' undici@<7.29.1: '>=7.29.1 <8.0.0' undici@>=8.0.0 <8.10.2: '>=8.10.2 <9.0.0' - axios@<1.18.0: '>=1.18.0 <2.0.0' + axios@<1.20.0: '>=1.20.0 <2.0.0' brace-expansion@>=3.0.0 <5.0.8: '>=5.0.8 <6.0.0' postcss@<8.5.18: '>=8.5.18 <9.0.0' mongoose@>=9.0.0 <9.7.2: '>=9.7.2 <10.0.0' @@ -1066,8 +1066,8 @@ packages: asynckit@0.4.0: resolution: {integrity: sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==} - axios@1.18.1: - resolution: {integrity: sha512-3nTvFlvpn9Zu/RkHUqtc7/+al4UpRW5az71ap5zccp6e8RAYEzhMTecX8Dz1wWDYrPpUoB1HAQEGEAEvUr7S9g==} + axios@1.20.0: + resolution: {integrity: sha512-r8aOh8j9cGKpgQAqpzrUHnSIc6a59Y3Xf/cv8sy1DrHCkZHzQGEuoq1tARk6qSyDdtQGSDgpb9kFlruzPvrgwg==} balanced-match@4.0.4: resolution: {integrity: sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==} @@ -3598,7 +3598,7 @@ snapshots: asynckit@0.4.0: {} - axios@1.18.1: + axios@1.20.0: dependencies: follow-redirects: 1.16.0 form-data: 4.0.6 @@ -4253,7 +4253,7 @@ snapshots: '@supabase/supabase-js': 2.108.1 '@types/jest': 29.5.14 '@types/pg': 8.11.0 - axios: 1.18.1 + axios: 1.20.0 better-sqlite3: 12.10.0 cloudflare: 4.5.0 compromise: 14.15.1 diff --git a/integrations/pi-agent-plugin/pnpm-workspace.yaml b/integrations/pi-agent-plugin/pnpm-workspace.yaml index 071ea6a55..10de842c5 100644 --- a/integrations/pi-agent-plugin/pnpm-workspace.yaml +++ b/integrations/pi-agent-plugin/pnpm-workspace.yaml @@ -7,7 +7,7 @@ overrides: "esbuild": ">=0.28.1" "undici@<7.29.1": ">=7.29.1 <8.0.0" "undici@>=8.0.0 <8.10.2": ">=8.10.2 <9.0.0" - "axios@<1.18.0": ">=1.18.0 <2.0.0" + "axios@<1.20.0": ">=1.20.0 <2.0.0" "brace-expansion@>=3.0.0 <5.0.8": ">=5.0.8 <6.0.0" "postcss@<8.5.18": ">=8.5.18 <9.0.0" "mongoose@>=9.0.0 <9.7.2": ">=9.7.2 <10.0.0" diff --git a/integrations/vercel-ai-sdk/package.json b/integrations/vercel-ai-sdk/package.json index 1165c3f92..aef0b639a 100644 --- a/integrations/vercel-ai-sdk/package.json +++ b/integrations/vercel-ai-sdk/package.json @@ -88,8 +88,8 @@ "esbuild": ">=0.28.1", "brace-expansion@<1.1.16": ">=1.1.16 <2.0.0", "brace-expansion@>=3.0.0 <5.0.8": ">=5.0.8 <6.0.0", - "js-yaml@<3.15.1": ">=3.15.1 <4.0.0", - "js-yaml@>=4.0.0 <4.3.1": ">=4.3.1 <5.0.0", + "js-yaml@<3.15.2": ">=3.15.2 <4.0.0", + "js-yaml@>=4.0.0 <4.3.2": ">=4.3.2 <5.0.0", "browserslist@<4.28.7": ">=4.28.7 <5.0.0" } } diff --git a/integrations/vercel-ai-sdk/pnpm-lock.yaml b/integrations/vercel-ai-sdk/pnpm-lock.yaml index f8208a36a..482bba7d1 100644 --- a/integrations/vercel-ai-sdk/pnpm-lock.yaml +++ b/integrations/vercel-ai-sdk/pnpm-lock.yaml @@ -14,8 +14,8 @@ overrides: esbuild: '>=0.28.1' brace-expansion@<1.1.16: '>=1.1.16 <2.0.0' brace-expansion@>=3.0.0 <5.0.8: '>=5.0.8 <6.0.0' - js-yaml@<3.15.1: '>=3.15.1 <4.0.0' - js-yaml@>=4.0.0 <4.3.1: '>=4.3.1 <5.0.0' + js-yaml@<3.15.2: '>=3.15.2 <4.0.0' + js-yaml@>=4.0.0 <4.3.2: '>=4.3.2 <5.0.0' browserslist@<4.28.7: '>=4.28.7 <5.0.0' importers: @@ -1356,8 +1356,8 @@ packages: js-tokens@4.0.0: resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==} - js-yaml@3.15.1: - resolution: {integrity: sha512-S99WuO3HlhO3XN41EtYUNl9zzXjoJx7QvmipxsJVxtCBT0YHEFy+iOJhjSvrmV12nYhWpZaM8lPHkJm0yUMbag==} + js-yaml@3.15.2: + resolution: {integrity: sha512-6EuL879VkRA+1Cz578mKMiKvjPNEuk6+r1JaFzoSWejZmtf7xWbIyw1e3KkxlkzTIt9Taw6JBhEppG7utc1P+w==} hasBin: true jsesc@3.1.0: @@ -2231,7 +2231,7 @@ snapshots: camelcase: 5.3.1 find-up: 4.1.0 get-package-type: 0.1.0 - js-yaml: 3.15.1 + js-yaml: 3.15.2 resolve-from: 5.0.0 '@istanbuljs/schema@0.1.6': {} @@ -3360,7 +3360,7 @@ snapshots: js-tokens@4.0.0: {} - js-yaml@3.15.1: + js-yaml@3.15.2: dependencies: argparse: 1.0.10 esprima: 4.0.1 diff --git a/integrations/vercel-ai-sdk/pnpm-workspace.yaml b/integrations/vercel-ai-sdk/pnpm-workspace.yaml index 93ff161d8..cd73ee714 100644 --- a/integrations/vercel-ai-sdk/pnpm-workspace.yaml +++ b/integrations/vercel-ai-sdk/pnpm-workspace.yaml @@ -15,6 +15,6 @@ overrides: "esbuild": ">=0.28.1" "brace-expansion@<1.1.16": ">=1.1.16 <2.0.0" "brace-expansion@>=3.0.0 <5.0.8": ">=5.0.8 <6.0.0" - "js-yaml@<3.15.1": ">=3.15.1 <4.0.0" - "js-yaml@>=4.0.0 <4.3.1": ">=4.3.1 <5.0.0" + "js-yaml@<3.15.2": ">=3.15.2 <4.0.0" + "js-yaml@>=4.0.0 <4.3.2": ">=4.3.2 <5.0.0" "browserslist@<4.28.7": ">=4.28.7 <5.0.0" diff --git a/integrations/zapier-mem0/package.json b/integrations/zapier-mem0/package.json index b33e01b53..248ca9572 100644 --- a/integrations/zapier-mem0/package.json +++ b/integrations/zapier-mem0/package.json @@ -72,7 +72,7 @@ "undici@<7.29.0": ">=7.29.0 <8.0.0", "undici@>=8.0.0 <8.9.0": ">=8.9.0 <9.0.0", "brace-expansion@<1.1.16": ">=1.1.16 <2.0.0", - "js-yaml@<3.15.1": ">=3.15.1 <4.0.0" + "js-yaml@<3.15.2": ">=3.15.2 <4.0.0" } } } diff --git a/integrations/zapier-mem0/pnpm-lock.yaml b/integrations/zapier-mem0/pnpm-lock.yaml index 703de111d..2518f4e34 100644 --- a/integrations/zapier-mem0/pnpm-lock.yaml +++ b/integrations/zapier-mem0/pnpm-lock.yaml @@ -11,7 +11,7 @@ overrides: undici@<7.29.0: '>=7.29.0 <8.0.0' undici@>=8.0.0 <8.9.0: '>=8.9.0 <9.0.0' brace-expansion@<1.1.16: '>=1.1.16 <2.0.0' - js-yaml@<3.15.1: '>=3.15.1 <4.0.0' + js-yaml@<3.15.2: '>=3.15.2 <4.0.0' importers: @@ -951,8 +951,8 @@ packages: js-tokens@4.0.0: resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==} - js-yaml@3.15.1: - resolution: {integrity: sha512-S99WuO3HlhO3XN41EtYUNl9zzXjoJx7QvmipxsJVxtCBT0YHEFy+iOJhjSvrmV12nYhWpZaM8lPHkJm0yUMbag==} + js-yaml@3.15.2: + resolution: {integrity: sha512-6EuL879VkRA+1Cz578mKMiKvjPNEuk6+r1JaFzoSWejZmtf7xWbIyw1e3KkxlkzTIt9Taw6JBhEppG7utc1P+w==} hasBin: true jsesc@3.1.0: @@ -1654,7 +1654,7 @@ snapshots: camelcase: 5.3.1 find-up: 4.1.0 get-package-type: 0.1.0 - js-yaml: 3.15.1 + js-yaml: 3.15.2 resolve-from: 5.0.0 '@istanbuljs/schema@0.1.6': {} @@ -2714,7 +2714,7 @@ snapshots: js-tokens@4.0.0: {} - js-yaml@3.15.1: + js-yaml@3.15.2: dependencies: argparse: 1.0.10 esprima: 4.0.1 diff --git a/integrations/zapier-mem0/pnpm-workspace.yaml b/integrations/zapier-mem0/pnpm-workspace.yaml index e19a69b83..2b48f0327 100644 --- a/integrations/zapier-mem0/pnpm-workspace.yaml +++ b/integrations/zapier-mem0/pnpm-workspace.yaml @@ -8,4 +8,4 @@ overrides: "undici@<7.29.0": ">=7.29.0 <8.0.0" "undici@>=8.0.0 <8.9.0": ">=8.9.0 <9.0.0" "brace-expansion@<1.1.16": ">=1.1.16 <2.0.0" - "js-yaml@<3.15.1": ">=3.15.1 <4.0.0" + "js-yaml@<3.15.2": ">=3.15.2 <4.0.0" diff --git a/mem0-ts/package.json b/mem0-ts/package.json index c34192188..586bf9030 100644 --- a/mem0-ts/package.json +++ b/mem0-ts/package.json @@ -104,7 +104,7 @@ "@types/jest": "^29.5.14" }, "dependencies": { - "axios": "^1.18.0", + "axios": "^1.20.0", "openai": "^4.93.0", "uuid": "^11.1.1", "zod": "^3.24.1" @@ -285,9 +285,9 @@ "picomatch@<2.3.2": "^2.3.2", "picomatch@>=4.0.0 <4.0.4": "^4.0.4", "jws@4.0.0": "4.0.1", - "js-yaml@<3.15.1": ">=3.15.1 <4.0.0", - "js-yaml@>=4.0.0 <4.3.1": ">=4.3.1 <5.0.0", - "sharp@<0.35.0": ">=0.35.0 <0.36.0", + "js-yaml@<3.15.2": ">=3.15.2 <4.0.0", + "js-yaml@>=4.0.0 <4.3.2": ">=4.3.2 <5.0.0", + "sharp@<0.35.4": ">=0.35.4 <0.36.0", "adm-zip@<0.6.1": ">=0.6.1 <0.7.0", "langsmith@<0.6.0": "^0.6.0", "minimatch@<3.1.3": "^3.1.3", @@ -306,9 +306,9 @@ "undici@<7.29.1": ">=7.29.1 <8.0.0", "@aws-sdk/client-bedrock-runtime": "3.967.0", "@aws-sdk/client-neptune-graph": "3.966.0", - "axios@<1.18.0": ">=1.18.0 <2.0.0", + "axios@<1.20.0": ">=1.20.0 <2.0.0", "brace-expansion@<1.1.16": ">=1.1.16 <2.0.0", - "brace-expansion@>=2.0.0 <2.1.4": ">=2.1.4 <3.0.0", + "brace-expansion@>=2.0.0 <2.1.6": ">=2.1.6 <3.0.0", "brace-expansion@>=3.0.0 <5.0.8": ">=5.0.8 <6.0.0", "fast-xml-parser@>=5.0.0 <5.10.1": ">=5.10.1 <6.0.0", "tar@<7.5.21": ">=7.5.21 <8.0.0", @@ -317,7 +317,9 @@ "protobufjs@<7.6.5": ">=7.6.5 <8.0.0", "ip-address@<10.5.1": ">=10.5.1 <11.0.0", "browserslist@<4.28.7": ">=4.28.7 <5.0.0", - "mysql2@<3.23.1": ">=3.23.1 <4.0.0" + "mysql2@<3.23.1": ">=3.23.1 <4.0.0", + "basic-ftp@<6.2.1": ">=6.2.1 <7.0.0", + "@grpc/grpc-js@>=1.14.0 <1.14.5": ">=1.14.5 <2.0.0" } } } diff --git a/mem0-ts/pnpm-lock.yaml b/mem0-ts/pnpm-lock.yaml index 27e0811f7..623443f1e 100644 --- a/mem0-ts/pnpm-lock.yaml +++ b/mem0-ts/pnpm-lock.yaml @@ -9,9 +9,9 @@ overrides: picomatch@<2.3.2: ^2.3.2 picomatch@>=4.0.0 <4.0.4: ^4.0.4 jws@4.0.0: 4.0.1 - js-yaml@<3.15.1: '>=3.15.1 <4.0.0' - js-yaml@>=4.0.0 <4.3.1: '>=4.3.1 <5.0.0' - sharp@<0.35.0: '>=0.35.0 <0.36.0' + js-yaml@<3.15.2: '>=3.15.2 <4.0.0' + js-yaml@>=4.0.0 <4.3.2: '>=4.3.2 <5.0.0' + sharp@<0.35.4: '>=0.35.4 <0.36.0' adm-zip@<0.6.1: '>=0.6.1 <0.7.0' langsmith@<0.6.0: ^0.6.0 minimatch@<3.1.3: ^3.1.3 @@ -30,9 +30,9 @@ overrides: undici@<7.29.1: '>=7.29.1 <8.0.0' '@aws-sdk/client-bedrock-runtime': 3.967.0 '@aws-sdk/client-neptune-graph': 3.966.0 - axios@<1.18.0: '>=1.18.0 <2.0.0' + axios@<1.20.0: '>=1.20.0 <2.0.0' brace-expansion@<1.1.16: '>=1.1.16 <2.0.0' - brace-expansion@>=2.0.0 <2.1.4: '>=2.1.4 <3.0.0' + brace-expansion@>=2.0.0 <2.1.6: '>=2.1.6 <3.0.0' brace-expansion@>=3.0.0 <5.0.8: '>=5.0.8 <6.0.0' fast-xml-parser@>=5.0.0 <5.10.1: '>=5.10.1 <6.0.0' tar@<7.5.21: '>=7.5.21 <8.0.0' @@ -42,6 +42,8 @@ overrides: ip-address@<10.5.1: '>=10.5.1 <11.0.0' browserslist@<4.28.7: '>=4.28.7 <5.0.0' mysql2@<3.23.1: '>=3.23.1 <4.0.0' + basic-ftp@<6.2.1: '>=6.2.1 <7.0.0' + '@grpc/grpc-js@>=1.14.0 <1.14.5': '>=1.14.5 <2.0.0' patchedDependencies: tar@7.5.22: @@ -119,8 +121,8 @@ importers: specifier: ^2.4.0 || ^3.0.0 version: 3.0.3 axios: - specifier: ^1.18.0 - version: 1.18.1 + specifier: ^1.20.0 + version: 1.20.0 better-sqlite3: specifier: ^12.6.2 version: 12.10.0 @@ -861,8 +863,8 @@ packages: resolution: {integrity: sha512-L38Ax21uF2OPUmCRWycZ/dZdMYf7gMrtClcxvVrqJVFmn8ET2M++GYmFGJpLqOHS1beATxOXLWe7y2ijSQz/ng==} engines: {node: '>=20'} - '@emnapi/runtime@1.11.2': - resolution: {integrity: sha512-kyOl3X0DuTiT1h2ft8r2fYO8JYtU9a9Xis/zBSiGArNaagCOWx90N1k2wxp18czFDH+OgcWGb5ZP/XMt3dcyPA==} + '@emnapi/runtime@1.11.3': + resolution: {integrity: sha512-Xz4Tpyki7XyrpbUK1jR1AhdAdaXyhhY4lZ3neLodmhpuWfy2PAQN5B46sAiU4liOXGLkHypn/qU+jvfWSCYYLA==} '@esbuild/aix-ppc64@0.28.1': resolution: {integrity: sha512-Svl7tq8k/08+p6CXPpRjQ1fKX+1odH/BQbb48fV6fj3CWHhsoIOoY87w1oHXm0qEpkIK3ZfVgp0hed3XBXzXMQ==} @@ -1038,8 +1040,8 @@ packages: peerDependencies: graphql: ^0.8.0 || ^0.9.0 || ^0.10.0 || ^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0 || ^15.0.0 || ^16.0.0 || ^17.0.0 - '@grpc/grpc-js@1.14.4': - resolution: {integrity: sha512-k9Dj3DV/itK9D06Y8f190Qgop7/Ui+D0njFV3LHMPwPT75DpXLQohE9Wmz0QElrJnzsjB7KPWiKJbOl7IPDArQ==} + '@grpc/grpc-js@1.14.5': + resolution: {integrity: sha512-7VZM+SVdEcUUqSQeNI3zM8Qs/BhQKZndPo2h5VkYkAM8Iz0wJIa8mKV5ekQGqG8UUsnkQ0NMxIxwkIHYvj0qOw==} engines: {node: '>=12.10.0'} '@grpc/proto-loader@0.8.1': @@ -1075,144 +1077,144 @@ packages: resolution: {integrity: sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==} engines: {node: '>=18'} - '@img/sharp-darwin-arm64@0.35.3': - resolution: {integrity: sha512-RMnFX7YQsMoh7lWfcM4NEHHymBX/rLuKNPVM84XE9ONPcaSCDgE7CHIHpSgPcO2xcRthgBy1HfNO319mwhIAkg==} + '@img/sharp-darwin-arm64@0.35.5': + resolution: {integrity: sha512-QRUlFQ0WxvdWyqqG/WtI3iupfD5rBzmCHXSdPsY91sAtVtTo7Q4cb6zOccZ3gqEqkr0f1As1ehLqmEpDsRf+lg==} engines: {node: '>=20.9.0'} cpu: [arm64] os: [darwin] - '@img/sharp-darwin-x64@0.35.3': - resolution: {integrity: sha512-Xo+5uFBtLN0BKqieTxiFzFPQAUlBbbH5iBKyRX/z1JrbnYsHTfKJnUfL8+p2TPXr1pXqao4eeL4Rl144uDpK9w==} + '@img/sharp-darwin-x64@0.35.5': + resolution: {integrity: sha512-+BR255RhDlpygUpOc/Jdt1nT6DQ3XG/ERo5wbcdOf5Q320dKtPCKPLR1LJs9VGXRaMa8l1uUa0tkCNOXiAxZUw==} engines: {node: '>=20.9.0'} cpu: [x64] os: [darwin] - '@img/sharp-freebsd-wasm32@0.35.3': - resolution: {integrity: sha512-lUxcqWIj2wMQ9BrwNjngcr1gWUr5xgaGThBRqPPalIC2n67Cqj1uPh8NnA/ZhAg8hUbKl+kVHKwgUIwe6ZYPrg==} + '@img/sharp-freebsd-wasm32@0.35.5': + resolution: {integrity: sha512-Y/z91nEZ4uIBX5X3nfTovjU9lHNKFYbL2lpHCLVNmXQK03VIZvXBBt0KxbPGp2SdGSF+2mQU4e+hQaWOt86iAw==} engines: {node: '>=20.9.0'} os: [freebsd] - '@img/sharp-libvips-darwin-arm64@1.3.2': - resolution: {integrity: sha512-9J6ypZFpQBj4YnePGoq/S38w6nz+vqg5WZLrLGY4YuSemdMq47GMLBPO42MzwdGwpg/agZ7xzZcFHa48xlywfg==} + '@img/sharp-libvips-darwin-arm64@1.3.4': + resolution: {integrity: sha512-5R89nBYiRdUlSWJxPhO+GVtaXzXSxKnRu/xqMn3KTA3L9EB9Oy/P+Nn2f2vlhPuUdy/Zusb2DarbyTpGCfEDuw==} cpu: [arm64] os: [darwin] - '@img/sharp-libvips-darwin-x64@1.3.2': - resolution: {integrity: sha512-m2pW1n6cns9VaubNwsZ+c3CRYjxNQWgJ5gPlnL1nbBcpkBvFm6SCFN5o0psFHI8w9n11NKhFkeEDns98tiqbEw==} + '@img/sharp-libvips-darwin-x64@1.3.4': + resolution: {integrity: sha512-iR2OKH80yi0U+dUplyh3/xdpFvps6YkCwsXenIJxqxR1v9o+xtKTGbS9H7cps+2Vxjc8B1j96p75NmTGjIhtpQ==} cpu: [x64] os: [darwin] - '@img/sharp-libvips-linux-arm64@1.3.2': - resolution: {integrity: sha512-dqVSFynCox4C/J8kT16V7SIFAns0IjgLwkvYT7p8LQVmJ5OS5b6tI9IGflxTeuBS//zXeFIUbwt5dwxyZ17cnA==} + '@img/sharp-libvips-linux-arm64@1.3.4': + resolution: {integrity: sha512-Y3dgX/6lE2QhQb+Gxy0WZxfg9MEm/JBjamZpS2IklP7xIQoKN4hzAm7KcMVGtaVDt3neE9OKBC7vAfonA/Lr1A==} cpu: [arm64] os: [linux] - '@img/sharp-libvips-linux-arm@1.3.2': - resolution: {integrity: sha512-1eMLzy92I4J6rmi4mAT8yC3HxOtniyGELlzGbNMLLeqe052ahFQ0h6LFq+lh5DsDIdYViIDst08abvSbcEdLXQ==} + '@img/sharp-libvips-linux-arm@1.3.4': + resolution: {integrity: sha512-LmRtTsOHuvM2+wlO2Db37dx5MiZhB0FvSunciw48YjdOkZz9KAiRbm8ujeMOA1INqmei5NapFxYEK1D1ZSidmw==} cpu: [arm] os: [linux] - '@img/sharp-libvips-linux-ppc64@1.3.2': - resolution: {integrity: sha512-3z0NHDxD6n5I9gc05U1eW1AyRm+Gznzq3naMrthPNqE6oYykcogW0l/jfpJdjYnuNl8R7yI9pNbE1XiUeyq0Aw==} + '@img/sharp-libvips-linux-ppc64@1.3.4': + resolution: {integrity: sha512-Le6boB8Tai0Nis+gIxIpKx68UDVVIqdR8Tin5Yf1z2LJJQLDJvCDRqRu+jC2qCoD+eIomonmOwB4smBRxfVpYQ==} cpu: [ppc64] os: [linux] - '@img/sharp-libvips-linux-riscv64@1.3.2': - resolution: {integrity: sha512-bsb4rI+NldGOsXuej2r8OdSS8+zXDVaCWxyWrcv6kneTOlgAHtZABRzBBCwdsPiD90J4myNJuHpg6kA20ImW/w==} + '@img/sharp-libvips-linux-riscv64@1.3.4': + resolution: {integrity: sha512-aHkkIEHPRdQEegJN20MLmGtxYD9R2wQr3Cwpddnu5+YKMt6Uzax7S9h5gpZTo8wyrGuZSlfQ63OevL5mTyOC7Q==} cpu: [riscv64] os: [linux] - '@img/sharp-libvips-linux-s390x@1.3.2': - resolution: {integrity: sha512-/ABshyj8gCpyIrNXnHn4LorDJ0HHm1VhXPBlxZ8zAtfVPAaSafXPGn+sUSIRiwaSBy0mmFjSjiXI5mkcwdChKQ==} + '@img/sharp-libvips-linux-s390x@1.3.4': + resolution: {integrity: sha512-ra/mB6MikESDUO7Yg+Mi95bFBb9GsObURuhnOv3OqknjGe9sZrG8tCe9q0xSIGrtLgvgw0gKnFWcK4blSgQOuQ==} cpu: [s390x] os: [linux] - '@img/sharp-libvips-linux-x64@1.3.2': - resolution: {integrity: sha512-ITPEtgffGJ0S6G9dRyw/366tJQqFRcHWPHhC+Stpg3Z8AEMrDrTr2lhdz4f/Y/HMbRh//7Z5mBzEpVdi62Oc3w==} + '@img/sharp-libvips-linux-x64@1.3.4': + resolution: {integrity: sha512-GJ//SSXbnwSDes02umB3nDJLFcQzw8a18V8fyhqr6tV515tOEMdImjjxj1AoafMRz56F3PHgftnj1QEKSU1zkw==} cpu: [x64] os: [linux] - '@img/sharp-libvips-linuxmusl-arm64@1.3.2': - resolution: {integrity: sha512-zE9EdiUzUmg5mDT5a1rk5fYJ6GWPloTwWBYDS14naqHsL+EaMpDj1AWnpLgh3u0YCORv2Tt50wrcrpYqkP97Kw==} + '@img/sharp-libvips-linuxmusl-arm64@1.3.4': + resolution: {integrity: sha512-hvulFwtjUcagsis6BBxHwGFwWoNZjgYmULGVrZcyfNbjA8hKILbRxGg15/7w5HDyXHXUos/j6baAWqnCyQ2DWA==} cpu: [arm64] os: [linux] - '@img/sharp-libvips-linuxmusl-x64@1.3.2': - resolution: {integrity: sha512-m0lrLiUt+lBYnCFr8qV/65yMR4E/c7/wf78I5eKTdkEakFAlZ9QlzEM3QIhhAwVeUhLAHLcCq7a7Vszq/oFNZQ==} + '@img/sharp-libvips-linuxmusl-x64@1.3.4': + resolution: {integrity: sha512-6zXKeE/p39I1AmA3cJG35eyBGNqNddLnUXjhwBnsGjFPWqf5VKkDBEqaEkPDoTEtkxwi2vv8Tcr2mDyP4So7Fg==} cpu: [x64] os: [linux] - '@img/sharp-linux-arm64@0.35.3': - resolution: {integrity: sha512-QgKDspHPnrU+GQ55XPhGwyhC8acLVOOSyAvo1oVfFmrIXLkDNmGWzAfDZ4xK8oSA1qBQrALcHX0G5UZni/SuFQ==} + '@img/sharp-linux-arm64@0.35.5': + resolution: {integrity: sha512-LYVx5JTsOM2CBzmxreh+nl64/3H6Xb09iSLknqH47z2T2DFFxDeFLP5y4dJwe6H7uGQlHPyEEtIqyo3DYsRwdQ==} engines: {node: '>=20.9.0'} cpu: [arm64] os: [linux] - '@img/sharp-linux-arm@0.35.3': - resolution: {integrity: sha512-affVWCTLooy8TSxbDx2qkzuDeaWLNVBA+P//FNBirHsXpP2fuBhk5AuboYUnrDnzoXes8GFjpTx0SBFOCRg+FA==} + '@img/sharp-linux-arm@0.35.5': + resolution: {integrity: sha512-LEaXK2WdXVK5ykcw0buWyPMsmLLL2vpHLD6yrNSW+JGEL3BZPA4tpKN6iaMc4AxTTAoaX/sU1rOL51lcIz48ZQ==} engines: {node: '>=20.9.0'} cpu: [arm] os: [linux] - '@img/sharp-linux-ppc64@0.35.3': - resolution: {integrity: sha512-sMd8rDxmpLOwv/7N44klFjOD5DUO7FLdjiXDI0hoxYaf7Ar262dQIEkosE98bps+5HPLtp/EvNqeqQtOycP/IA==} + '@img/sharp-linux-ppc64@0.35.5': + resolution: {integrity: sha512-QVxAAq8evVRI9ia2vqgwrmWucn5Dfv+JdWzj75pD8omHLPSP7f8p20O8jxzjCcuCEQEOtYOZUmX1hkiZ0kdevA==} engines: {node: '>=20.9.0'} cpu: [ppc64] os: [linux] - '@img/sharp-linux-riscv64@0.35.3': - resolution: {integrity: sha512-0Eob78yjlYPfL5vMNWAW55l3R9Y6BQS/gOfe0ZcP9mEz9ohhKSt4im1hayiknXgf8AWrFqMvJcKIdmLmEe7yeQ==} + '@img/sharp-linux-riscv64@0.35.5': + resolution: {integrity: sha512-LtdreXguaavKODPIfzJ4kffx7UNt1omwtK0rch4EBbbSTXPnxWmYSayXdLJw0fJzQ97kHt1gL/yh4tvU+nCyRQ==} engines: {node: '>=20.9.0'} cpu: [riscv64] os: [linux] - '@img/sharp-linux-s390x@0.35.3': - resolution: {integrity: sha512-KgAxQ0DxpNOq1rG2t5cgTgShJFGSuU7XO45cqC+1NVOuZnP6tlgZRuSYOfNupGkHID0o3cJOsw4DVeJpMovcGw==} + '@img/sharp-linux-s390x@0.35.5': + resolution: {integrity: sha512-UZasTOFiYzotTsGOCu42BfUzP6Tu6Do/947iRm1RsLKvlllxwGcn4RN27LibGWceix4Y+Pmw3jsnTcCQIgWjqA==} engines: {node: '>=20.9.0'} cpu: [s390x] os: [linux] - '@img/sharp-linux-x64@0.35.3': - resolution: {integrity: sha512-8pqvxubL2PGdhlPy6GLqzDYMUjyRmKAwKHYKixpdJYBUK7PJ0C029XdsnpFIdgRZG68fZiGdHVWcKPvtiPB4cA==} + '@img/sharp-linux-x64@0.35.5': + resolution: {integrity: sha512-SxFtLTeJInhAA9Q836kux2vZNeOBQEx658qvbboZScr0wIARym3IcGmW7KpVD5sbVg0Ojy+udFQdayYIZyoNog==} engines: {node: '>=20.9.0'} cpu: [x64] os: [linux] - '@img/sharp-linuxmusl-arm64@0.35.3': - resolution: {integrity: sha512-Vz0iQjzzcSX3HCbfwFfCSG/9SCIqyO0mH2sXyiHaAYfBk0cRsCWXRyQYX0ovCK/PAQBbTzQ0dsPQHh5MAFL59w==} + '@img/sharp-linuxmusl-arm64@0.35.5': + resolution: {integrity: sha512-9HbMclmI1zlNkFRs3z9/eBtDjfD0sGlrX1z6b1qwmiFY5ElDLh4BC0LPBdVp7z1DXFiKlIcznf+ZlsuZzLxQqg==} engines: {node: '>=20.9.0'} cpu: [arm64] os: [linux] - '@img/sharp-linuxmusl-x64@0.35.3': - resolution: {integrity: sha512-6O1NPKcDVj9QEdg7Hx549EX8U0rp6yXQERqru6yRN7fGBn32UvIRJUlWnk+8xDCiG76hXVBbX82NZ/ZKr0euIg==} + '@img/sharp-linuxmusl-x64@0.35.5': + resolution: {integrity: sha512-4KOphqB035HrVdqLZfCgMzzERrQkkzOwRhl4OAkRO1YCldbaFjySXMaK534Mo0V+LndnlJk+sbUyLeU0ULyD1A==} engines: {node: '>=20.9.0'} cpu: [x64] os: [linux] - '@img/sharp-wasm32@0.35.3': - resolution: {integrity: sha512-cZ0XkcYGpHZkqW6iCkqTcmUC0CD9DhD5d/qeZlZkfRBn6GnHniZXLUo5+9xw8Iv76YE6LQFN9YNBlKREcCG76w==} + '@img/sharp-wasm32@0.35.5': + resolution: {integrity: sha512-Ptsga1su4tQx+LLF1ECS9U6nz5kmrXKo6XVbtR48Ke3ZRxxgaWBu7IDtEe1quo8hiupwm6WFqxVlXaSf7IINGQ==} engines: {node: '>=20.9.0'} - '@img/sharp-webcontainers-wasm32@0.35.3': - resolution: {integrity: sha512-2rnq7bX3NzeR2T4YWgz8qiG4h3TSdMe+vN1iQXpJleSJ3SM5zQ8Fy2SyyXAWlbxpEZ2Y+Z4u1BePgJEYbSy80Q==} + '@img/sharp-webcontainers-wasm32@0.35.5': + resolution: {integrity: sha512-hfhF/FmoQyTUkA0bIKFOtw536BQSeBMe6BF6QyWlrPxT754+TFLaZ7sKKTfvvM0yJgKgaYTwnFCIZ/GuDw5SUA==} engines: {node: '>=20.9.0'} cpu: [wasm32] - '@img/sharp-win32-arm64@0.35.3': - resolution: {integrity: sha512-4bPwFdMbeC4JQ8L8LOyWp6nsHcboP5fxkp6iPOXz2Vg49R42TuMs2whkJ5OAP4/Ul035qOzy0AecOF9VOscn4w==} + '@img/sharp-win32-arm64@0.35.5': + resolution: {integrity: sha512-X4t7g+7ZA5DKblCBEXGjUqqemj4vczING/5viFwAL8h4N3qYeyjwdCvRLHi4EdOUI+2Z7UFlp1VM+p/AuEtm6Q==} engines: {node: '>=20.9.0'} cpu: [arm64] os: [win32] - '@img/sharp-win32-ia32@0.35.3': - resolution: {integrity: sha512-r53mXsBN6lFUDiST764SvgwUdHAqM4rPAiDzAmf4fLoB6X/rkfyTrLCg6+g17wJJiCmB3JYgHuUldCWUIRFSXw==} + '@img/sharp-win32-ia32@0.35.5': + resolution: {integrity: sha512-5Zm82LoBc43nhwNybZlG7Y1KO//Zhsn306fQl29ZOuStHLGTo3BWL83q3cznX0poxSAMuYL1On/BHBxkBeKr6A==} engines: {node: ^20.9.0} cpu: [ia32] os: [win32] - '@img/sharp-win32-x64@0.35.3': - resolution: {integrity: sha512-D4y1vNeZrIIJCN+uHaWVtH86B+aCrdMYYjicy9pXHvbGZeGYLLSd3wdVuC37FxVXlU1ARsk84eKWfWMXGYEqvA==} + '@img/sharp-win32-x64@0.35.5': + resolution: {integrity: sha512-x76eH0vEiHlcMQu8Y8IenntaACtddpT6W0wmXtWrnKcnKI7ME5DdgqhAD6SEWOEl1v2zDvkZDhFA9KnURwpfqg==} engines: {node: '>=20.9.0'} cpu: [x64] os: [win32] @@ -2107,8 +2109,8 @@ packages: aws4@1.13.2: resolution: {integrity: sha512-lHe62zvbTB5eEABUVi/AwVh0ZKY9rMMDhmm+eeyuuUQbQ3+J+fONVQOZyj+DdrvD4BY33uYniyRJ4UJIaSKAfw==} - axios@1.18.1: - resolution: {integrity: sha512-3nTvFlvpn9Zu/RkHUqtc7/+al4UpRW5az71ap5zccp6e8RAYEzhMTecX8Dz1wWDYrPpUoB1HAQEGEAEvUr7S9g==} + axios@1.20.0: + resolution: {integrity: sha512-r8aOh8j9cGKpgQAqpzrUHnSIc6a59Y3Xf/cv8sy1DrHCkZHzQGEuoq1tARk6qSyDdtQGSDgpb9kFlruzPvrgwg==} babel-jest@29.7.0: resolution: {integrity: sha512-BrvGY3xZSwEcCzKvKsCi2GgHqDqsYkOP4/by5xCgIwGXQxIEh+8ew3gmrE1y7XRR6LHZIj6yLYnUi/mm2KXKBg==} @@ -2153,8 +2155,8 @@ packages: engines: {node: '>=6.0.0'} hasBin: true - basic-ftp@5.3.1: - resolution: {integrity: sha512-bopVNp6ugyA150DDuZfPFdt1KZ5a94ZDiwX4hMgZDzF+GttD80lEy8kj98kbyhLXnPvhtIo93mdnLIjpCAeeOw==} + basic-ftp@6.2.1: + resolution: {integrity: sha512-bK67isD+lKq46AU8vNtjvMaT2ZqAOAmNCbxUHlFBRD4k15NWxyEjmaKtZPlgce58So4BNTjITGQOVTjL9y0ECA==} engines: {node: '>=10.0.0'} better-sqlite3@12.10.0: @@ -2184,8 +2186,8 @@ packages: brace-expansion@1.1.16: resolution: {integrity: sha512-IDw48K2/2kRkg9LdJxurvq3lV3aBgq0REY89duEqFRthjlPdXHKMj7EnQOXVckxzgisinf3nHfrcE2FufFLXMw==} - brace-expansion@2.1.4: - resolution: {integrity: sha512-hGfVzPxthbf3+2yjg/RBs60cB0FhqBS/zvdV/4wn4/BmN0bNMMHPc4V/BbFieqf1TKAGGAHnY4eSjajCl0f2Xg==} + brace-expansion@2.1.7: + resolution: {integrity: sha512-uZbew1NqdmPDTMJ8ah1y+b+9QEJrfkXFk3RcTQw3X0jW/xRUvFKsg1CfQdSYGdTbXZWExtU3J3ccxtnfw1Fi0g==} brace-expansion@5.0.8: resolution: {integrity: sha512-JZyDyq3D4AUifKTPOB7DELf6XsB3WdPuNxCtob1vFXPsSXhdAiHBWJ/tJ8HAc9aH84BK+5JFZLNkJKx3G9kzQg==} @@ -3282,8 +3284,8 @@ packages: js-tokens@4.0.0: resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==} - js-yaml@3.15.1: - resolution: {integrity: sha512-S99WuO3HlhO3XN41EtYUNl9zzXjoJx7QvmipxsJVxtCBT0YHEFy+iOJhjSvrmV12nYhWpZaM8lPHkJm0yUMbag==} + js-yaml@3.15.2: + resolution: {integrity: sha512-6EuL879VkRA+1Cz578mKMiKvjPNEuk6+r1JaFzoSWejZmtf7xWbIyw1e3KkxlkzTIt9Taw6JBhEppG7utc1P+w==} hasBin: true jsesc@3.1.0: @@ -4209,8 +4211,8 @@ packages: resolution: {integrity: sha512-8I8TjW5KMOKsZQTvoxjuSIa7foAwPWGOts+6o7sgjz41/qMD9VQHEDxi6PBvK2l0MXUmqZyNpUK+T2tQaaElvw==} engines: {node: '>=10'} - sharp@0.35.3: - resolution: {integrity: sha512-ej0zVHuZGHCiABXcNxeYhpRnPNPAcvbG8RMdBAhDAxLKkCRVSpK3Iyu7qbqw3JMzoj0REeM6f3tJLtVwl0023Q==} + sharp@0.35.5: + resolution: {integrity: sha512-Ywn4OnzGukp7CDMrp08RQ50YKmuwG47brZgIVPTvBaaAfQlRlygrRqSrxdCiL9M+LlzLBiJ68IR1QqvzHyjC7g==} engines: {node: '>=20.9.0'} peerDependencies: '@types/node': '*' @@ -6142,7 +6144,7 @@ snapshots: transitivePeerDependencies: - supports-color - '@emnapi/runtime@1.11.2': + '@emnapi/runtime@1.11.3': dependencies: tslib: 2.8.1 optional: true @@ -6246,7 +6248,7 @@ snapshots: dependencies: graphql: 16.14.2 - '@grpc/grpc-js@1.14.4': + '@grpc/grpc-js@1.14.5': dependencies: '@grpc/proto-loader': 0.8.1 '@js-sdsl/ordered-map': 4.4.2 @@ -6279,7 +6281,7 @@ snapshots: '@huggingface/tokenizers': 0.1.3 onnxruntime-node: 1.24.3 onnxruntime-web: 1.26.0-dev.20260416-b7804b056c - sharp: 0.35.3(@types/node@22.19.21) + sharp: 0.35.5(@types/node@22.19.21) transitivePeerDependencies: - '@types/node' @@ -6290,108 +6292,108 @@ snapshots: '@img/colour@1.1.0': {} - '@img/sharp-darwin-arm64@0.35.3': + '@img/sharp-darwin-arm64@0.35.5': optionalDependencies: - '@img/sharp-libvips-darwin-arm64': 1.3.2 + '@img/sharp-libvips-darwin-arm64': 1.3.4 optional: true - '@img/sharp-darwin-x64@0.35.3': + '@img/sharp-darwin-x64@0.35.5': optionalDependencies: - '@img/sharp-libvips-darwin-x64': 1.3.2 + '@img/sharp-libvips-darwin-x64': 1.3.4 optional: true - '@img/sharp-freebsd-wasm32@0.35.3': + '@img/sharp-freebsd-wasm32@0.35.5': dependencies: - '@img/sharp-wasm32': 0.35.3 + '@img/sharp-wasm32': 0.35.5 optional: true - '@img/sharp-libvips-darwin-arm64@1.3.2': + '@img/sharp-libvips-darwin-arm64@1.3.4': optional: true - '@img/sharp-libvips-darwin-x64@1.3.2': + '@img/sharp-libvips-darwin-x64@1.3.4': optional: true - '@img/sharp-libvips-linux-arm64@1.3.2': + '@img/sharp-libvips-linux-arm64@1.3.4': optional: true - '@img/sharp-libvips-linux-arm@1.3.2': + '@img/sharp-libvips-linux-arm@1.3.4': optional: true - '@img/sharp-libvips-linux-ppc64@1.3.2': + '@img/sharp-libvips-linux-ppc64@1.3.4': optional: true - '@img/sharp-libvips-linux-riscv64@1.3.2': + '@img/sharp-libvips-linux-riscv64@1.3.4': optional: true - '@img/sharp-libvips-linux-s390x@1.3.2': + '@img/sharp-libvips-linux-s390x@1.3.4': optional: true - '@img/sharp-libvips-linux-x64@1.3.2': + '@img/sharp-libvips-linux-x64@1.3.4': optional: true - '@img/sharp-libvips-linuxmusl-arm64@1.3.2': + '@img/sharp-libvips-linuxmusl-arm64@1.3.4': optional: true - '@img/sharp-libvips-linuxmusl-x64@1.3.2': + '@img/sharp-libvips-linuxmusl-x64@1.3.4': optional: true - '@img/sharp-linux-arm64@0.35.3': + '@img/sharp-linux-arm64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-arm64': 1.3.2 + '@img/sharp-libvips-linux-arm64': 1.3.4 optional: true - '@img/sharp-linux-arm@0.35.3': + '@img/sharp-linux-arm@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-arm': 1.3.2 + '@img/sharp-libvips-linux-arm': 1.3.4 optional: true - '@img/sharp-linux-ppc64@0.35.3': + '@img/sharp-linux-ppc64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-ppc64': 1.3.2 + '@img/sharp-libvips-linux-ppc64': 1.3.4 optional: true - '@img/sharp-linux-riscv64@0.35.3': + '@img/sharp-linux-riscv64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-riscv64': 1.3.2 + '@img/sharp-libvips-linux-riscv64': 1.3.4 optional: true - '@img/sharp-linux-s390x@0.35.3': + '@img/sharp-linux-s390x@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-s390x': 1.3.2 + '@img/sharp-libvips-linux-s390x': 1.3.4 optional: true - '@img/sharp-linux-x64@0.35.3': + '@img/sharp-linux-x64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-x64': 1.3.2 + '@img/sharp-libvips-linux-x64': 1.3.4 optional: true - '@img/sharp-linuxmusl-arm64@0.35.3': + '@img/sharp-linuxmusl-arm64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linuxmusl-arm64': 1.3.2 + '@img/sharp-libvips-linuxmusl-arm64': 1.3.4 optional: true - '@img/sharp-linuxmusl-x64@0.35.3': + '@img/sharp-linuxmusl-x64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linuxmusl-x64': 1.3.2 + '@img/sharp-libvips-linuxmusl-x64': 1.3.4 optional: true - '@img/sharp-wasm32@0.35.3': + '@img/sharp-wasm32@0.35.5': dependencies: - '@emnapi/runtime': 1.11.2 + '@emnapi/runtime': 1.11.3 optional: true - '@img/sharp-webcontainers-wasm32@0.35.3': + '@img/sharp-webcontainers-wasm32@0.35.5': dependencies: - '@img/sharp-wasm32': 0.35.3 + '@img/sharp-wasm32': 0.35.5 optional: true - '@img/sharp-win32-arm64@0.35.3': + '@img/sharp-win32-arm64@0.35.5': optional: true - '@img/sharp-win32-ia32@0.35.3': + '@img/sharp-win32-ia32@0.35.5': optional: true - '@img/sharp-win32-x64@0.35.3': + '@img/sharp-win32-x64@0.35.5': optional: true '@iovalkey/commands@0.1.0': {} @@ -6414,7 +6416,7 @@ snapshots: camelcase: 5.3.1 find-up: 4.1.0 get-package-type: 0.1.0 - js-yaml: 3.15.1 + js-yaml: 3.15.2 resolve-from: 5.0.0 '@istanbuljs/schema@0.1.6': {} @@ -7320,7 +7322,7 @@ snapshots: '@zilliz/milvus2-sdk-node@3.0.3': dependencies: - '@grpc/grpc-js': 1.14.4 + '@grpc/grpc-js': 1.14.5 '@grpc/proto-loader': 0.8.1 '@opentelemetry/api': 1.9.1 '@petamoriken/float16': 3.9.3 @@ -7432,7 +7434,7 @@ snapshots: aws4@1.13.2: {} - axios@1.18.1: + axios@1.20.0: dependencies: follow-redirects: 1.16.0 form-data: 4.0.6 @@ -7507,7 +7509,7 @@ snapshots: baseline-browser-mapping@2.11.21: {} - basic-ftp@5.3.1: {} + basic-ftp@6.2.1: {} better-sqlite3@12.10.0: dependencies: @@ -7537,7 +7539,7 @@ snapshots: balanced-match: 1.0.2 concat-map: 0.0.1 - brace-expansion@2.1.4: + brace-expansion@2.1.7: dependencies: balanced-match: 1.0.2 @@ -8207,7 +8209,7 @@ snapshots: get-uri@6.0.5: dependencies: - basic-ftp: 5.3.1 + basic-ftp: 6.2.1 data-uri-to-buffer: 6.0.2 debug: 4.4.3(supports-color@5.5.0) transitivePeerDependencies: @@ -8276,7 +8278,7 @@ snapshots: google-gax@5.0.7: dependencies: - '@grpc/grpc-js': 1.14.4 + '@grpc/grpc-js': 1.14.5 '@grpc/proto-loader': 0.8.1 duplexify: 4.1.3 google-auth-library: 10.5.0 @@ -8507,7 +8509,7 @@ snapshots: '@babel/parser': 7.29.7 '@istanbuljs/schema': 0.1.6 istanbul-lib-coverage: 3.2.2 - semver: 7.8.4 + semver: 7.8.5 transitivePeerDependencies: - supports-color @@ -8855,7 +8857,7 @@ snapshots: js-tokens@4.0.0: {} - js-yaml@3.15.1: + js-yaml@3.15.2: dependencies: argparse: 1.0.10 esprima: 4.0.1 @@ -9005,7 +9007,7 @@ snapshots: make-dir@4.0.0: dependencies: - semver: 7.8.4 + semver: 7.8.5 make-error@1.3.6: {} @@ -9063,7 +9065,7 @@ snapshots: minimatch@9.0.9: dependencies: - brace-expansion: 2.1.4 + brace-expansion: 2.1.7 minimist@1.2.8: {} @@ -9200,7 +9202,7 @@ snapshots: nice-grpc@2.1.16: dependencies: - '@grpc/grpc-js': 1.14.4 + '@grpc/grpc-js': 1.14.5 abort-controller-x: 0.5.0 nice-grpc-common: 2.0.3 @@ -9770,37 +9772,37 @@ snapshots: dependencies: type-fest: 0.13.1 - sharp@0.35.3(@types/node@22.19.21): + sharp@0.35.5(@types/node@22.19.21): dependencies: '@img/colour': 1.1.0 detect-libc: 2.1.2 semver: 7.8.5 optionalDependencies: - '@img/sharp-darwin-arm64': 0.35.3 - '@img/sharp-darwin-x64': 0.35.3 - '@img/sharp-freebsd-wasm32': 0.35.3 - '@img/sharp-libvips-darwin-arm64': 1.3.2 - '@img/sharp-libvips-darwin-x64': 1.3.2 - '@img/sharp-libvips-linux-arm': 1.3.2 - '@img/sharp-libvips-linux-arm64': 1.3.2 - '@img/sharp-libvips-linux-ppc64': 1.3.2 - '@img/sharp-libvips-linux-riscv64': 1.3.2 - '@img/sharp-libvips-linux-s390x': 1.3.2 - '@img/sharp-libvips-linux-x64': 1.3.2 - '@img/sharp-libvips-linuxmusl-arm64': 1.3.2 - '@img/sharp-libvips-linuxmusl-x64': 1.3.2 - '@img/sharp-linux-arm': 0.35.3 - '@img/sharp-linux-arm64': 0.35.3 - '@img/sharp-linux-ppc64': 0.35.3 - '@img/sharp-linux-riscv64': 0.35.3 - '@img/sharp-linux-s390x': 0.35.3 - '@img/sharp-linux-x64': 0.35.3 - '@img/sharp-linuxmusl-arm64': 0.35.3 - '@img/sharp-linuxmusl-x64': 0.35.3 - '@img/sharp-webcontainers-wasm32': 0.35.3 - '@img/sharp-win32-arm64': 0.35.3 - '@img/sharp-win32-ia32': 0.35.3 - '@img/sharp-win32-x64': 0.35.3 + '@img/sharp-darwin-arm64': 0.35.5 + '@img/sharp-darwin-x64': 0.35.5 + '@img/sharp-freebsd-wasm32': 0.35.5 + '@img/sharp-libvips-darwin-arm64': 1.3.4 + '@img/sharp-libvips-darwin-x64': 1.3.4 + '@img/sharp-libvips-linux-arm': 1.3.4 + '@img/sharp-libvips-linux-arm64': 1.3.4 + '@img/sharp-libvips-linux-ppc64': 1.3.4 + '@img/sharp-libvips-linux-riscv64': 1.3.4 + '@img/sharp-libvips-linux-s390x': 1.3.4 + '@img/sharp-libvips-linux-x64': 1.3.4 + '@img/sharp-libvips-linuxmusl-arm64': 1.3.4 + '@img/sharp-libvips-linuxmusl-x64': 1.3.4 + '@img/sharp-linux-arm': 0.35.5 + '@img/sharp-linux-arm64': 0.35.5 + '@img/sharp-linux-ppc64': 0.35.5 + '@img/sharp-linux-riscv64': 0.35.5 + '@img/sharp-linux-s390x': 0.35.5 + '@img/sharp-linux-x64': 0.35.5 + '@img/sharp-linuxmusl-arm64': 0.35.5 + '@img/sharp-linuxmusl-x64': 0.35.5 + '@img/sharp-webcontainers-wasm32': 0.35.5 + '@img/sharp-win32-arm64': 0.35.5 + '@img/sharp-win32-ia32': 0.35.5 + '@img/sharp-win32-x64': 0.35.5 '@types/node': 22.19.21 shebang-command@2.0.0: diff --git a/mem0-ts/pnpm-workspace.yaml b/mem0-ts/pnpm-workspace.yaml index 61017d969..09ff00416 100644 --- a/mem0-ts/pnpm-workspace.yaml +++ b/mem0-ts/pnpm-workspace.yaml @@ -10,9 +10,9 @@ overrides: "picomatch@<2.3.2": "^2.3.2" "picomatch@>=4.0.0 <4.0.4": "^4.0.4" "jws@4.0.0": "4.0.1" - "js-yaml@<3.15.1": ">=3.15.1 <4.0.0" - "js-yaml@>=4.0.0 <4.3.1": ">=4.3.1 <5.0.0" - "sharp@<0.35.0": ">=0.35.0 <0.36.0" + "js-yaml@<3.15.2": ">=3.15.2 <4.0.0" + "js-yaml@>=4.0.0 <4.3.2": ">=4.3.2 <5.0.0" + "sharp@<0.35.4": ">=0.35.4 <0.36.0" "adm-zip@<0.6.1": ">=0.6.1 <0.7.0" "langsmith@<0.6.0": "^0.6.0" "minimatch@<3.1.3": "^3.1.3" @@ -28,9 +28,9 @@ overrides: "@modelcontextprotocol/sdk": "^1.25.4" "esbuild": ">=0.28.1" "undici@<7.29.1": ">=7.29.1 <8.0.0" - "axios@<1.18.0": ">=1.18.0 <2.0.0" + "axios@<1.20.0": ">=1.20.0 <2.0.0" "brace-expansion@<1.1.16": ">=1.1.16 <2.0.0" - "brace-expansion@>=2.0.0 <2.1.4": ">=2.1.4 <3.0.0" + "brace-expansion@>=2.0.0 <2.1.6": ">=2.1.6 <3.0.0" "brace-expansion@>=3.0.0 <5.0.8": ">=5.0.8 <6.0.0" "fast-xml-parser@>=5.0.0 <5.10.1": ">=5.10.1 <6.0.0" "tar@<7.5.21": ">=7.5.21 <8.0.0" @@ -40,6 +40,8 @@ overrides: "ip-address@<10.5.1": ">=10.5.1 <11.0.0" "browserslist@<4.28.7": ">=4.28.7 <5.0.0" "mysql2@<3.23.1": ">=3.23.1 <4.0.0" + "basic-ftp@<6.2.1": ">=6.2.1 <7.0.0" + "@grpc/grpc-js@>=1.14.0 <1.14.5": ">=1.14.5 <2.0.0" patchedDependencies: "tar@7.5.22": "patches/tar@7.5.22.patch" diff --git a/server/dashboard/package.json b/server/dashboard/package.json index d2ce90831..051a07edb 100644 --- a/server/dashboard/package.json +++ b/server/dashboard/package.json @@ -37,7 +37,7 @@ "@radix-ui/react-tooltip": "^1.0.7", "@reduxjs/toolkit": "^2.3.0", "@tanstack/react-table": "^8.17.3", - "axios": "^1.18.0", + "axios": "^1.20.0", "class-variance-authority": "^0.7.1", "clsx": "^2.1.0", "cmdk": "^1.0.0", diff --git a/server/dashboard/pnpm-lock.yaml b/server/dashboard/pnpm-lock.yaml index 1fe88f38f..a67dc5898 100644 --- a/server/dashboard/pnpm-lock.yaml +++ b/server/dashboard/pnpm-lock.yaml @@ -8,14 +8,14 @@ overrides: form-data@<4.0.6: '>=4.0.6' prismjs@<1.30.0: '>=1.30.0' uuid@<11.1.1: '>=11.1.1' - axios@<1.18.0: '>=1.18.0 <2.0.0' + axios@<1.20.0: '>=1.20.0 <2.0.0' brace-expansion@<1.1.16: '>=1.1.16 <2.0.0' brace-expansion@>=3.0.0 <5.0.8: '>=5.0.8 <6.0.0' - js-yaml@<3.15.1: '>=3.15.1 <4.0.0' - js-yaml@>=4.0.0 <4.3.1: '>=4.3.1 <5.0.0' + js-yaml@<3.15.2: '>=3.15.2 <4.0.0' + js-yaml@>=4.0.0 <4.3.2: '>=4.3.2 <5.0.0' postcss@<8.5.18: '>=8.5.18 <9.0.0' nanoid@<3.3.18: '>=3.3.18 <4.0.0' - sharp@<0.35.0: '>=0.35.0 <0.36.0' + sharp@<0.35.4: '>=0.35.4 <0.36.0' browserslist@<4.28.7: '>=4.28.7 <5.0.0' importers: @@ -98,8 +98,8 @@ importers: specifier: ^8.17.3 version: 8.21.3(react-dom@19.2.7(react@19.2.7))(react@19.2.7) axios: - specifier: ^1.18.0 - version: 1.18.1 + specifier: ^1.20.0 + version: 1.20.0 class-variance-authority: specifier: ^0.7.1 version: 0.7.1 @@ -299,160 +299,160 @@ packages: resolution: {integrity: sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ==} engines: {node: '>=18'} - '@img/sharp-darwin-arm64@0.35.3': - resolution: {integrity: sha512-RMnFX7YQsMoh7lWfcM4NEHHymBX/rLuKNPVM84XE9ONPcaSCDgE7CHIHpSgPcO2xcRthgBy1HfNO319mwhIAkg==} + '@img/sharp-darwin-arm64@0.35.5': + resolution: {integrity: sha512-QRUlFQ0WxvdWyqqG/WtI3iupfD5rBzmCHXSdPsY91sAtVtTo7Q4cb6zOccZ3gqEqkr0f1As1ehLqmEpDsRf+lg==} engines: {node: '>=20.9.0'} cpu: [arm64] os: [darwin] - '@img/sharp-darwin-x64@0.35.3': - resolution: {integrity: sha512-Xo+5uFBtLN0BKqieTxiFzFPQAUlBbbH5iBKyRX/z1JrbnYsHTfKJnUfL8+p2TPXr1pXqao4eeL4Rl144uDpK9w==} + '@img/sharp-darwin-x64@0.35.5': + resolution: {integrity: sha512-+BR255RhDlpygUpOc/Jdt1nT6DQ3XG/ERo5wbcdOf5Q320dKtPCKPLR1LJs9VGXRaMa8l1uUa0tkCNOXiAxZUw==} engines: {node: '>=20.9.0'} cpu: [x64] os: [darwin] - '@img/sharp-freebsd-wasm32@0.35.3': - resolution: {integrity: sha512-lUxcqWIj2wMQ9BrwNjngcr1gWUr5xgaGThBRqPPalIC2n67Cqj1uPh8NnA/ZhAg8hUbKl+kVHKwgUIwe6ZYPrg==} + '@img/sharp-freebsd-wasm32@0.35.5': + resolution: {integrity: sha512-Y/z91nEZ4uIBX5X3nfTovjU9lHNKFYbL2lpHCLVNmXQK03VIZvXBBt0KxbPGp2SdGSF+2mQU4e+hQaWOt86iAw==} engines: {node: '>=20.9.0'} os: [freebsd] - '@img/sharp-libvips-darwin-arm64@1.3.2': - resolution: {integrity: sha512-9J6ypZFpQBj4YnePGoq/S38w6nz+vqg5WZLrLGY4YuSemdMq47GMLBPO42MzwdGwpg/agZ7xzZcFHa48xlywfg==} + '@img/sharp-libvips-darwin-arm64@1.3.4': + resolution: {integrity: sha512-5R89nBYiRdUlSWJxPhO+GVtaXzXSxKnRu/xqMn3KTA3L9EB9Oy/P+Nn2f2vlhPuUdy/Zusb2DarbyTpGCfEDuw==} cpu: [arm64] os: [darwin] - '@img/sharp-libvips-darwin-x64@1.3.2': - resolution: {integrity: sha512-m2pW1n6cns9VaubNwsZ+c3CRYjxNQWgJ5gPlnL1nbBcpkBvFm6SCFN5o0psFHI8w9n11NKhFkeEDns98tiqbEw==} + '@img/sharp-libvips-darwin-x64@1.3.4': + resolution: {integrity: sha512-iR2OKH80yi0U+dUplyh3/xdpFvps6YkCwsXenIJxqxR1v9o+xtKTGbS9H7cps+2Vxjc8B1j96p75NmTGjIhtpQ==} cpu: [x64] os: [darwin] - '@img/sharp-libvips-linux-arm64@1.3.2': - resolution: {integrity: sha512-dqVSFynCox4C/J8kT16V7SIFAns0IjgLwkvYT7p8LQVmJ5OS5b6tI9IGflxTeuBS//zXeFIUbwt5dwxyZ17cnA==} + '@img/sharp-libvips-linux-arm64@1.3.4': + resolution: {integrity: sha512-Y3dgX/6lE2QhQb+Gxy0WZxfg9MEm/JBjamZpS2IklP7xIQoKN4hzAm7KcMVGtaVDt3neE9OKBC7vAfonA/Lr1A==} cpu: [arm64] os: [linux] libc: [glibc] - '@img/sharp-libvips-linux-arm@1.3.2': - resolution: {integrity: sha512-1eMLzy92I4J6rmi4mAT8yC3HxOtniyGELlzGbNMLLeqe052ahFQ0h6LFq+lh5DsDIdYViIDst08abvSbcEdLXQ==} + '@img/sharp-libvips-linux-arm@1.3.4': + resolution: {integrity: sha512-LmRtTsOHuvM2+wlO2Db37dx5MiZhB0FvSunciw48YjdOkZz9KAiRbm8ujeMOA1INqmei5NapFxYEK1D1ZSidmw==} cpu: [arm] os: [linux] libc: [glibc] - '@img/sharp-libvips-linux-ppc64@1.3.2': - resolution: {integrity: sha512-3z0NHDxD6n5I9gc05U1eW1AyRm+Gznzq3naMrthPNqE6oYykcogW0l/jfpJdjYnuNl8R7yI9pNbE1XiUeyq0Aw==} + '@img/sharp-libvips-linux-ppc64@1.3.4': + resolution: {integrity: sha512-Le6boB8Tai0Nis+gIxIpKx68UDVVIqdR8Tin5Yf1z2LJJQLDJvCDRqRu+jC2qCoD+eIomonmOwB4smBRxfVpYQ==} cpu: [ppc64] os: [linux] libc: [glibc] - '@img/sharp-libvips-linux-riscv64@1.3.2': - resolution: {integrity: sha512-bsb4rI+NldGOsXuej2r8OdSS8+zXDVaCWxyWrcv6kneTOlgAHtZABRzBBCwdsPiD90J4myNJuHpg6kA20ImW/w==} + '@img/sharp-libvips-linux-riscv64@1.3.4': + resolution: {integrity: sha512-aHkkIEHPRdQEegJN20MLmGtxYD9R2wQr3Cwpddnu5+YKMt6Uzax7S9h5gpZTo8wyrGuZSlfQ63OevL5mTyOC7Q==} cpu: [riscv64] os: [linux] libc: [glibc] - '@img/sharp-libvips-linux-s390x@1.3.2': - resolution: {integrity: sha512-/ABshyj8gCpyIrNXnHn4LorDJ0HHm1VhXPBlxZ8zAtfVPAaSafXPGn+sUSIRiwaSBy0mmFjSjiXI5mkcwdChKQ==} + '@img/sharp-libvips-linux-s390x@1.3.4': + resolution: {integrity: sha512-ra/mB6MikESDUO7Yg+Mi95bFBb9GsObURuhnOv3OqknjGe9sZrG8tCe9q0xSIGrtLgvgw0gKnFWcK4blSgQOuQ==} cpu: [s390x] os: [linux] libc: [glibc] - '@img/sharp-libvips-linux-x64@1.3.2': - resolution: {integrity: sha512-ITPEtgffGJ0S6G9dRyw/366tJQqFRcHWPHhC+Stpg3Z8AEMrDrTr2lhdz4f/Y/HMbRh//7Z5mBzEpVdi62Oc3w==} + '@img/sharp-libvips-linux-x64@1.3.4': + resolution: {integrity: sha512-GJ//SSXbnwSDes02umB3nDJLFcQzw8a18V8fyhqr6tV515tOEMdImjjxj1AoafMRz56F3PHgftnj1QEKSU1zkw==} cpu: [x64] os: [linux] libc: [glibc] - '@img/sharp-libvips-linuxmusl-arm64@1.3.2': - resolution: {integrity: sha512-zE9EdiUzUmg5mDT5a1rk5fYJ6GWPloTwWBYDS14naqHsL+EaMpDj1AWnpLgh3u0YCORv2Tt50wrcrpYqkP97Kw==} + '@img/sharp-libvips-linuxmusl-arm64@1.3.4': + resolution: {integrity: sha512-hvulFwtjUcagsis6BBxHwGFwWoNZjgYmULGVrZcyfNbjA8hKILbRxGg15/7w5HDyXHXUos/j6baAWqnCyQ2DWA==} cpu: [arm64] os: [linux] libc: [musl] - '@img/sharp-libvips-linuxmusl-x64@1.3.2': - resolution: {integrity: sha512-m0lrLiUt+lBYnCFr8qV/65yMR4E/c7/wf78I5eKTdkEakFAlZ9QlzEM3QIhhAwVeUhLAHLcCq7a7Vszq/oFNZQ==} + '@img/sharp-libvips-linuxmusl-x64@1.3.4': + resolution: {integrity: sha512-6zXKeE/p39I1AmA3cJG35eyBGNqNddLnUXjhwBnsGjFPWqf5VKkDBEqaEkPDoTEtkxwi2vv8Tcr2mDyP4So7Fg==} cpu: [x64] os: [linux] libc: [musl] - '@img/sharp-linux-arm64@0.35.3': - resolution: {integrity: sha512-QgKDspHPnrU+GQ55XPhGwyhC8acLVOOSyAvo1oVfFmrIXLkDNmGWzAfDZ4xK8oSA1qBQrALcHX0G5UZni/SuFQ==} + '@img/sharp-linux-arm64@0.35.5': + resolution: {integrity: sha512-LYVx5JTsOM2CBzmxreh+nl64/3H6Xb09iSLknqH47z2T2DFFxDeFLP5y4dJwe6H7uGQlHPyEEtIqyo3DYsRwdQ==} engines: {node: '>=20.9.0'} cpu: [arm64] os: [linux] libc: [glibc] - '@img/sharp-linux-arm@0.35.3': - resolution: {integrity: sha512-affVWCTLooy8TSxbDx2qkzuDeaWLNVBA+P//FNBirHsXpP2fuBhk5AuboYUnrDnzoXes8GFjpTx0SBFOCRg+FA==} + '@img/sharp-linux-arm@0.35.5': + resolution: {integrity: sha512-LEaXK2WdXVK5ykcw0buWyPMsmLLL2vpHLD6yrNSW+JGEL3BZPA4tpKN6iaMc4AxTTAoaX/sU1rOL51lcIz48ZQ==} engines: {node: '>=20.9.0'} cpu: [arm] os: [linux] libc: [glibc] - '@img/sharp-linux-ppc64@0.35.3': - resolution: {integrity: sha512-sMd8rDxmpLOwv/7N44klFjOD5DUO7FLdjiXDI0hoxYaf7Ar262dQIEkosE98bps+5HPLtp/EvNqeqQtOycP/IA==} + '@img/sharp-linux-ppc64@0.35.5': + resolution: {integrity: sha512-QVxAAq8evVRI9ia2vqgwrmWucn5Dfv+JdWzj75pD8omHLPSP7f8p20O8jxzjCcuCEQEOtYOZUmX1hkiZ0kdevA==} engines: {node: '>=20.9.0'} cpu: [ppc64] os: [linux] libc: [glibc] - '@img/sharp-linux-riscv64@0.35.3': - resolution: {integrity: sha512-0Eob78yjlYPfL5vMNWAW55l3R9Y6BQS/gOfe0ZcP9mEz9ohhKSt4im1hayiknXgf8AWrFqMvJcKIdmLmEe7yeQ==} + '@img/sharp-linux-riscv64@0.35.5': + resolution: {integrity: sha512-LtdreXguaavKODPIfzJ4kffx7UNt1omwtK0rch4EBbbSTXPnxWmYSayXdLJw0fJzQ97kHt1gL/yh4tvU+nCyRQ==} engines: {node: '>=20.9.0'} cpu: [riscv64] os: [linux] libc: [glibc] - '@img/sharp-linux-s390x@0.35.3': - resolution: {integrity: sha512-KgAxQ0DxpNOq1rG2t5cgTgShJFGSuU7XO45cqC+1NVOuZnP6tlgZRuSYOfNupGkHID0o3cJOsw4DVeJpMovcGw==} + '@img/sharp-linux-s390x@0.35.5': + resolution: {integrity: sha512-UZasTOFiYzotTsGOCu42BfUzP6Tu6Do/947iRm1RsLKvlllxwGcn4RN27LibGWceix4Y+Pmw3jsnTcCQIgWjqA==} engines: {node: '>=20.9.0'} cpu: [s390x] os: [linux] libc: [glibc] - '@img/sharp-linux-x64@0.35.3': - resolution: {integrity: sha512-8pqvxubL2PGdhlPy6GLqzDYMUjyRmKAwKHYKixpdJYBUK7PJ0C029XdsnpFIdgRZG68fZiGdHVWcKPvtiPB4cA==} + '@img/sharp-linux-x64@0.35.5': + resolution: {integrity: sha512-SxFtLTeJInhAA9Q836kux2vZNeOBQEx658qvbboZScr0wIARym3IcGmW7KpVD5sbVg0Ojy+udFQdayYIZyoNog==} engines: {node: '>=20.9.0'} cpu: [x64] os: [linux] libc: [glibc] - '@img/sharp-linuxmusl-arm64@0.35.3': - resolution: {integrity: sha512-Vz0iQjzzcSX3HCbfwFfCSG/9SCIqyO0mH2sXyiHaAYfBk0cRsCWXRyQYX0ovCK/PAQBbTzQ0dsPQHh5MAFL59w==} + '@img/sharp-linuxmusl-arm64@0.35.5': + resolution: {integrity: sha512-9HbMclmI1zlNkFRs3z9/eBtDjfD0sGlrX1z6b1qwmiFY5ElDLh4BC0LPBdVp7z1DXFiKlIcznf+ZlsuZzLxQqg==} engines: {node: '>=20.9.0'} cpu: [arm64] os: [linux] libc: [musl] - '@img/sharp-linuxmusl-x64@0.35.3': - resolution: {integrity: sha512-6O1NPKcDVj9QEdg7Hx549EX8U0rp6yXQERqru6yRN7fGBn32UvIRJUlWnk+8xDCiG76hXVBbX82NZ/ZKr0euIg==} + '@img/sharp-linuxmusl-x64@0.35.5': + resolution: {integrity: sha512-4KOphqB035HrVdqLZfCgMzzERrQkkzOwRhl4OAkRO1YCldbaFjySXMaK534Mo0V+LndnlJk+sbUyLeU0ULyD1A==} engines: {node: '>=20.9.0'} cpu: [x64] os: [linux] libc: [musl] - '@img/sharp-wasm32@0.35.3': - resolution: {integrity: sha512-cZ0XkcYGpHZkqW6iCkqTcmUC0CD9DhD5d/qeZlZkfRBn6GnHniZXLUo5+9xw8Iv76YE6LQFN9YNBlKREcCG76w==} + '@img/sharp-wasm32@0.35.5': + resolution: {integrity: sha512-Ptsga1su4tQx+LLF1ECS9U6nz5kmrXKo6XVbtR48Ke3ZRxxgaWBu7IDtEe1quo8hiupwm6WFqxVlXaSf7IINGQ==} engines: {node: '>=20.9.0'} - '@img/sharp-webcontainers-wasm32@0.35.3': - resolution: {integrity: sha512-2rnq7bX3NzeR2T4YWgz8qiG4h3TSdMe+vN1iQXpJleSJ3SM5zQ8Fy2SyyXAWlbxpEZ2Y+Z4u1BePgJEYbSy80Q==} + '@img/sharp-webcontainers-wasm32@0.35.5': + resolution: {integrity: sha512-hfhF/FmoQyTUkA0bIKFOtw536BQSeBMe6BF6QyWlrPxT754+TFLaZ7sKKTfvvM0yJgKgaYTwnFCIZ/GuDw5SUA==} engines: {node: '>=20.9.0'} cpu: [wasm32] - '@img/sharp-win32-arm64@0.35.3': - resolution: {integrity: sha512-4bPwFdMbeC4JQ8L8LOyWp6nsHcboP5fxkp6iPOXz2Vg49R42TuMs2whkJ5OAP4/Ul035qOzy0AecOF9VOscn4w==} + '@img/sharp-win32-arm64@0.35.5': + resolution: {integrity: sha512-X4t7g+7ZA5DKblCBEXGjUqqemj4vczING/5viFwAL8h4N3qYeyjwdCvRLHi4EdOUI+2Z7UFlp1VM+p/AuEtm6Q==} engines: {node: '>=20.9.0'} cpu: [arm64] os: [win32] - '@img/sharp-win32-ia32@0.35.3': - resolution: {integrity: sha512-r53mXsBN6lFUDiST764SvgwUdHAqM4rPAiDzAmf4fLoB6X/rkfyTrLCg6+g17wJJiCmB3JYgHuUldCWUIRFSXw==} + '@img/sharp-win32-ia32@0.35.5': + resolution: {integrity: sha512-5Zm82LoBc43nhwNybZlG7Y1KO//Zhsn306fQl29ZOuStHLGTo3BWL83q3cznX0poxSAMuYL1On/BHBxkBeKr6A==} engines: {node: ^20.9.0} cpu: [ia32] os: [win32] - '@img/sharp-win32-x64@0.35.3': - resolution: {integrity: sha512-D4y1vNeZrIIJCN+uHaWVtH86B+aCrdMYYjicy9pXHvbGZeGYLLSd3wdVuC37FxVXlU1ARsk84eKWfWMXGYEqvA==} + '@img/sharp-win32-x64@0.35.5': + resolution: {integrity: sha512-x76eH0vEiHlcMQu8Y8IenntaACtddpT6W0wmXtWrnKcnKI7ME5DdgqhAD6SEWOEl1v2zDvkZDhFA9KnURwpfqg==} engines: {node: '>=20.9.0'} cpu: [x64] os: [win32] @@ -1494,8 +1494,8 @@ packages: resolution: {integrity: sha512-s7iGf5GaVMxEG0ENN9x+xTr7GFZCb1ZP/1uATUpCEK2X78nDB3RwbtFCo9pGAf9ru+VwoQ464DkaLEeRM08wJA==} engines: {node: '>=4'} - axios@1.18.1: - resolution: {integrity: sha512-3nTvFlvpn9Zu/RkHUqtc7/+al4UpRW5az71ap5zccp6e8RAYEzhMTecX8Dz1wWDYrPpUoB1HAQEGEAEvUr7S9g==} + axios@1.20.0: + resolution: {integrity: sha512-r8aOh8j9cGKpgQAqpzrUHnSIc6a59Y3Xf/cv8sy1DrHCkZHzQGEuoq1tARk6qSyDdtQGSDgpb9kFlruzPvrgwg==} axobject-query@4.1.0: resolution: {integrity: sha512-qIj0G9wZbMGNLjLmg1PT6v2mE9AH2zlnADJD/2tC6E00hgmhUOfEB6greHPAfLRSufHqROIUTkw6E+M3lH0PTQ==} @@ -2292,8 +2292,8 @@ packages: js-tokens@4.0.0: resolution: {integrity: sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==} - js-yaml@4.3.1: - resolution: {integrity: sha512-CY6crGq313MX8GkwvB7tzgp99vjQxY1++5y10/BKN/GUfHqWaOGQMNZkBvqSzsZKWk/ijwHlWzzkLulsGHhjWQ==} + js-yaml@4.3.2: + resolution: {integrity: sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA==} hasBin: true json-buffer@3.0.1: @@ -2832,8 +2832,8 @@ packages: resolution: {integrity: sha512-RJRdvCo6IAnPdsvP/7m6bsQqNnn1FCBX5ZNtFL98MmFF/4xAIJTIg1YbHW5DC2W5SKZanrC6i4HsJqlajw/dZw==} engines: {node: '>= 0.4'} - sharp@0.35.3: - resolution: {integrity: sha512-ej0zVHuZGHCiABXcNxeYhpRnPNPAcvbG8RMdBAhDAxLKkCRVSpK3Iyu7qbqw3JMzoj0REeM6f3tJLtVwl0023Q==} + sharp@0.35.5: + resolution: {integrity: sha512-Ywn4OnzGukp7CDMrp08RQ50YKmuwG47brZgIVPTvBaaAfQlRlygrRqSrxdCiL9M+LlzLBiJ68IR1QqvzHyjC7g==} engines: {node: '>=20.9.0'} peerDependencies: '@types/node': '*' @@ -3174,7 +3174,7 @@ snapshots: globals: 13.24.0 ignore: 5.3.2 import-fresh: 3.3.1 - js-yaml: 4.3.1 + js-yaml: 4.3.2 minimatch: 3.1.5 strip-json-comments: 3.1.1 transitivePeerDependencies: @@ -3218,108 +3218,108 @@ snapshots: '@img/colour@1.1.0': optional: true - '@img/sharp-darwin-arm64@0.35.3': + '@img/sharp-darwin-arm64@0.35.5': optionalDependencies: - '@img/sharp-libvips-darwin-arm64': 1.3.2 + '@img/sharp-libvips-darwin-arm64': 1.3.4 optional: true - '@img/sharp-darwin-x64@0.35.3': + '@img/sharp-darwin-x64@0.35.5': optionalDependencies: - '@img/sharp-libvips-darwin-x64': 1.3.2 + '@img/sharp-libvips-darwin-x64': 1.3.4 optional: true - '@img/sharp-freebsd-wasm32@0.35.3': + '@img/sharp-freebsd-wasm32@0.35.5': dependencies: - '@img/sharp-wasm32': 0.35.3 + '@img/sharp-wasm32': 0.35.5 optional: true - '@img/sharp-libvips-darwin-arm64@1.3.2': + '@img/sharp-libvips-darwin-arm64@1.3.4': optional: true - '@img/sharp-libvips-darwin-x64@1.3.2': + '@img/sharp-libvips-darwin-x64@1.3.4': optional: true - '@img/sharp-libvips-linux-arm64@1.3.2': + '@img/sharp-libvips-linux-arm64@1.3.4': optional: true - '@img/sharp-libvips-linux-arm@1.3.2': + '@img/sharp-libvips-linux-arm@1.3.4': optional: true - '@img/sharp-libvips-linux-ppc64@1.3.2': + '@img/sharp-libvips-linux-ppc64@1.3.4': optional: true - '@img/sharp-libvips-linux-riscv64@1.3.2': + '@img/sharp-libvips-linux-riscv64@1.3.4': optional: true - '@img/sharp-libvips-linux-s390x@1.3.2': + '@img/sharp-libvips-linux-s390x@1.3.4': optional: true - '@img/sharp-libvips-linux-x64@1.3.2': + '@img/sharp-libvips-linux-x64@1.3.4': optional: true - '@img/sharp-libvips-linuxmusl-arm64@1.3.2': + '@img/sharp-libvips-linuxmusl-arm64@1.3.4': optional: true - '@img/sharp-libvips-linuxmusl-x64@1.3.2': + '@img/sharp-libvips-linuxmusl-x64@1.3.4': optional: true - '@img/sharp-linux-arm64@0.35.3': + '@img/sharp-linux-arm64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-arm64': 1.3.2 + '@img/sharp-libvips-linux-arm64': 1.3.4 optional: true - '@img/sharp-linux-arm@0.35.3': + '@img/sharp-linux-arm@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-arm': 1.3.2 + '@img/sharp-libvips-linux-arm': 1.3.4 optional: true - '@img/sharp-linux-ppc64@0.35.3': + '@img/sharp-linux-ppc64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-ppc64': 1.3.2 + '@img/sharp-libvips-linux-ppc64': 1.3.4 optional: true - '@img/sharp-linux-riscv64@0.35.3': + '@img/sharp-linux-riscv64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-riscv64': 1.3.2 + '@img/sharp-libvips-linux-riscv64': 1.3.4 optional: true - '@img/sharp-linux-s390x@0.35.3': + '@img/sharp-linux-s390x@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-s390x': 1.3.2 + '@img/sharp-libvips-linux-s390x': 1.3.4 optional: true - '@img/sharp-linux-x64@0.35.3': + '@img/sharp-linux-x64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linux-x64': 1.3.2 + '@img/sharp-libvips-linux-x64': 1.3.4 optional: true - '@img/sharp-linuxmusl-arm64@0.35.3': + '@img/sharp-linuxmusl-arm64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linuxmusl-arm64': 1.3.2 + '@img/sharp-libvips-linuxmusl-arm64': 1.3.4 optional: true - '@img/sharp-linuxmusl-x64@0.35.3': + '@img/sharp-linuxmusl-x64@0.35.5': optionalDependencies: - '@img/sharp-libvips-linuxmusl-x64': 1.3.2 + '@img/sharp-libvips-linuxmusl-x64': 1.3.4 optional: true - '@img/sharp-wasm32@0.35.3': + '@img/sharp-wasm32@0.35.5': dependencies: '@emnapi/runtime': 1.11.3 optional: true - '@img/sharp-webcontainers-wasm32@0.35.3': + '@img/sharp-webcontainers-wasm32@0.35.5': dependencies: - '@img/sharp-wasm32': 0.35.3 + '@img/sharp-wasm32': 0.35.5 optional: true - '@img/sharp-win32-arm64@0.35.3': + '@img/sharp-win32-arm64@0.35.5': optional: true - '@img/sharp-win32-ia32@0.35.3': + '@img/sharp-win32-ia32@0.35.5': optional: true - '@img/sharp-win32-x64@0.35.3': + '@img/sharp-win32-x64@0.35.5': optional: true '@jridgewell/gen-mapping@0.3.13': @@ -4367,7 +4367,7 @@ snapshots: axe-core@4.12.1: {} - axios@1.18.1: + axios@1.20.0: dependencies: follow-redirects: 1.16.0 form-data: 4.0.6 @@ -4897,7 +4897,7 @@ snapshots: imurmurhash: 0.1.4 is-glob: 4.0.3 is-path-inside: 3.0.3 - js-yaml: 4.3.1 + js-yaml: 4.3.2 json-stable-stringify-without-jsonify: 1.0.1 levn: 0.4.1 lodash.merge: 4.6.2 @@ -5310,7 +5310,7 @@ snapshots: js-tokens@4.0.0: {} - js-yaml@4.3.1: + js-yaml@4.3.2: dependencies: argparse: 2.0.1 @@ -5439,7 +5439,7 @@ snapshots: '@next/swc-linux-x64-musl': 15.5.24 '@next/swc-win32-arm64-msvc': 15.5.24 '@next/swc-win32-x64-msvc': 15.5.24 - sharp: 0.35.3(@types/node@22.5.4) + sharp: 0.35.5(@types/node@22.5.4) transitivePeerDependencies: - '@babel/core' - '@types/node' @@ -5852,37 +5852,37 @@ snapshots: es-errors: 1.3.0 es-object-atoms: 1.1.2 - sharp@0.35.3(@types/node@22.5.4): + sharp@0.35.5(@types/node@22.5.4): dependencies: '@img/colour': 1.1.0 detect-libc: 2.1.2 semver: 7.8.5 optionalDependencies: - '@img/sharp-darwin-arm64': 0.35.3 - '@img/sharp-darwin-x64': 0.35.3 - '@img/sharp-freebsd-wasm32': 0.35.3 - '@img/sharp-libvips-darwin-arm64': 1.3.2 - '@img/sharp-libvips-darwin-x64': 1.3.2 - '@img/sharp-libvips-linux-arm': 1.3.2 - '@img/sharp-libvips-linux-arm64': 1.3.2 - '@img/sharp-libvips-linux-ppc64': 1.3.2 - '@img/sharp-libvips-linux-riscv64': 1.3.2 - '@img/sharp-libvips-linux-s390x': 1.3.2 - '@img/sharp-libvips-linux-x64': 1.3.2 - '@img/sharp-libvips-linuxmusl-arm64': 1.3.2 - '@img/sharp-libvips-linuxmusl-x64': 1.3.2 - '@img/sharp-linux-arm': 0.35.3 - '@img/sharp-linux-arm64': 0.35.3 - '@img/sharp-linux-ppc64': 0.35.3 - '@img/sharp-linux-riscv64': 0.35.3 - '@img/sharp-linux-s390x': 0.35.3 - '@img/sharp-linux-x64': 0.35.3 - '@img/sharp-linuxmusl-arm64': 0.35.3 - '@img/sharp-linuxmusl-x64': 0.35.3 - '@img/sharp-webcontainers-wasm32': 0.35.3 - '@img/sharp-win32-arm64': 0.35.3 - '@img/sharp-win32-ia32': 0.35.3 - '@img/sharp-win32-x64': 0.35.3 + '@img/sharp-darwin-arm64': 0.35.5 + '@img/sharp-darwin-x64': 0.35.5 + '@img/sharp-freebsd-wasm32': 0.35.5 + '@img/sharp-libvips-darwin-arm64': 1.3.4 + '@img/sharp-libvips-darwin-x64': 1.3.4 + '@img/sharp-libvips-linux-arm': 1.3.4 + '@img/sharp-libvips-linux-arm64': 1.3.4 + '@img/sharp-libvips-linux-ppc64': 1.3.4 + '@img/sharp-libvips-linux-riscv64': 1.3.4 + '@img/sharp-libvips-linux-s390x': 1.3.4 + '@img/sharp-libvips-linux-x64': 1.3.4 + '@img/sharp-libvips-linuxmusl-arm64': 1.3.4 + '@img/sharp-libvips-linuxmusl-x64': 1.3.4 + '@img/sharp-linux-arm': 0.35.5 + '@img/sharp-linux-arm64': 0.35.5 + '@img/sharp-linux-ppc64': 0.35.5 + '@img/sharp-linux-riscv64': 0.35.5 + '@img/sharp-linux-s390x': 0.35.5 + '@img/sharp-linux-x64': 0.35.5 + '@img/sharp-linuxmusl-arm64': 0.35.5 + '@img/sharp-linuxmusl-x64': 0.35.5 + '@img/sharp-webcontainers-wasm32': 0.35.5 + '@img/sharp-win32-arm64': 0.35.5 + '@img/sharp-win32-ia32': 0.35.5 + '@img/sharp-win32-x64': 0.35.5 '@types/node': 22.5.4 optional: true diff --git a/server/dashboard/pnpm-workspace.yaml b/server/dashboard/pnpm-workspace.yaml index dc4045c9e..2cea6a581 100644 --- a/server/dashboard/pnpm-workspace.yaml +++ b/server/dashboard/pnpm-workspace.yaml @@ -5,12 +5,12 @@ overrides: "form-data@<4.0.6": ">=4.0.6" "prismjs@<1.30.0": ">=1.30.0" "uuid@<11.1.1": ">=11.1.1" - "axios@<1.18.0": ">=1.18.0 <2.0.0" + "axios@<1.20.0": ">=1.20.0 <2.0.0" "brace-expansion@<1.1.16": ">=1.1.16 <2.0.0" "brace-expansion@>=3.0.0 <5.0.8": ">=5.0.8 <6.0.0" - "js-yaml@<3.15.1": ">=3.15.1 <4.0.0" - "js-yaml@>=4.0.0 <4.3.1": ">=4.3.1 <5.0.0" + "js-yaml@<3.15.2": ">=3.15.2 <4.0.0" + "js-yaml@>=4.0.0 <4.3.2": ">=4.3.2 <5.0.0" "postcss@<8.5.18": ">=8.5.18 <9.0.0" "nanoid@<3.3.18": ">=3.3.18 <4.0.0" - "sharp@<0.35.0": ">=0.35.0 <0.36.0" + "sharp@<0.35.4": ">=0.35.4 <0.36.0" "browserslist@<4.28.7": ">=4.28.7 <5.0.0" From 0516f19f721d1b0bbf9171410031cd28fd1c19ac Mon Sep 17 00:00:00 2001 From: Shashidhar Kundur <106020668+shashiKundur1@users.noreply.github.com> Date: Wed, 7 Oct 2026 15:53:25 +0530 Subject: [PATCH 44/55] fix(ts-oss): stop add() from mutating the caller's filters object (#6797) --- mem0-ts/src/oss/src/memory/index.ts | 4 +- .../memory.add-filters-isolation.test.ts | 115 ++++++++++++++++++ 2 files changed, 118 insertions(+), 1 deletion(-) create mode 100644 mem0-ts/src/oss/tests/memory.add-filters-isolation.test.ts diff --git a/mem0-ts/src/oss/src/memory/index.ts b/mem0-ts/src/oss/src/memory/index.ts index 1efbc3e45..42f3ca22e 100644 --- a/mem0-ts/src/oss/src/memory/index.ts +++ b/mem0-ts/src/oss/src/memory/index.ts @@ -768,7 +768,9 @@ export class Memory { has_filters: !!config.filters, infer: config.infer, }); - const { filters = {}, infer = true } = config; + // Copy: scope keys are written into this object below, and the caller's next add() must not inherit them (#6796). + const filters: SearchFilters = { ...(config.filters ?? {}) }; + const { infer = true } = config; const metadata = stripIdentityKeys(config.metadata); // Validate and trim entity IDs diff --git a/mem0-ts/src/oss/tests/memory.add-filters-isolation.test.ts b/mem0-ts/src/oss/tests/memory.add-filters-isolation.test.ts new file mode 100644 index 000000000..a23926e41 --- /dev/null +++ b/mem0-ts/src/oss/tests/memory.add-filters-isolation.test.ts @@ -0,0 +1,115 @@ +/// +/** + * add() writes the resolved scope (user_id / agent_id / run_id) into its + * filters object. If that object is the caller's, the scope survives the call + * and leaks into the next add() that reuses it, which also defeats the + * "one of userId, agentId or runId is required" guard. + * + * search() and getAll() already build a fresh object from config.filters. + */ +jest.mock("../src/utils/telemetry", () => ({ + captureClientEvent: jest.fn().mockResolvedValue(undefined), + isTelemetryEnabled: jest.fn(() => false), +})); + +import { Memory } from "../src/memory"; + +const DIM = 1536; +let seq = 0; + +function createMemory(): Memory { + const m = new Memory({ + disableHistory: true, + vectorStore: { + provider: "memory", + config: { + collectionName: `test-add-filters-${seq++}`, + dimension: DIM, + dbPath: ":memory:", + }, + }, + historyDbPath: ":memory:", + embedder: { provider: "openai", config: { apiKey: "test-key" } }, + llm: { provider: "openai", config: { apiKey: "test-key" } }, + } as any); + + // infer:false is enough to exercise the scope handling, so the LLM is never + // called; the embedder just has to return a well-formed vector. + (m as any).embedder = { + embed: async () => new Array(DIM).fill(0.1), + embedBatch: async (texts: string[]) => + texts.map(() => new Array(DIM).fill(0.1)), + }; + return m; +} + +describe("add() does not mutate the caller's filters object", () => { + it("leaves the caller's object untouched", async () => { + const memory = createMemory(); + const filters: Record = {}; + + await memory.add([{ role: "user", content: "alice note" }], { + userId: "alice", + infer: false, + filters, + }); + + expect(filters).toEqual({}); + }); + + it("still throws when a reused object is the only source of scope", async () => { + const memory = createMemory(); + const filters: Record = {}; + + await memory.add([{ role: "user", content: "alice note" }], { + userId: "alice", + infer: false, + filters, + }); + + // No userId/agentId/runId on this call, so the required-scope guard must + // fire rather than reading a value left behind by the previous call. + await expect( + memory.add([{ role: "user", content: "bob note" }], { + infer: false, + filters, + }), + ).rejects.toThrow( + "One of the filters: userId, agentId or runId is required!", + ); + }); + + it("does not store one user's memory under another user's scope", async () => { + const memory = createMemory(); + const filters: Record = {}; + + await memory.add([{ role: "user", content: "alice note" }], { + userId: "alice", + infer: false, + filters, + }); + // A second caller reuses the object and supplies no scope of its own. This + // must not be silently attributed to alice. + await memory + .add([{ role: "user", content: "bob note" }], { + infer: false, + filters, + }) + .catch(() => undefined); + + const alice = await memory.getAll({ filters: { user_id: "alice" } }); + expect(alice.results.map((r) => r.memory)).toEqual(["alice note"]); + }); + + it("keeps scope keys the caller passed in", async () => { + const memory = createMemory(); + + await memory.add([{ role: "user", content: "scoped note" }], { + infer: false, + filters: { user_id: "carol" }, + }); + + const carol = await memory.getAll({ filters: { user_id: "carol" } }); + expect(carol.results.map((r) => r.memory)).toEqual(["scoped note"]); + }); +}); From d62ce07faceafedd4b10d60704db2b9d89d0afff Mon Sep 17 00:00:00 2001 From: rupak Date: Wed, 7 Oct 2026 16:20:38 +0530 Subject: [PATCH 45/55] fix(vector-store): stop writing service account private key to DEBUG logs in GoogleMatchingEngine (#7506) Co-authored-by: rupak-eng --- mem0/vector_stores/vertex_ai_vector_search.py | 4 +-- .../test_vertex_ai_vector_search.py | 33 +++++++++++++++++++ 2 files changed, 35 insertions(+), 2 deletions(-) diff --git a/mem0/vector_stores/vertex_ai_vector_search.py b/mem0/vector_stores/vertex_ai_vector_search.py index 0954bf90c..417e1cc00 100644 --- a/mem0/vector_stores/vertex_ai_vector_search.py +++ b/mem0/vector_stores/vertex_ai_vector_search.py @@ -34,7 +34,7 @@ class OutputData(BaseModel): class GoogleMatchingEngine(VectorStoreBase): def __init__(self, **kwargs): """Initialize Google Matching Engine client.""" - logger.debug("Initializing Google Matching Engine with kwargs: %s", kwargs) + logger.debug("Initializing Google Matching Engine with config keys: %s", sorted(kwargs)) # If collection_name is passed, use it as deployment_index_id if deployment_index_id is not provided if "collection_name" in kwargs and "deployment_index_id" not in kwargs: @@ -46,7 +46,7 @@ class GoogleMatchingEngine(VectorStoreBase): try: config = GoogleMatchingEngineConfig(**kwargs) - logger.debug("Config created: %s", config.model_dump()) + logger.debug("Config created with fields: %s", sorted(config.model_dump())) logger.debug("Config collection_name: %s", getattr(config, "collection_name", None)) except Exception as e: logger.error("Failed to validate config: %s", str(e)) diff --git a/tests/vector_stores/test_vertex_ai_vector_search.py b/tests/vector_stores/test_vertex_ai_vector_search.py index 7ef994332..12dc1e0be 100644 --- a/tests/vector_stores/test_vertex_ai_vector_search.py +++ b/tests/vector_stores/test_vertex_ai_vector_search.py @@ -1,3 +1,4 @@ +import logging from unittest.mock import Mock, patch import pytest @@ -165,3 +166,35 @@ def test_error_handling(vector_store, mock_vertex_ai): assert isinstance(exc_info.value, exceptions.InvalidArgument) assert "Invalid request" in str(exc_info.value) + + +def test_debug_logs_never_carry_service_account_key(caplog): + """Regression for #7503: constructor DEBUG lines must not log the inline credential. + + The constructor emits the whole kwargs dict and the validated config dump at + DEBUG; when ``service_account_json`` is passed inline that writes the PEM + private key to the log sink. Constructor diagnostics should name the fields, + never their values. + """ + private_key = "-----BEGIN PRIVATE KEY-----\nFAKE-KEY-MATERIAL-FOR-TEST\n-----END PRIVATE KEY-----\n" + kwargs = { + "project_id": "test-project", + "project_number": "123456789", + "region": "us-central1", + "endpoint_id": "test-endpoint", + "index_id": "test-index", + "deployment_index_id": "test-deployment", + "service_account_json": {"type": "service_account", "private_key": private_key}, + } + + with caplog.at_level(logging.DEBUG, logger="mem0.vector_stores.vertex_ai_vector_search"): + # Fails later at credential load (no network, no valid key); the two + # DEBUG statements under test run before that. + with pytest.raises(Exception): + GoogleMatchingEngine(**kwargs) + + logged = caplog.text + assert private_key not in logged + assert "FAKE-KEY-MATERIAL-FOR-TEST" not in logged + # The diagnostics must stay useful: field names are still logged. + assert "service_account_json" in logged From b7ad69afda6b6ed030347c66d48a13e4de9dec08 Mon Sep 17 00:00:00 2001 From: Kartik Date: Wed, 7 Oct 2026 18:36:15 +0530 Subject: [PATCH 46/55] docs(skills): refresh mem0 skills against SDK 2.2.1 / TS 3.3.1 (#7548) --- docs/migration/platform-v2-to-v3.mdx | 8 +- skills/AGENTS.md | 22 +- skills/mem0-cli/README.md | 2 +- skills/mem0-cli/SKILL.md | 31 +-- .../mem0-cli/references/command-reference.md | 207 ++++++++++++------ skills/mem0-cli/references/configuration.md | 80 ++++--- skills/mem0-cli/references/workflows.md | 81 +++---- skills/mem0-integrate/SKILL.md | 8 +- skills/mem0-integrate/references/pipeline.md | 19 +- .../references/subagent-prompts.md | 3 +- skills/mem0-oss-to-platform/README.md | 2 +- skills/mem0-oss-to-platform/SKILL.md | 60 +++-- .../references/api-mapping.md | 124 +++++++---- .../references/gotchas.md | 80 +++++-- .../references/plan-template.md | 13 +- skills/mem0-test-integration/SKILL.md | 44 ++-- skills/mem0-vercel-ai-sdk/README.md | 6 +- skills/mem0-vercel-ai-sdk/SKILL.md | 58 +++-- .../references/memory-utilities.md | 85 +++---- .../references/provider-api.md | 87 ++++---- .../references/usage-patterns.md | 54 ++--- skills/mem0/SKILL.md | 21 +- skills/mem0/client/differences.md | 15 +- skills/mem0/client/node.md | 185 ++++++++++++---- skills/mem0/client/python.md | 139 +++++++----- skills/mem0/references/api-reference.md | 55 +++-- skills/mem0/references/architecture.md | 45 ++-- skills/mem0/references/features.md | 160 +++++++------- .../mem0/references/integration-patterns.md | 82 +++---- skills/mem0/references/quickstart.md | 12 +- skills/mem0/references/sdk-guide.md | 49 +++-- skills/mem0/references/use-cases.md | 31 +-- skills/mem0/scripts/mem0_doc_search.py | 185 ++++++++-------- 33 files changed, 1239 insertions(+), 814 deletions(-) diff --git a/docs/migration/platform-v2-to-v3.mdx b/docs/migration/platform-v2-to-v3.mdx index 8cc9690da..8a16dde57 100644 --- a/docs/migration/platform-v2-to-v3.mdx +++ b/docs/migration/platform-v2-to-v3.mdx @@ -136,8 +136,8 @@ curl -X POST 'https://api.mem0.ai/v3/memories/?page=1&page_size=50' \ | Parameter | V1/V2 | V3 | Notes | |---|---|---|---| | `top_k` | Supported | Supported (1-1000, default 10) | No change | -| `threshold` | Default: none | Default: `0.1` | Pass `0.0` to disable | -| `rerank` | Default: `true` | Default: `false` | Pass `true` to enable (adds latency) | +| `threshold` | Default: `0.3` (v2) | Default: `0.1` | Pass `0.3` to keep the v2 cutoff, or `0.0` to disable | +| `rerank` | Default: `false` | Default: `false` | No change. Pass `true` to enable (adds latency) | | Entity IDs in `search` / `get_all` | Top-level | Inside `filters` dict | Top-level raises 400 | ### Response Format @@ -265,10 +265,10 @@ If your application previously read graph relations from the API response (`rela - The default `threshold` is now `0.1` (previously no threshold). If your application was relying on unfiltered results, explicitly pass `threshold=0.0` in your search calls to preserve the old behavior. In most cases, the new default is better: it filters out low-relevance noise. + The default `threshold` is now `0.1` (it was `0.3` on v2), so lower-scoring matches that v2 hid can now appear. Scores are computed differently in v3, so retune against representative queries. To keep a stricter cutoff, pass an explicit `threshold` in your search calls, or pass `threshold=0.0` to disable filtering. - Reranking is now `false` by default. If your application depended on reranked results, add `rerank=True` to your search calls. Note that reranking adds latency (~200-400ms) but can improve ordering quality for complex queries. + Reranking is `false` by default, the same as on v2. If your application depends on reranked results, pass `rerank=True` to your search calls. Note that reranking adds latency (~200-400ms) but can improve ordering quality for complex queries. The top-level `score` field continues to work as before. It is now a combined multi-signal score (semantic + keyword + entity) rather than pure cosine similarity, so the absolute numbers will differ. Relative ranking remains comparable: if you have threshold-based filtering in your app, retune on a representative query set. diff --git a/skills/AGENTS.md b/skills/AGENTS.md index 6e0bbc3f5..6b4d87f04 100644 --- a/skills/AGENTS.md +++ b/skills/AGENTS.md @@ -50,16 +50,20 @@ Everything else, meaning full step mechanics, document templates, and verbatim s Current sizes, longest first: ``` -mem0/references/use-cases.md 720 reference, on demand -mem0-cli/references/command-reference.md 694 reference, on demand -mem0/client/python.md 487 reference, on demand -mem0-integrate/references/pipeline.md 375 reference, on demand -mem0-test-integration/SKILL.md 368 entry point, under budget +mem0-cli/references/command-reference.md 757 reference, on demand +mem0/references/use-cases.md 721 reference, on demand +mem0/client/python.md 522 reference, on demand +mem0/client/node.md 507 reference, on demand +mem0-cli/references/workflows.md 446 reference, on demand +mem0/references/features.md 406 reference, on demand +mem0/references/integration-patterns.md 403 reference, on demand +mem0-test-integration/SKILL.md 386 entry point, under budget +mem0-integrate/references/pipeline.md 380 reference, on demand mem0-integrate/SKILL.md 220 entry point -mem0/SKILL.md 193 entry point -mem0-vercel-ai-sdk/SKILL.md 192 entry point -mem0-cli/SKILL.md 169 entry point -mem0-oss-to-platform/SKILL.md 120 entry point +mem0-vercel-ai-sdk/SKILL.md 210 entry point +mem0/SKILL.md 194 entry point +mem0-cli/SKILL.md 170 entry point +mem0-oss-to-platform/SKILL.md 132 entry point ``` `mem0-integrate` is the one skill that needed splitting: it was 620 lines, now diff --git a/skills/mem0-cli/README.md b/skills/mem0-cli/README.md index 4333116e8..35e00c97d 100644 --- a/skills/mem0-cli/README.md +++ b/skills/mem0-cli/README.md @@ -6,7 +6,7 @@ Manage memories from the terminal using the [Mem0 CLI](https://docs.mem0.ai/plat When installed, Claude can: -- **Run mem0 commands** correctly in your terminal (add, search, list, get, update, delete, import, config, init, status, entity, event) +- **Run mem0 commands** correctly in your terminal (add, search, list, get, update, delete, import, config, init, identify, whoami, status, entity, event, agent-rush, version, help) - **Construct complex invocations** with the right flags, scoping, filters, and output formats - **Pipe and script** mem0 commands in shell workflows, CI/CD pipelines, and agent loops - **Debug issues** like missing API keys, entity scoping conflicts, and async processing delays diff --git a/skills/mem0-cli/SKILL.md b/skills/mem0-cli/SKILL.md index 10afd3429..8b420a9f5 100644 --- a/skills/mem0-cli/SKILL.md +++ b/skills/mem0-cli/SKILL.md @@ -12,9 +12,10 @@ description: > license: Apache-2.0 metadata: author: mem0ai - version: "1.1.0" + version: "1.2.0" category: ai-memory tags: "cli, terminal, memory, ai, command-line" + mem0_tested_versions: "mem0-cli (PyPI) >=0.2.13,<0.3.0; @mem0/cli (npm) >=0.2.14,<0.3.0; mem0ai (PyPI) >=2.0.0,<3.0.0; mem0ai (npm) >=3.0.0,<4.0.0" compatibility: Node.js 18+ (npm install -g @mem0/cli) or Python 3.10+ (pip install mem0-cli), MEM0_API_KEY env var --- @@ -34,7 +35,7 @@ npm install -g @mem0/cli pip install mem0-cli ``` -Both packages install a `mem0` binary with identical commands, options, and output formats. +Both packages install a `mem0` binary with the same commands, options, and output formats (see [Node and Python Differences](#node-and-python-differences) for the exceptions). ## Setup @@ -105,7 +106,7 @@ mem0 delete --all --user-id alice --force ## Agent / JSON Mode -Use `--json` or `--agent` to get structured output suitable for LLM consumption. Every command wraps its response in a standard envelope: +Use `--json` or `--agent` to get structured output suitable for LLM consumption. Place the flag before the subcommand (`mem0 --json search "q"`), which works in both CLIs. Data commands (add, search, list, get, update, delete, import, config, entity, event, status) wrap their response in a standard envelope: ```json { @@ -114,7 +115,6 @@ Use `--json` or `--agent` to get structured output suitable for LLM consumption. "duration_ms": 245, "scope": { "user_id": "alice" }, "count": 3, - "error": null, "data": [ { "id": "mem-abc", "memory": "User prefers dark mode", "score": 0.92 } ] @@ -126,30 +126,31 @@ On error: { "status": "error", "command": "search", - "error": "Authentication failed. Your API key may be invalid or expired.", + "error": "Invalid or expired API key.", "data": null } ``` -The `--agent` flag is an alias for `--json`. Both write spinners and progress to stderr so stdout is always clean, parseable JSON. +The `--agent` flag is an alias for `--json` (except on `mem0 init`, where `--agent` is the Agent Mode bootstrap flag). Both write spinners and progress to stderr so stdout is clean, parseable JSON (the one exception is Node `import`, see below). Optional keys: `duration_ms`, `scope`, `count` appear only where relevant, and `mem0_notice` appears when the platform flags an unclaimed Agent Mode account. -## Node and Python Parity +## Node and Python Differences -Both the Node.js (`@mem0/cli`) and Python (`mem0-cli`) CLIs are implemented from the same specification (`cli-spec.json`). They share: +Both the Node.js (`@mem0/cli`) and Python (`mem0-cli`) CLIs share the command set, flags, entity ID resolution, filter building, and the JSON envelope. Choose whichever runtime you already have installed. Known differences: -- Identical command names, arguments, and flags -- Identical output formats (text, json, table, quiet) -- Identical entity ID resolution, graph tri-state, filter building -- Identical error messages and exit codes - -Choose whichever runtime you already have installed. The behavior is the same. +- **`--json` / `--agent` placement:** Python accepts the flag anywhere on the command line. Node reads it only as a global option, so put it before the subcommand (`mem0 --json list`). `mem0 init --json` and `mem0 help --json` work after the subcommand in both. For the Agent Mode bootstrap, Node starts it only from `init --agent` or `init --json` (a root-level `mem0 --json init` or `mem0 --agent init` does not start it, and without an agent runtime env var it fails with the non-TTY error), while Python also accepts those root-level forms. `mem0 init --agent --json` works in both. +- **`--limit`:** `mem0 search --limit` is a Python-only alias for `--top-k`. +- **Agent-mode `delete --all` data:** Python returns `{"deleted": true}` (plus scope for `--project`); Node returns the raw API result. +- **`import` JSON output:** Python prints the envelope with `scope`. Node omits `scope` and writes the `Importing memories... n/n` progress line to stdout before the JSON, so only Python's output pipes cleanly to `jq`. +- **Message text:** The empty-search error (`Search query cannot be empty.` in Python, `No query provided...` in Node) and the delete dry-run footers differ slightly. ## Common Edge Cases - **Async processing delay:** After `mem0 add`, memories process asynchronously. Wait 2-3 seconds before searching for newly added content. Use `mem0 event list` to check processing status. - **`--all` vs `--entity` delete modes:** `mem0 delete --all -u alice` deletes all memories for user alice. `mem0 delete --entity -u alice` deletes the entity itself AND all its memories (cascade). These are mutually exclusive modes. +- **`--dry-run` in `--json`/`--agent` mode:** `mem0 --json delete --all --dry-run` still requires `--force`, then prints nothing and deletes nothing (exit 0). Node also prints nothing for single and `--entity` dry runs. Use text mode to see the preview. +- **`--dry-run` does not protect `--all --project`:** `mem0 delete --all --project --dry-run` ignores the flag and deletes every memory in the project. Never use `--dry-run` to preview a project-wide delete. - **Entity ID resolution:** If you pass any explicit scope flag (e.g. `--user-id`), the CLI uses ONLY the explicit IDs and ignores config defaults. If no scope flags are given, all configured defaults apply. -- **Stdin detection:** When no text argument is provided and input is piped (not a TTY), the CLI reads from stdin. Works with `add`, `search`, and `update`. +- **Stdin detection:** When no text argument is provided and stdin is a pipe or a redirected file (a plain non-TTY is not enough), the CLI reads from stdin. Works with `add`, `search`, and `update`. In `--json`/`--agent` mode `add` never reads stdin (Python also skips it for `search` and `update`), so pass the text as an argument there. ## References diff --git a/skills/mem0-cli/references/command-reference.md b/skills/mem0-cli/references/command-reference.md index 16f85ed50..36346f049 100644 --- a/skills/mem0-cli/references/command-reference.md +++ b/skills/mem0-cli/references/command-reference.md @@ -1,20 +1,25 @@ # Mem0 CLI Command Reference -Complete reference for every command, argument, flag, and output mode in the mem0 CLI. Both the Node.js (`@mem0/cli`) and Python (`mem0-cli`) implementations are identical in behavior. +Complete reference for every command, argument, flag, and output mode in the mem0 CLI. Both the Node.js (`@mem0/cli`) and Python (`mem0-cli`) implementations share the same commands and flags. Where they differ, the difference is called out inline. --- ## Global Options -These options are available on every command: +Only these two options are global: + +| Flag | Type | Description | +|------|------|-------------| +| `--json` / `--agent` | boolean | Agent mode: wrap output in a structured JSON envelope on stdout. Spinners and progress go to stderr (except Node `import`, see its section). Put it before the subcommand (`mem0 --json list`); Python also accepts it anywhere. On `mem0 init`, `--agent` is the Agent Mode bootstrap flag instead (use `--json` there, after the subcommand). | +| `--version` | boolean | Print version and exit. | + +These options are declared per command (not global) on `add`, `search`, `get`, `list`, `update`, `delete`, `import`, `status`, `entity list`, `entity delete`, `event list` and `event status`. `config show` takes only `-o`, and `init` takes only `--api-key`. | Flag | Type | Description | |------|------|-------------| -| `--json` / `--agent` | boolean | Agent mode: wrap all output in a structured JSON envelope on stdout. Spinners and progress go to stderr. | | `-o, --output ` | string | Output format. Supported values vary per command (see matrix below). | | `--api-key ` | string | Override the API key for this invocation. Takes precedence over env var and config file. | | `--base-url ` | string | Override the API base URL (default: `https://api.mem0.ai`). | -| `--version` | boolean | Print version and exit. | --- @@ -41,11 +46,12 @@ Interactive setup wizard. Configures API key and default user ID. **Behavior:** -- If `~/.mem0/config.json` already exists with an API key, warns and asks for confirmation (or errors in non-TTY unless `--force` is set). -- **Email login flow** (`--email`): sends a 6-digit code to the email via `POST /api/v1/auth/email_code/`. If `--code` is also given, verifies immediately. On success, saves API key, org_id, and project_id. Cannot be combined with `--api-key`. -- **API key flow**: if both `--api-key` and `--user-id` are given, runs fully non-interactively. Otherwise prompts for missing values. -- **Agent Mode flow** (`--agent`): POSTs to `/api/v1/auth/agent_mode/`, mints a shadow API key in <5s with no email required. Pass `--agent-caller ` to attribute the signup to your AI agent identity. If omitted, run `mem0 identify ` afterward. -- In non-TTY without sufficient flags, prints a usage hint and exits with error. +- If `~/.mem0/config.json` already exists with an API key, warns and asks for confirmation. In non-TTY it errors with "Existing config would be overwritten." unless `--force` is set. The Agent Mode path (below) runs before this check. +- **Email login flow** (`--email`): sends a 6-digit code to the email via `POST /api/v1/auth/email_code/`. If `--code` is also given, skips sending and verifies immediately via `/api/v1/auth/email_code/verify/`. In non-TTY without `--code`, the code is sent and the command then errors; re-run with `--code`. On success, saves the API key, `user_email`, and `created_via: "email"`, and sets the default user ID to `--user-id`, else `$USER`/`$USERNAME`, else `mem0-cli`. Cannot be combined with `--api-key`. `--code` without `--email` is an error. +- **Claim flow** (`--email` while the existing config is an unclaimed Agent Mode key): runs the same code flow but claims the existing key to that email. The API key value does not change and memories are kept. +- **API key flow**: if both `--api-key` and `--user-id` are given, runs fully non-interactively (and validates the key against the API). In non-TTY, `--api-key` alone is enough (the user ID defaults to `$USER`/`$USERNAME`/`mem0-cli`). In a TTY with no flags, prompts for the auth method (email or API key), then for the missing values. +- **Agent Mode flow** (`init --agent`, `init --json`, or an agent runtime env var such as `CLAUDECODE` or `CURSOR_AGENT`, with no `--api-key`/`--email`; Python also enters it on a global `mem0 --json init` or `mem0 --agent init`, Node does not): first reuses a valid `MEM0_API_KEY` or a valid key already in config (no new key is minted). Otherwise POSTs to `/api/v1/auth/agent_mode/` and mints a shadow API key in <5s with no email required; the generated `user_` becomes `defaults.user_id`. Limited to 5 signups per day per network. Pass `--agent-caller ` to attribute the signup to your AI agent identity. If omitted, run `mem0 identify ` afterward. +- In non-TTY without `--api-key`, `--email`, or an agent signal, prints "Non-interactive terminal detected and --api-key is required." and exits with error. **Examples:** ```bash @@ -61,16 +67,16 @@ mem0 init --agent --agent-caller claude-code # AI agent self-identifies during ### `mem0 identify` -Tag your active Agent Mode key with the AI agent that's using it. Run this once after `mem0 init --agent` if you didn't pass `--agent-caller`. Idempotent — re-running just overwrites the value. +Tag your active Agent Mode key with the AI agent that's using it. Run this once after `mem0 init --agent` if you didn't pass `--agent-caller`. Idempotent: re-running just overwrites the value. **Usage:** `mem0 identify ` -**Argument:** `` — the AI agent identity (e.g. `claude-code`, `cursor`, `codex`, `cline`, `aider`, or a custom string). +**Argument:** ``: the AI agent identity (e.g. `claude-code`, `cursor`, `codex`, `cline`, `aider`, or a custom string). **Behavior:** - PATCHes `/api/v1/auth/agent_mode/caller/` with `Authorization: Token ` and body `{agent_caller}`. -- Only works on unclaimed agent-mode keys (`platform.agent_mode=true` in config). +- Only works on unclaimed agent-mode keys (`platform.agent_mode=true` in config). Errors with "No API key configured." if no key is set, or "This command only works on unclaimed agent-mode keys." otherwise. - Backend sanitizes the value: lowercases, drops anything outside `[a-z0-9._/-]`, truncates to 32 chars. **Examples:** @@ -82,6 +88,45 @@ mem0 identify my-custom-bot --- +### `mem0 whoami` + +Print your AGENTRUSH identifier (`platform.default_user_id` from config). Errors with "No default_user_id found. Run `mem0 init --agent` first." if none is stored. + +**Usage:** `mem0 whoami` + +--- + +### `mem0 agent-rush add|search` + +Commands for the AGENTRUSH event game. Memories are public to other players, so never include real names, emails, secrets, or PII. + +**Usage:** `mem0 agent-rush add ` and `mem0 agent-rush search ` + +- `add`: content must be 50-1000 characters with no URLs. The server requires 3 searches before adding and caps each key at 3 lifetime searches and 3 lifetime adds. +- Requires an API key from config or `MEM0_API_KEY` (otherwise errors with "Not initialized. Run `mem0 init --agent` first."). Node joins unquoted words into one string; Python takes a single quoted argument. + +**Examples:** +```bash +mem0 agent-rush search "constraint satisfaction" +mem0 agent-rush add "I enjoy solving constraint-satisfaction problems and writing small solvers." +``` + +--- + +### `mem0 version` + +Print the CLI version. `mem0 --version` does the same. + +--- + +### `mem0 help` + +**Usage:** `mem0 help [--json]` + +Prints the command overview. `--json` (or global `--json`/`--agent`) prints a machine-readable command spec. In both CLIs this spec is hand-maintained and can lag behind the real option list, so trust `mem0 --help` and this reference over it. + +--- + ### `mem0 add` Add a memory from text, messages, file, or stdin. @@ -106,10 +151,17 @@ Add a memory from text, messages, file, or stdin. | `-f, --file ` | path | - | Read messages from a JSON file. | | `-m, --metadata ` | string | - | Custom metadata as JSON object (e.g. `'{"source":"cli"}'`). | | `--no-infer` | boolean | false | Skip inference; store the text verbatim. | -| `--categories ` | string | - | Categories as JSON array or comma-separated string. | +| `--expires ` | string | - | Expiration date (YYYY-MM-DD). Must be in the future. | +| `--immutable` | boolean | false | Accepted but has no effect on v3: the memory can still be updated and no marker is stored. | +| `--custom-instructions ` | string | - | Custom instructions for fact extraction. | +| `--agent-custom-instructions ` | string | - | Extraction instructions for agent-scoped memories, overriding the project setting. | +| `--custom-categories ` | string | - | Custom categories as a JSON array of `{name: description}` objects. | +| `--structured-data-schema ` | string | - | Schema for structured data extraction, as JSON. | +| `--timestamp ` | integer | - | Unix timestamp for the memory. | +| `--categories ` | string | - | Rejected with an error. Use `--custom-categories` instead. | | `-o, --output ` | string | `text` | Output format: `text`, `json`, `quiet`. | -**Input priority:** `--file` > `--messages` > text argument > stdin (if piped and no text). +**Input priority:** `--file` > `--messages` > text argument > stdin (if piped or redirected, no text, and not in `--json`/`--agent` mode). Text content is wrapped as `[{"role": "user", "content": ""}]` before sending to the API. Messages from `--messages` or `--file` are sent as-is. @@ -130,9 +182,8 @@ mem0 add "allergic to nuts" -u alice -m '{"source":"onboarding"}' mem0 add --messages '[{"role":"user","content":"I like Python"}]' -u alice mem0 add --file conversation.json -u alice -o json echo "I prefer dark mode" | mem0 add -u alice -mem0 add "temporary note" -u alice --expires 2025-12-31 -mem0 add "important fact" -u alice --immutable -mem0 add "uses vim" -u alice --categories "tools,preferences" +mem0 add "temporary note" -u alice --expires 2027-12-31 +mem0 add "uses vim" -u alice --custom-categories '[{"tools":"Editors and developer tooling"}]' ``` --- @@ -147,7 +198,7 @@ Search memories by semantic query. | Name | Type | Required | Description | |------|------|----------|-------------| -| `query` | string | Yes | The search query. Falls back to stdin if piped. | +| `query` | string | Yes | The search query. Falls back to stdin if piped or redirected (Python skips this in `--json`/`--agent` mode; Node does not). | **Options:** @@ -157,11 +208,15 @@ Search memories by semantic query. | `--agent-id ` | string | - | Filter by agent. | | `--app-id ` | string | - | Filter by app. | | `--run-id ` | string | - | Filter by run. | -| `-k, --top-k, --limit ` | integer | 10 | Maximum number of results to return. | -| `--threshold ` | float | 0.1 | Minimum similarity score (0.0 to 1.0). | +| `-k, --top-k ` | integer | 10 | Maximum number of results to return (must be >= 1). Python also accepts `--limit` as an alias. | +| `--threshold ` | float | 0.3 | Minimum similarity score (0.0 to 1.0), applied before hybrid score blending, so a returned item's displayed `score` can be lower than this value. | | `--rerank` | boolean | false | Enable reranking for improved relevance (Platform only). | -| `--filter ` | string | - | Advanced filter expression as JSON (AND/OR operators). | -| `--fields ` | string | - | Comma-separated list of fields to return. | +| `--keyword` | boolean | false | Sent to the API as `keyword_search` but not applied by v3 search, which always blends keyword matching into hybrid scoring. | +| `--filter ` | string | - | Advanced filter expression as JSON. If it contains `AND` or `OR` it is sent as-is and entity IDs (including config defaults) are not merged in. | +| `--fields ` | string | - | Comma-separated list of fields to return. Sent to the API but not applied by v3 search. | +| `--show-expired` | boolean | false | Include expired memories. | +| `--reference-date ` | string | - | Reference date for relative queries (YYYY-MM-DD or unix timestamp). | +| `--latest-only` | boolean | false | Only return the latest version of each memory. | | `-o, --output ` | string | `text` | Output format: `text`, `json`, `table`. | **Examples:** @@ -171,6 +226,8 @@ mem0 search "tools" -u alice -o json -k 5 mem0 search "dietary restrictions" -u alice --threshold 0.5 mem0 search "project setup" -u alice --rerank mem0 search "preferences" -u alice --filter '{"categories":{"contains":"food"}}' +mem0 search "invoices" -u alice --filter '{"AND":[{"user_id":"alice"},{"categories":{"in":["work"]}}]}' +mem0 search "plans" -u alice --latest-only echo "preferences" | mem0 search -u alice ``` @@ -221,6 +278,8 @@ List memories with optional filters and pagination. | `--category ` | string | - | Filter by category. | | `--after ` | string | - | Created after (YYYY-MM-DD). | | `--before ` | string | - | Created before (YYYY-MM-DD). | +| `--show-expired` | boolean | false | Include expired memories. | +| `--latest-only` | boolean | false | Only return the latest version of each memory. | | `-o, --output ` | string | `table` | Output format: `text`, `json`, `table`. | **Examples:** @@ -244,13 +303,15 @@ Update a memory's text or metadata. | Name | Type | Required | Description | |------|------|----------|-------------| | `memory_id` | string | Yes | The UUID of the memory to update. | -| `text` | string | No | New memory text. Falls back to stdin if piped and no `--metadata`. | +| `text` | string | No | New memory text. Falls back to stdin if piped or redirected (Python skips this in `--json`/`--agent` mode; Node does not). | **Options:** | Flag | Type | Default | Description | |------|------|---------|-------------| | `-m, --metadata ` | string | - | Update metadata as JSON object. | +| `--expires ` | string | - | Expiration date (YYYY-MM-DD). Must be in the future. | +| `--timestamp ` | integer | - | Unix timestamp for the memory. | | `-o, --output ` | string | `text` | Output format: `text`, `json`, `quiet`. | **Examples:** @@ -282,8 +343,9 @@ Delete a memory, all memories matching a scope, or an entity. This command has t | `--all` | boolean | false | Delete all memories matching scope filters. | | `--entity` | boolean | false | Delete the entity itself and all its memories (cascade). | | `--project` | boolean | false | With `--all`: delete ALL memories project-wide (sends wildcard IDs). | -| `--dry-run` | boolean | false | Show what would be deleted without actually deleting. | -| `--force` | boolean | false | Skip confirmation prompt. | +| `--dry-run` | boolean | false | Show what would be deleted without actually deleting. Ignored by `--all --project`, which deletes (see Dry-run behavior). | +| `--force` | boolean | false | Skip confirmation prompt (`--all` and `--entity` only). Required for those modes in `--json`/`--agent` mode. | +| `--delete-linked` | boolean | false | Single-memory mode: also delete memories linked to this memory. | | `-u, --user-id ` | string | - | Scope to user. | | `--agent-id ` | string | - | Scope to agent. | | `--app-id ` | string | - | Scope to app. | @@ -296,14 +358,17 @@ Delete a memory, all memories matching a scope, or an entity. This command has t 2. **Bulk delete:** `mem0 delete --all [scope flags]` -- deletes all memories matching the scope. Add `--project` to wipe all memories project-wide (sends wildcard `*` entity IDs). 3. **Entity cascade:** `mem0 delete --entity [scope flags]` -- deletes the entity itself AND all its memories. -You cannot combine `` with `--all` or `--entity`, and you cannot combine `--all` with `--entity`. If none of these are provided, the command prints a usage hint and exits with an error. +You cannot combine `` with `--all` or `--entity`, and you cannot combine `--all` with `--entity`. If none of these are provided, the command prints an error and exits 1. + +**Entity IDs:** `--all` resolves IDs like `search` (explicit flags only, else config defaults). Single delete and `--entity` use only explicit flags, and `--entity` requires at least one. **Dry-run behavior:** -- Single: fetches the memory, displays it, prints "No changes made." -- `--all`: lists matching memories with count, prints "No changes made." -- `--entity`: shows the affected scope without deleting. +- Single: fetches the memory, displays it, and prints "No changes made." (Python: "No changes made (dry run)."). Node also prints "Would delete memory : ". +- `--all`: lists matching memories, prints "Would delete N memories." and the "No changes made" line. In `--json`/`--agent` mode `--all` still requires `--force` even with `--dry-run`, and the command then exits 0 with no output and deletes nothing. Use text mode to see the preview. +- `--entity`: prints "Would delete entity and all its memories." and the "No changes made" line. +- **Warning:** `--all --project` does not honor `--dry-run`. It skips the preview and deletes every memory in the project (after the confirmation, or immediately with `--force`). Never pass `--dry-run` to `--all --project` expecting a preview. This is a known CLI bug in both CLIs, not intended behavior, so do not rely on it. To preview, run `mem0 delete --all --dry-run` per scope (for example `-u alice`) instead. -**Confirmation:** Without `--force`, all destructive modes prompt `[y/N]`. With `--all --project`, the prompt explicitly warns about project-wide deletion. +**Confirmation:** Without `--force`, `--all` and `--entity` prompt `[y/N]`. Single-memory delete never prompts and ignores `--force`. With `--all --project`, the prompt explicitly warns about project-wide deletion and the scope flags are ignored. **`--all --project` behavior:** Sends `DELETE /v1/memories/` with `user_id=*&agent_id=*&app_id=*&run_id=*`. The API returns an async response. The CLI prints "Deletion started. Memories will be removed in the background." @@ -339,7 +404,7 @@ Import memories from a JSON file. | `--agent-id ` | string | - | Override agent ID for all imported items. | | `-o, --output ` | string | `text` | Output format: `text`, `json`. | -**File format:** A JSON array (or single object) where each item has a `memory`, `text`, or `content` field for the text, plus optional `user_id`, `agent_id`, and `metadata` fields. CLI-provided `--user-id` and `--agent-id` override per-item values. +**File format:** A JSON array (or single object) where each item has a `memory`, `text`, or `content` field for the text, plus optional `user_id`, `agent_id`, and `metadata` fields. `--user-id` and `--agent-id` override per-item values, and so do the config defaults when neither flag is given. Items with no text count as failed. **Import format example:** ```json @@ -350,7 +415,7 @@ Import memories from a JSON file. ] ``` -**Behavior:** Iterates through items, calling the add API for each. Displays progress and reports `added` and `failed` counts on completion. +**Behavior:** Iterates through items, calling the add API for each. Displays progress and reports `added` and `failed` counts on completion (text mode writes the summary to stderr in Python and to stdout in Node). In JSON mode the Python CLI sends progress to stderr and includes `scope` in the envelope; the Node CLI writes the progress line to stdout before the JSON (so `| jq` fails) and omits `scope`. Only `-u`, `--agent-id`, `-o`, `--api-key` and `--base-url` are accepted. **Examples:** ```bash @@ -372,6 +437,8 @@ Display current configuration with secrets redacted. |------|------|---------|-------------| | `-o, --output ` | string | `text` | Output format: `text`, `json`. | +**Behavior:** `-o json` (or agent mode) returns the standard envelope with `data` shaped as `{"defaults": {"user_id", "agent_id", "app_id", "run_id"}, "platform": {"api_key", "base_url"}}`. The API key is redacted and unset defaults are `null`. + **Examples:** ```bash mem0 config show @@ -392,9 +459,9 @@ Get a single configuration value. |------|------|----------|-------------| | `key` | string | Yes | Dotted config key (e.g. `platform.api_key`, `defaults.user_id`). | -**Valid keys:** `platform.api_key`, `platform.base_url`, `defaults.user_id`, `defaults.agent_id`, `defaults.app_id`, `defaults.run_id`. +**Valid keys:** `platform.api_key`, `platform.base_url`, `platform.user_email`, `defaults.user_id`, `defaults.agent_id`, `defaults.app_id`, `defaults.run_id`, plus the short forms `api_key`, `base_url`, `user_email`, `user_id`, `agent_id`, `app_id`, `run_id`. Python also resolves any other field path in the config file (e.g. `platform.agent_mode`); Node does not. -API key values are always redacted in output. +An unknown key prints "Unknown config key: " and still exits 0. API key values are always redacted in output. `config get` and `config set` emit a `{key, value}` envelope only in `--json`/`--agent` mode. **Examples:** ```bash @@ -427,19 +494,6 @@ mem0 config set platform.base_url https://api.mem0.ai --- -### `mem0 config clear` - -Clear the configuration file. Removes `~/.mem0/config.json`. - -**Usage:** `mem0 config clear` - -**Examples:** -```bash -mem0 config clear -``` - ---- - ### `mem0 entity list` List all entities of a given type. @@ -507,9 +561,9 @@ List recent background processing events. | Flag | Type | Default | Description | |------|------|---------|-------------| -| `-o, --output ` | string | `table` | Output format: `text` (table), `json`. | +| `-o, --output ` | string | `table` | Output format: `table`, `json`. | -**Behavior:** Fetches all events for the project. Displays a table with columns: Event ID (first 8 chars), Type, Status (color-coded), Latency, Created. Status values: `PENDING`, `SUCCEEDED`, `FAILED`, `PROCESSING`. +**Behavior:** Fetches all events for the project. Displays a table with columns: Event ID (first 8 chars), Type, Status (color-coded), Latency, Created. Status values: `PENDING`, `RUNNING`, `SUCCEEDED`, `FAILED`. **Examples:** ```bash @@ -585,16 +639,15 @@ mem0 status -o json ## Agent Mode Envelope Format -When `--json` or `--agent` is passed, every command wraps its output in a consistent JSON envelope on stdout: +When `--json` or `--agent` is passed, data commands (add, search, list, get, update, delete, import, config, entity, event, status) wrap their output in a consistent JSON envelope on stdout: ```json { "status": "success", "command": "", "duration_ms": 245, - "scope": { "user_id": "alice", "agent_id": null }, + "scope": { "user_id": "alice" }, "count": 10, - "error": null, "data": { ... } } ``` @@ -603,38 +656,47 @@ When `--json` or `--agent` is passed, every command wraps its output in a consis - `status`: `"success"` or `"error"`. - `command`: The command name (e.g. `"search"`, `"add"`, `"list"`). - `duration_ms`: Elapsed time in milliseconds (optional). -- `scope`: Active entity scope, omitted if empty (optional). +- `scope`: Active entity scope with empty values dropped, omitted if empty (optional). - `count`: Number of results, where applicable (optional). -- `error`: Error message string, or `null` on success. -- `data`: Command-specific response data, or `null` on error. +- `data`: Command-specific response data (`null` on error). +- `error`: Present only on error envelopes (see below); success envelopes have no `error` key. +- `mem0_notice`: Present when the platform flags an unclaimed Agent Mode account (optional). **Sanitized data fields per command in agent mode:** | Command | `data` shape | |---------|-------------| -| `add` | `[{id, memory, event}]` or `[{status, event_id}]` for PENDING | -| `search` | `[{id, memory, score, created_at, categories}]` | -| `list` | `[{id, memory, created_at, categories}]` | -| `get` | `{id, memory, created_at, updated_at, categories, metadata}` | -| `update` | `{id, memory}` | -| `delete` | Raw API response | -| `entity list` | `[{name, type, count}]` | +| `add` | `[{id, event}]` for synchronous results (`--no-infer`) or `[{status, event_id}]` for PENDING (default) | +| `search` | `[{id, memory, score, created_at, categories, expiration_date}]` | +| `list` | `[{id, memory, created_at, categories, expiration_date}]` | +| `get` | `{id, memory, created_at, updated_at, categories, metadata, expiration_date}` | +| `update` | `{id, memory, expiration_date}` | +| `delete` (single) | `{id, deleted}` | +| `delete --all` | `{deleted}`, with `scope` in the envelope (Node: raw API result) | +| `delete --all --project` | `{deleted, scope: "project"}` (Node: raw API result) | +| `delete --entity` / `entity delete` | `{deleted}` | +| `entity list` | `[{name, type}]` | | `event list` | `[{id, event_type, status, latency, created_at}]` | | `event status` | `{id, event_type, status, latency, created_at, updated_at, results}` | | `status` | `{connected, backend, base_url}` | -| `config show` | Config object (keys redacted) | -| `import` | `{added, failed, duration_s}` | +| `config show` | `{defaults: {user_id, agent_id, app_id, run_id}, platform: {api_key, base_url}}` (key redacted) | +| `config get` / `config set` | `{key, value}` (agent mode only) | +| `import` | `{added, failed}` | + +**`-o json` without agent mode:** `list`, `status`, `import` and `config show` print the same envelope. `add`, `search`, `get`, `update`, `delete` and `entity delete` print the raw API JSON instead. `entity list`, `event list` and `event status` print the envelope in Node and raw JSON in Python. **Error envelope:** ```json { "status": "error", "command": "search", - "error": "Authentication failed. Your API key may be invalid or expired.", + "error": "Invalid or expired API key.", "data": null } ``` +The `error` text varies by CLI and failure point (for example a 401 after the upfront key check passes returns "Authentication failed. Your API key may be invalid or expired."). Branch on `status`, not on the message. + --- ## Entity ID Resolution @@ -652,19 +714,20 @@ else: use all configured defaults ``` -This applies to commands with `resolveIds: true`: `add`, `search`, `list`, `delete`, `import`. +This applies to `add`, `search`, `list`, `delete --all`, and `import` (user and agent IDs only). Single `delete` and `entity delete` use only explicitly passed flags. --- ## Filter Building -For `search` and `list`, entity IDs and additional filters are composed into the API filter structure: +For `search` and `list`, entity IDs and additional filters are composed into the API filter structure. `--filter` exists only on `search`; `list` builds its extra filters from `--category`, `--after` and `--before`. -1. If the user provides a pre-built filter via `--filter` containing `AND` or `OR` keys, it is passed through to the API as-is. +1. If the user provides a pre-built filter via `--filter` containing `AND` or `OR` keys, it is passed through to the API as-is (entity IDs, including config defaults, are not merged in). 2. Otherwise, the CLI builds an array of AND conditions: - Each entity ID becomes a condition: `{"user_id": "alice"}`, etc. - - Category filters: `{"categories": {"contains": ""}}`. - - Date filters: `{"created_at": {"gte": "YYYY-MM-DD"}}` and/or `{"created_at": {"lte": "YYYY-MM-DD"}}`. + - A `--filter` without `AND`/`OR` contributes each of its top-level keys as a condition. + - Category filters (`list`): `{"categories": {"contains": ""}}`. + - Date filters (`list`): one condition `{"created_at": {"gte": "YYYY-MM-DD", "lte": "YYYY-MM-DD"}}`, with only the bounds you passed. 3. If exactly 1 condition: sent as a single object (no wrapping). 4. If 2+ conditions: wrapped as `{"AND": [condition1, condition2, ...]}`. 5. If 0 conditions: no filter sent. @@ -687,8 +750,8 @@ For `search` and `list`, entity IDs and additional filters are composed into the | `config set` | msg | - | - | - | msg | | `entity list` | - | Y | Y | - | `table` | | `entity delete` | Y | Y | - | Y | `text` | -| `event list` | Y (table) | Y | - | - | `table` | +| `event list` | - | Y | Y | - | `table` | | `event status` | Y | Y | - | - | `text` | | `status` | Y | Y | - | - | `text` | -All commands additionally support agent mode (`--json`/`--agent`) which overrides the output format with the JSON envelope. +Agent mode (`--json`/`--agent`) overrides the output format with the JSON envelope for all data commands above (it applies to `config get` and `config set` too). See the envelope section for how `-o json` differs from agent mode. diff --git a/skills/mem0-cli/references/configuration.md b/skills/mem0-cli/references/configuration.md index 0c5484cfc..51a09ca38 100644 --- a/skills/mem0-cli/references/configuration.md +++ b/skills/mem0-cli/references/configuration.md @@ -13,6 +13,8 @@ Everything about configuring the mem0 CLI: config file format, environment varia The restricted permissions ensure API keys are not world-readable. +Saving an API key also updates an existing `env.MEM0_API_KEY` entry in `~/.claude/settings.json` and existing `export MEM0_API_KEY=...` lines in `~/.zshrc`, `~/.bashrc`, and `~/.bash_profile`. It never creates new entries. + --- ## Config File Schema @@ -28,7 +30,19 @@ The restricted permissions ensure API keys are not world-readable. }, "platform": { "api_key": "", - "base_url": "https://api.mem0.ai" + "base_url": "https://api.mem0.ai", + "user_email": "", + "agent_mode": false, + "created_via": "", + "agent_caller": "", + "claimed_at": "", + "default_user_id": "" + }, + "telemetry": { + "anonymous_id": "" + }, + "agent_rush": { + "acknowledged_at": "" } } ``` @@ -44,12 +58,20 @@ The restricted permissions ensure API keys are not world-readable. | `defaults.run_id` | string | `""` | Default run ID for scoping commands. | | `platform.api_key` | string | `""` | API key for the Mem0 Platform. | | `platform.base_url` | string | `"https://api.mem0.ai"` | Base URL for API requests. | +| `platform.user_email` | string | `""` | Email used for login or claim. Also cached from the ping response during `init`. | +| `platform.agent_mode` | boolean | `false` | `true` while the key is an unclaimed Agent Mode key. | +| `platform.created_via` | string | `""` | How the key was obtained: `agent_mode`, `email`, `api_key`, or `existing_key`. | +| `platform.agent_caller` | string | `""` | Agent name set by `--agent-caller` or `mem0 identify`. | +| `platform.claimed_at` | string | `""` | ISO timestamp once an Agent Mode account is claimed. | +| `platform.default_user_id` | string | `""` | `user_` returned by the Agent Mode bootstrap. Printed by `mem0 whoami`. | +| `telemetry.anonymous_id` | string | `""` | Persistent anonymous ID used for telemetry. | +| `agent_rush.acknowledged_at` | string | `""` | ISO timestamp when the `agent-rush` public-memory warning was acknowledged. | --- ## `mem0 init` Wizard -The `init` command provides two authentication flows: +The `init` command provides three authentication flows: API key, email login, and Agent Mode (see [Agent Mode Init](#agent-mode-init)). ### API Key Flow (default) @@ -65,17 +87,17 @@ mem0 init --api-key m0-xxx --user-id alice 1. Displays the mem0 banner. 2. Checks for existing config. If found with an API key, asks for confirmation to overwrite. -3. Prompts for API key (input masked with `*` characters; supports backspace and Ctrl+U to clear). -4. Prompts for default user ID (default value: `mem0-cli`). -5. Validates the connection by calling the status endpoint. -6. Saves config to `~/.mem0/config.json` with `0600` permissions. -7. Prints success message. +3. Asks how to authenticate (`1` email login, recommended; `2` enter an API key) unless `--api-key` was passed. +4. For option 2, prompts for the API key (input masked with `*` characters; supports backspace and Ctrl+U to clear). +5. Prompts for default user ID (default value: `$USER`, then `$USERNAME`, then `mem0-cli`) unless `--user-id` was passed. +6. Validates the connection by calling the status endpoint. A failed check prints an error but the config is still saved. +7. Saves config to `~/.mem0/config.json` with `0600` permissions. +8. Prints success message. -**Non-interactive mode:** When both `--api-key` and `--user-id` are provided, skips all prompts and saves directly. When running in a non-TTY without both flags, prints an error: +**Non-interactive mode:** When both `--api-key` and `--user-id` are provided, skips all prompts and saves directly. In a non-TTY, `--api-key` alone is enough: the user ID falls back to `$USER`, then `$USERNAME`, then `mem0-cli`. A non-TTY without `--api-key` (and without `--email` or an Agent Mode signal) prints an error: ``` -Non-interactive terminal detected and missing required flags. -Usage: mem0 init --api-key --user-id +Non-interactive terminal detected and --api-key is required. ``` ### Email Login Flow @@ -92,14 +114,23 @@ mem0 init --email alice@company.com --code 482901 1. Sends a 6-digit verification code to the email via `POST /api/v1/auth/email_code/`. 2. If `--code` is provided, verifies immediately. Otherwise prompts for the code. -3. On success: receives API key, org_id, and project_id from the server. -4. Saves to config. Creates a new account if the email is not registered. +3. On success: receives the API key from the server and saves it with `platform.user_email` and `platform.created_via: "email"`. The default user ID is `--user-id`, else `$USER`, else `mem0-cli`. -Cannot be combined with `--api-key`. +Without `--code` in a non-TTY, `init` sends the code and exits with an error telling you to rerun with `--code`. `--code` requires `--email`, and `--email` cannot be combined with `--api-key`. + +**Claiming an Agent Mode account:** If the existing config is an unclaimed Agent Mode key (`platform.agent_mode: true`), `mem0 init --email [--code ]` claims that key for the email instead of minting a new one. The API key stays the same. + +### Agent Mode Init + +```bash +mem0 init --agent --agent-caller --json +``` + +With `init --agent`, `init --json`, or an agent environment variable (such as `CLAUDECODE`, `CURSOR_AGENT`, `CODEX_CLI`, `CLINE`, `AIDER_SESSION`, `GOOSE_AGENT`, `WINDSURF_AGENT`) and no `--api-key` or `--email`, `init` first reuses a valid `MEM0_API_KEY` or a valid key already in the config. Only when there is no valid key does it mint a new Agent Mode key via `POST /api/v1/auth/agent_mode/`, which is limited to 5 signups per day per network. See [command-reference.md](command-reference.md) for the `init` flags and `identify`. ### Force Overwrite -If `~/.mem0/config.json` already exists with an API key, `mem0 init` warns and asks for confirmation. Use `--force` to skip: +If `~/.mem0/config.json` already exists with an API key, `mem0 init` warns and asks for confirmation (in a non-TTY it exits 1 with "Existing config would be overwritten." instead). Use `--force` to skip: ```bash mem0 init --api-key m0-new-key --user-id alice --force @@ -111,7 +142,7 @@ mem0 init --api-key m0-new-key --user-id alice --force ### `mem0 config show` -Displays the current configuration as a formatted table (text mode) or JSON envelope (json mode). API keys are always redacted. +Displays `defaults.*`, `platform.api_key` (redacted), and `platform.base_url` as a formatted table (text mode) or JSON envelope (json mode). Other `platform.*` fields are not shown. ```bash mem0 config show @@ -120,7 +151,7 @@ mem0 config show -o json ### `mem0 config get ` -Reads a single configuration value. The key uses dotted notation. +Reads a single configuration value. The key uses dotted notation or a short alias (`api_key`, `base_url`, `user_email`, `user_id`, `agent_id`, `app_id`, `run_id`). ```bash mem0 config get platform.api_key # prints: m0-x...xxxx (redacted) @@ -130,12 +161,13 @@ mem0 config get defaults.user_id # prints: alice **Valid keys:** - `platform.api_key` - `platform.base_url` +- `platform.user_email` - `defaults.user_id` - `defaults.agent_id` - `defaults.app_id` - `defaults.run_id` -Unknown keys print an error message. +Python also resolves any other field path in the config (for example `platform.created_via`); Node accepts only the keys above and their short aliases. Unknown keys print "Unknown config key: " and still exit 0, so check the output rather than the exit code. In `--json`/`--agent` mode `config get` and `config set` return `{"key": ..., "value": ...}` in the envelope. ### `mem0 config set ` @@ -148,17 +180,9 @@ mem0 config set platform.base_url https://api.mem0.ai **Type coercion:** - Boolean fields accept `true`, `1`, `yes` (case-insensitive) as true. Anything else is false. -- Integer fields are parsed with `parseInt`. +- Integer fields are parsed as integers (Node `parseInt`, Python `int`; Python rejects a non-numeric value as an unknown key). - String fields are stored as-is. -### `mem0 config clear` - -Removes the config file (`~/.mem0/config.json`). - -```bash -mem0 config clear -``` - --- ## Environment Variables @@ -173,6 +197,7 @@ Environment variables override config file values but are overridden by CLI flag | `MEM0_AGENT_ID` | `defaults.agent_id` | string | `""` | | `MEM0_APP_ID` | `defaults.app_id` | string | `""` | | `MEM0_RUN_ID` | `defaults.run_id` | string | `""` | +| `MEM0_TELEMETRY` | n/a | string | enabled. Set to `false` to disable anonymous telemetry. | --- @@ -218,7 +243,10 @@ The `config get` and `config set` commands use dotted key paths. Here is the ful |------------|---------|-------| | `platform.api_key` | platform | api_key | | `platform.base_url` | platform | base_url | +| `platform.user_email` | platform | user_email | | `defaults.user_id` | defaults | user_id | | `defaults.agent_id` | defaults | agent_id | | `defaults.app_id` | defaults | app_id | | `defaults.run_id` | defaults | run_id | + +Short aliases (`api_key`, `base_url`, `user_email`, `user_id`, `agent_id`, `app_id`, `run_id`) map to the same fields. Python additionally resolves any other dotted field path. diff --git a/skills/mem0-cli/references/workflows.md b/skills/mem0-cli/references/workflows.md index 58a441abb..ff8b41aff 100644 --- a/skills/mem0-cli/references/workflows.md +++ b/skills/mem0-cli/references/workflows.md @@ -6,11 +6,11 @@ Practical recipes for using the mem0 CLI in scripts, pipelines, and agent loops. ## Piping Content via Stdin -The CLI reads from stdin when no text argument is provided and input is piped (not a TTY). This works with `add`, `search`, and `update`. +The CLI reads from stdin when no text argument is provided and stdin is a pipe or a redirected file. This works with `add`, `search`, and `update`. It never reads stdin in `--json`/`--agent` mode for `add`, and Python also skips it there for `search` and `update`, so pass the text as an argument in agent mode. **Stdin detection method:** -- Python: `not sys.stdin.isatty()` -- Node: `!process.stdin.isTTY` +- Python: `os.fstat(sys.stdin.fileno())` is a FIFO or a regular file +- Node: `fs.fstatSync(0)` is a FIFO or a regular file ### Add from pipe @@ -69,7 +69,7 @@ The file should be a JSON array where each item has a `memory`, `text`, or `cont ] ``` -CLI-provided `--user-id` overrides per-item `user_id` values. +Items may also carry `agent_id`. CLI-provided `--user-id` and `--agent-id` (or configured defaults) override per-item values. A single JSON object is treated as a one-item array, and items without `memory`, `text`, or `content` are counted as failed. ### Import with JSON output @@ -82,21 +82,24 @@ Output: { "status": "success", "command": "import", - "data": { "added": 42, "failed": 0, "duration_s": 3.14 }, - "duration_ms": 3140 + "duration_ms": 3140, + "scope": { "user_id": "alice" }, + "data": { "added": 42, "failed": 0 } } ``` +This is the Python CLI output. The Node CLI omits `scope` and writes the `Importing memories... n/n` progress line to stdout before the JSON, so its output cannot be piped to `jq`. + --- ## Agent Mode for LLM Consumption -Use `--json` or `--agent` to get structured JSON output suitable for LLM tool calling or agent frameworks. Spinners and progress always go to stderr, keeping stdout clean. +Use `--json` or `--agent` to get structured JSON output suitable for LLM tool calling or agent frameworks. Spinners and progress always go to stderr, keeping stdout clean. Put the flag before the subcommand so it works in both the Python and Node CLIs. ### Search with agent mode ```bash -mem0 search "preferences" --user-id alice --agent +mem0 --agent search "preferences" --user-id alice ``` Output (stdout): @@ -107,7 +110,6 @@ Output (stdout): "duration_ms": 187, "scope": { "user_id": "alice" }, "count": 2, - "error": null, "data": [ { "id": "mem-abc", "memory": "User prefers dark mode", "score": 0.95, "created_at": "2025-01-15T10:00:00Z", "categories": ["preferences"] }, { "id": "mem-def", "memory": "User likes monospace fonts", "score": 0.82, "created_at": "2025-01-15T10:01:00Z", "categories": ["preferences"] } @@ -118,7 +120,7 @@ Output (stdout): ### Add with agent mode ```bash -mem0 add "Uses Python 3.12" --user-id alice --json +mem0 --json add "Uses Python 3.12" --user-id alice ``` ### Error handling in agent mode @@ -126,7 +128,7 @@ mem0 add "Uses Python 3.12" --user-id alice --json Errors also return valid JSON with `"status": "error"`: ```bash -mem0 search "test" --user-id alice --api-key invalid --agent +mem0 --agent search "test" --user-id alice --api-key invalid ``` Output: @@ -134,7 +136,7 @@ Output: { "status": "error", "command": "search", - "error": "Authentication failed. Your API key may be invalid or expired.", + "error": "Invalid or expired API key.", "data": null } ``` @@ -143,30 +145,30 @@ Output: ## JSON Output + jq -Use `--output json` (or `-o json`) for raw JSON output, then pipe to `jq` for processing. +Use `--output json` (or `-o json`) for JSON output, then pipe to `jq` for processing. `search`, `get`, `add`, `update`, and `delete` print the raw API response. `list`, `status`, and `import` print the standard envelope instead, so read the results from `.data`. Piping `import` to `jq` works only with the Python CLI (Node writes its progress line to stdout ahead of the JSON). ### Extract just memory text ```bash -mem0 list --user-id alice --output json | jq '.[] | .memory' +mem0 list --user-id alice --output json | jq '.data[] | .memory' ``` ### Get memory IDs ```bash -mem0 list --user-id alice -o json | jq '.[].id' +mem0 list --user-id alice -o json | jq '.data[].id' ``` ### Count memories ```bash -mem0 list --user-id alice -o json | jq 'length' +mem0 list --user-id alice -o json | jq '.count' ``` ### Filter by category in jq ```bash -mem0 list --user-id alice -o json | jq '[.[] | select(.categories[]? == "preferences")]' +mem0 list --user-id alice -o json | jq '[.data[] | select(.categories[]? == "preferences")]' ``` ### Extract search scores @@ -183,7 +185,7 @@ mem0 search "tools" --user-id alice -o json | jq '.[] | {memory, score}' ```bash # Get IDs, then delete each one -mem0 list --user-id alice -o json | jq -r '.[].id' | while read id; do +mem0 list --user-id alice -o json | jq -r '.data[].id' | while read id; do mem0 delete "$id" --force done ``` @@ -199,7 +201,7 @@ done < memories.txt ### Copy memories between users ```bash -mem0 list --user-id alice -o json | jq -r '.[].memory' | while IFS= read -r mem; do +mem0 list --user-id alice -o json | jq -r '.data[].memory' | while IFS= read -r mem; do mem0 add "$mem" --user-id bob done ``` @@ -216,7 +218,7 @@ mem0 list --user-id alice -o json > alice_memories.json page=1 while true; do result=$(mem0 list --user-id alice -o json --page "$page" --page-size 100) - count=$(echo "$result" | jq 'length') + count=$(echo "$result" | jq '.count') if [ "$count" -eq 0 ]; then break fi @@ -271,7 +273,7 @@ mem0 add "CI run started" --user-id ci-bot ```bash test_summary=$(cat test-results.txt | head -20) -mem0 add "$test_summary" --agent-id ci-bot --metadata '{"type":"test-results"}' --categories "ci,testing" +mem0 add "$test_summary" --agent-id ci-bot --metadata '{"type":"test-results"}' ``` --- @@ -282,11 +284,11 @@ The CLI reads from stdin only when ALL of these conditions are met: 1. No text argument was provided on the command line. 2. For `add`: no `--messages` and no `--file` flag. -3. For `update`: no `--metadata` flag. -4. stdin is piped (not a TTY). +3. stdin is a pipe or a redirected file (a plain non-TTY such as `/dev/null` does not count). +4. The CLI is not in `--json`/`--agent` mode (`add` in both CLIs, `search` and `update` in Python). **This means:** -- `mem0 add --user-id alice` in an interactive terminal will NOT hang waiting for input. It will print a usage error. +- `mem0 add --user-id alice` in an interactive terminal will NOT hang waiting for input. It exits 1 with "No content provided". - `echo "text" | mem0 add --user-id alice` will read "text" from stdin. - `mem0 add "explicit text" --user-id alice` will use the explicit text, even if stdin is piped. @@ -303,8 +305,7 @@ The CLI reads from stdin only when ALL of these conditions are met: ```bash set -e # Exit on error -# This will exit the script if the API key is invalid -mem0 status > /dev/null 2>&1 +mem0 status -o json | jq -e '.data.connected' > /dev/null # Add with error check if mem0 add "test memory" --user-id alice 2>/dev/null; then @@ -317,10 +318,16 @@ fi ### Capture memory ID from add +Default adds are asynchronous and return an `event_id`. Use `--no-infer` for a synchronous add whose `.data[0].id` is the memory id. + ```bash -# Use agent mode to get structured output -result=$(mem0 add "new fact" --user-id alice --agent 2>/dev/null) -memory_id=$(echo "$result" | jq -r '.data[0].id // empty') +event_id=$(mem0 --agent add "new fact" --user-id alice 2>/dev/null | jq -r '.data[0].event_id // empty') +for _ in $(seq 30); do + status=$(mem0 --agent event status "$event_id" | jq -r '.data.status') + [ "$status" = "SUCCEEDED" ] || [ "$status" = "FAILED" ] && break + sleep 2 +done +memory_id=$(mem0 --agent event status "$event_id" | jq -r '.data.results[0].id // empty') if [ -n "$memory_id" ]; then echo "Created memory: $memory_id" fi @@ -330,7 +337,7 @@ fi ```bash # Only add if search returns no results -count=$(mem0 search "dark mode" --user-id alice --agent 2>/dev/null | jq '.count // 0') +count=$(mem0 --agent search "dark mode" --user-id alice 2>/dev/null | jq '.count // 0') if [ "$count" -eq 0 ]; then mem0 add "User prefers dark mode" --user-id alice fi @@ -358,7 +365,7 @@ mem0 list ### Timeout handling -The CLI uses a 30-second timeout for all API requests. For long-running scripts, handle timeouts: +The CLI uses a 30-second timeout for normal API requests (the key-validation ping uses 5 seconds and `init` uses 5, 10 and 30 seconds). For long-running scripts, handle timeouts: ```bash if ! mem0 search "query" --user-id alice -o json 2>/dev/null; then @@ -382,13 +389,13 @@ Or use the event system to poll for completion: ```bash # Add and capture event ID from agent output -result=$(mem0 add "new preference" --user-id alice --agent 2>/dev/null) +result=$(mem0 --agent add "new preference" --user-id alice 2>/dev/null) event_id=$(echo "$result" | jq -r '.data[0].event_id // empty') if [ -n "$event_id" ]; then # Poll until processing completes while true; do - status=$(mem0 event status "$event_id" --agent 2>/dev/null | jq -r '.data.status') + status=$(mem0 --agent event status "$event_id" 2>/dev/null | jq -r '.data.status') if [ "$status" = "SUCCEEDED" ] || [ "$status" = "FAILED" ]; then break fi @@ -413,16 +420,16 @@ shift 2 case "$ACTION" in recall) - mem0 search "$*" --user-id "$USER_ID" --agent 2>/dev/null + mem0 --agent search "$*" --user-id "$USER_ID" 2>/dev/null ;; remember) - mem0 add "$*" --user-id "$USER_ID" --agent 2>/dev/null + mem0 --agent add "$*" --user-id "$USER_ID" 2>/dev/null ;; forget) - mem0 delete --all --user-id "$USER_ID" --force --agent 2>/dev/null + mem0 --agent delete --all --user-id "$USER_ID" --force 2>/dev/null ;; history) - mem0 list --user-id "$USER_ID" --agent 2>/dev/null + mem0 --agent list --user-id "$USER_ID" 2>/dev/null ;; *) echo '{"status":"error","error":"Unknown action: '"$ACTION"'"}' >&2 diff --git a/skills/mem0-integrate/SKILL.md b/skills/mem0-integrate/SKILL.md index 34dfd284f..a18bbf270 100644 --- a/skills/mem0-integrate/SKILL.md +++ b/skills/mem0-integrate/SKILL.md @@ -15,7 +15,7 @@ description: > license: Apache-2.0 metadata: author: mem0ai - version: "0.1.0" + version: "0.1.1" category: ai-memory tags: "memory, integration, tdd, platform, oss" mem0_tested_versions: "mem0ai (PyPI) >=2.0.0,<3.0.0; mem0ai (npm) >=3.0.0,<4.0.0" @@ -36,7 +36,7 @@ of the Mem0 API. - Scope-tagged docs index: https://docs.mem0.ai/llms.txt - Full docs (single file, deep dives): https://docs.mem0.ai/llms-full.txt - OpenAPI spec (Platform REST, machine-readable): https://docs.mem0.ai/openapi.json -- Hosted MCP server: https://mcp.mem0.ai (requires Platform API key) +- Hosted MCP server: https://mcp.mem0.ai/mcp (requires Platform API key) - Integrations index: https://docs.mem0.ai/integrations ### Published Mem0 skills — delegate; do not reimplement @@ -109,7 +109,7 @@ the target stack. If yes, delegate — copy its call-site pattern into |---|---|---| | `@ai-sdk/*` + `ai` in `package.json` | `skills/mem0-vercel-ai-sdk` | Integration is via `createMem0` provider wrapper, not raw `MemoryClient`. | | CLI-only repo (Typer, Commander, Click, Cobra) with no LLM call sites | `skills/mem0-cli` | Call sites are command handlers, not model wrappers. Consider whether mem0 actually fits first. | -| Target is an MCP client / editor config (Claude Code, Cursor, Codex settings) | `integrations/mem0-agent-plugin` | Wire via MCP server URL + hooks; no SDK code usually needed. | +| Target is an MCP client / editor config (Claude Code, Cursor, Codex settings) | `integrations/mem0-agent-plugin` | Local stdio MCP server (one search tool) plus skills, no hooks or automatic capture; for a hosted endpoint use `https://mcp.mem0.ai/mcp`. No SDK code usually needed. | | Any other Python or TS repo with an LLM call site | `skills/mem0` | Default SDK integration path. | Record the delegated skill's raw URL in `plan.md` under a @@ -168,7 +168,7 @@ start executing a step; the summary below is only for routing. | `trace.jsonl` | Every tool call, decision, and subagent exchange this run. | Overwritten per run. | | `diff.patch` | The committed integration as a reviewable patch. | Overwritten per run. | | `heal-trace.md` | Per-attempt record of the self-healing loop (step 10). | Overwritten per run. | -| `product.json` | `{"product": "platform"\|"oss", "language": "...", "mem0_version": "...", "write_site": "file:line", "read_site": "file:line", "feature_flag": "MEM0_ENABLED"}` — consumed by the verification skill. | Overwritten per run. | +| `product.json` | `{"product": "platform"\|"oss", "language": "...", "mem0_version": "...", "write_site": "file:line", "read_site": "file:line", "feature_flag": "MEM0_ENABLED", "preferred_site": ""}`, consumed by the verification skill. | Overwritten per run. | `.mem0-integration/` is added to `.gitignore` on first run. Nothing is written outside this directory and the repo's source tree. diff --git a/skills/mem0-integrate/references/pipeline.md b/skills/mem0-integrate/references/pipeline.md index da8d42495..f1692b766 100644 --- a/skills/mem0-integrate/references/pipeline.md +++ b/skills/mem0-integrate/references/pipeline.md @@ -116,8 +116,11 @@ Present in env, continue. Mode**: run `mem0 init --agent --agent-caller --json` (after `pip install mem0-cli` or `npm install -g @mem0/cli`), substituting your agent identity such as `claude-code`, `cursor`, `codex`. If you forgot -`--agent-caller`, run `mem0 identify ` after init. Cache the key to -`.env` with user consent and continue. Tell the user to claim it later with +`--agent-caller`, run `mem0 identify ` after init. Init does not +print the key: it saves it to `~/.mem0/config.json` (`platform.api_key`, file +mode 0600) and reuses a valid key already there instead of minting a new one, +so read the key from that file. Cache the key to `.env` with user consent and +continue. Tell the user to claim it later with `mem0 init --email `: same key, no agent disruption. Missing and **CI mode** (`MEM0_INTEGRATE_CI=1`), exit code 2 with the name of @@ -184,8 +187,8 @@ Then write `.mem0-integration/plan.md`: call client.add([user_msg, assistant_msg], user_id=)."> **Read pattern:** , limit=5) - and inject results as a system message."> + call client.search(latest_user_msg, filters={"user_id": }, + top_k=5) and inject results["results"] as a system message."> **User identifier source:** @@ -276,7 +279,8 @@ test framework: Test assertion shapes must match the **canonical signatures**: - Platform method signatures: `https://docs.mem0.ai/openapi.json`, the request - body schemas for `/v1/memories/` and `/v1/memories/search/`. + body schemas for `/v3/memories/add/` and `/v3/memories/search/` (the + `/v1/memories/` POST and `/v1/memories/search/` paths are deprecated). - OSS method signatures: the delegated skill named in `plan.md` (fetched from its raw URL), or `skills/mem0/SKILL.md` as the default. - Do not hand-roll request shapes. If the delegated skill has an example @@ -341,7 +345,8 @@ Otherwise loop: 1. **Categorize the failing check** from `scorecard.json` and route: - `install` / `static_checks`, dependency or import fix. - - `unit_tests`, wiring or assertion fix. + - `unit_tests_flag_on`, wiring or assertion fix. (`unit_tests_flag_off` + failing is the non-invasiveness case below.) - `smoke_test`, API key or SDK call-shape fix. - `e2e_test`, recipe, flag-wiring, or integration-point fix. - **Pre-existing test failure** (test skill exit code 7, @@ -351,7 +356,7 @@ Otherwise loop: 2. **Spawn a remediation subagent** with fresh context. Inputs: `plan.md`, `goal.md`, `scorecard.md`, `scorecard.json`, the last committed diff, and - the relevant log for the failing category (`test-stdout.log` / + the relevant log for the failing category (`test-stdout-flag-on.log` / `smoke-stdout.log` / `e2e-app.log` / `e2e-calls.log`). Use the remediation prompt in [`subagent-prompts.md`](subagent-prompts.md) verbatim. diff --git a/skills/mem0-integrate/references/subagent-prompts.md b/skills/mem0-integrate/references/subagent-prompts.md index 811f0483b..835d6a952 100644 --- a/skills/mem0-integrate/references/subagent-prompts.md +++ b/skills/mem0-integrate/references/subagent-prompts.md @@ -31,7 +31,8 @@ so paraphrasing them drops constraints the review step then has to catch. 6. Preserve everything listed under plan.md's "Preserved behavior" and "Coexistence." 7. Lazy client construction. `MemoryClient()` validates the API - key in `__init__` (it makes a network call). Never instantiate + key in `__init__` (Python pings the API; TS throws on a missing + or blank key and pings in the background). Never instantiate it at module-import time, construct on first use inside the request / handler path. The same rule applies to OSS `Memory()`, which can eagerly initialize embedding and LLM providers. Use diff --git a/skills/mem0-oss-to-platform/README.md b/skills/mem0-oss-to-platform/README.md index 2f28e0ac6..b26202c21 100644 --- a/skills/mem0-oss-to-platform/README.md +++ b/skills/mem0-oss-to-platform/README.md @@ -71,7 +71,7 @@ curl -X POST https://api.anthropic.com/v1/skills \ - [Mem0 Platform Dashboard](https://app.mem0.ai) - [Mem0 Documentation](https://docs.mem0.ai) -- [OSS → Platform migration guide](https://docs.mem0.ai/migration/oss-v2-to-v3) +- [OSS → Platform migration guide](https://docs.mem0.ai/migration/oss-to-platform) - [Platform vs OSS comparison](https://docs.mem0.ai/platform/platform-vs-oss) ## License diff --git a/skills/mem0-oss-to-platform/SKILL.md b/skills/mem0-oss-to-platform/SKILL.md index 1cdde7dff..57048d462 100644 --- a/skills/mem0-oss-to-platform/SKILL.md +++ b/skills/mem0-oss-to-platform/SKILL.md @@ -1,18 +1,22 @@ --- name: mem0-oss-to-platform description: >- - Plan and then execute a migration of a project from the mem0 open-source / self-hosted SDK - (the local `Memory` class) to the mem0 Platform / hosted / managed SDK (the `MemoryClient` - class). Use this whenever a developer wants to move, switch, or migrate their mem0 usage off - OSS/self-hosted to the hosted API — e.g. "migrate my mem0 setup to the platform", "switch from - self-hosted mem0 to MemoryClient", "use my mem0 API key instead of a local Qdrant", "move mem0 - to the cloud/hosted/managed service", or "replace my local mem0 vector store + embedder config - with the platform". Applies to Python (`from mem0 import Memory` → `from mem0 import MemoryClient`) - and TypeScript/JavaScript (`import { Memory } from "mem0ai/oss"` → `import MemoryClient from "mem0ai"`). - Trigger even when the user doesn't say the word "migrate" but clearly wants their existing mem0 - integration to run against the hosted platform. It first produces a reviewable migration plan, - then executes it after the developer approves. Strictly scoped to the mem0 integration — it does - not refactor, restructure, or "improve" any unrelated code. + Plan, then execute, a migration of a project from the mem0 open-source / self-hosted SDK + (local `Memory` class) to the mem0 Platform / hosted SDK (`MemoryClient`). TRIGGER when: the + developer wants to move, switch, or migrate mem0 off OSS/self-hosted to the hosted API, e.g. + "migrate my mem0 setup to the platform", "switch from self-hosted mem0 to MemoryClient", "use my + mem0 API key instead of a local Qdrant", "replace my local vector store + embedder config with + the platform", even without the word "migrate". Covers Python (`Memory` to `MemoryClient`) and + TypeScript (`mem0ai/oss` to `mem0ai`). Produces a reviewable plan, then executes it after + approval. Touches only the mem0 integration. DO NOT TRIGGER when: adding mem0 to a project that + has none (use `mem0-integrate`) or answering SDK usage questions (use `mem0`). +license: Apache-2.0 +metadata: + author: mem0ai + version: "0.2.0" + category: ai-memory + tags: "migration, oss, self-hosted, platform, hosted" + mem0_tested_versions: "mem0ai (PyPI) >=2.0.0,<3.0.0; mem0ai (npm) >=3.0.0,<4.0.0" --- # Migrate mem0 OSS → mem0 Platform (hosted) @@ -35,7 +39,8 @@ few parameter conventions tighten up and the return values are server responses. So the core of every migration is: 1. `Memory` / `Memory.from_config({...})` → `MemoryClient()` (reads the API key from the env). -2. Delete the local `vector_store` / `llm` / `embedder` / `graph_store` / `history_db_path` config. +2. Delete the local `vector_store` / `llm` / `embedder` / `reranker` / `history_db_path` config (and any + leftover `graph_store`). 3. Fix up each call site to the hosted call convention (entity IDs into `filters`, pagination, etc.). 4. Flag everything that *isn't* a clean 1:1 so the developer can decide (see `references/gotchas.md`). @@ -55,10 +60,11 @@ must be set (in `.env` / secrets manager, never hardcoded) before execution and ### Phase 1 — Discover the mem0 footprint Do not assume the layout. Find every place mem0 appears. Detect the language and the **installed** version first, then sweep for usage. Concretely, search for: -- **Imports / instantiation:** `from mem0 import Memory`, `Memory.from_config`, `Memory(`, - `import ... from "mem0ai"`, `from "mem0ai/oss"`, `new Memory(`. -- **Config blocks:** keys like `vector_store`/`vectorStore`, `embedder`, `llm`, `graph_store`/ - `graphStore`, `history_db_path`, `historyStore`, `custom_fact_extraction_prompt`, +- **Imports / instantiation:** `from mem0 import Memory`, `AsyncMemory`, `Memory.from_config`, + `Memory(`, `import ... from "mem0ai"`, `from "mem0ai/oss"`, `new Memory(`. +- **Config blocks:** keys like `vector_store`/`vectorStore`, `embedder`, `llm`, `reranker`, + `graph_store`/`graphStore`, `history_db_path`/`historyDbPath`, `historyStore`, + `custom_instructions`/`customInstructions`, `custom_fact_extraction_prompt`/`customPrompt`, `custom_update_memory_prompt`, `enable_graph`. - **Every call site:** `.add(`, `.search(`, `.get_all(`/`.getAll(`, `.delete_all(`/`.deleteAll(`, `.get(`, `.update(`, `.delete(`, `.reset(`, `.history(`. @@ -78,11 +84,14 @@ confirm the **real** signatures of the installed package rather than trusting me `site-packages/mem0/client/main.py` if anything is ambiguous (e.g. whether a method *rejects* top-level entity params). Also check the OSS side the project currently uses. - **TypeScript:** read the installed types/dist under `node_modules/mem0ai/` to confirm option names - (`limit` vs `topK`, `userId` vs a nested `filters`) and the default vs `mem0ai/oss` export. + (`limit` vs `topK`, `userId` vs a nested `filters: { user_id }`) and the default vs `mem0ai/oss` + export. This verification step is the single most important habit — it's what keeps the plan correct across mem0 versions. Then consult `references/api-mapping.md` for the OSS→hosted translation of each -method (Python and TypeScript), and the official guide at https://docs.mem0.ai/migration/oss-v2-to-v3. +method (Python and TypeScript). The docs guide is https://docs.mem0.ai/migration/oss-to-platform +(verify its code samples against the installed SDK); OSS upgrade changes are at +https://docs.mem0.ai/migration/oss-v2-to-v3. ### Phase 3 — Map each site and flag the gaps For every call site and config block from Phase 1, determine the hosted equivalent using the @@ -90,7 +99,8 @@ mapping. Most calls map cleanly. Some don't — and those matter more than the m Read `references/gotchas.md` and flag anything that needs a human decision: self-hosted/data- residency setups, local model choices moving server-side, graph-memory usage, custom prompts, hot- path calls that now make network round-trips, and **existing locally-stored memories not carrying -over** (data migration is out of scope unless the developer asks — note it, don't silently attempt it). +over** (data migration is out of scope unless the developer asks: note it, don't silently attempt it; +if they do ask, see `references/gotchas.md` #1, which covers the hosted-Qdrant migration script). ### Phase 4 — Write the plan and stop Write the full plan to `MEM0_MIGRATION_PLAN.md` at the repo root, following the structure in @@ -106,11 +116,13 @@ Once the developer approves (they may ask for changes first — incorporate them - **Verify**, mirroring how you'd confirm any backend swap: - It imports / type-checks / byte-compiles. - A smoke test exercises `add` → `search`/`get_all` → `delete_all` against the hosted API with a - real `MEM0_API_KEY`, and the app's own entry point still runs. - - No local mem0 storage directory gets created anymore (e.g. a `.mem0/`, local Qdrant path) — - proof the memory really lives on the platform now. + real `MEM0_API_KEY`, and the app's own entry point still runs. Hosted `add` is asynchronous, so + allow a short wait before expecting the fact to show up in `search`/`get_all`. + - No local OSS storage gets created anymore (e.g. `~/.mem0/history.db`, a local Qdrant path). The + client itself still creates `~/.mem0/config.json`, so don't use the bare `.mem0/` directory as + the check. - Report what changed, what was verified, and any flagged concerns the developer still needs to act - on (e.g. configuring custom instructions in the dashboard, migrating old data). + on (e.g. re-applying custom instructions with `project.update`, migrating old data). ## Reference files - `references/api-mapping.md` — exact OSS→hosted method/param/return mapping for Python and diff --git a/skills/mem0-oss-to-platform/references/api-mapping.md b/skills/mem0-oss-to-platform/references/api-mapping.md index 3e16f7e8b..c9d738516 100644 --- a/skills/mem0-oss-to-platform/references/api-mapping.md +++ b/skills/mem0-oss-to-platform/references/api-mapping.md @@ -1,16 +1,17 @@ # OSS → Platform API mapping Exact translation of the mem0 OSS (self-hosted `Memory`) API to the hosted `MemoryClient` API. -**Always confirm against the installed package** (see SKILL.md Phase 2) — versions drift. The facts -below match `mem0ai` 2.0.x (the v3 platform API) and the official guide: -https://docs.mem0.ai/migration/oss-v2-to-v3 +**Always confirm against the installed package** (see SKILL.md Phase 2), since versions drift. The +facts below match Python `mem0ai` 2.2.x and TypeScript `mem0ai` 3.3.x (the `/v3/memories/*` platform +API). Moving stored data: https://docs.mem0.ai/migration/oss-to-platform. OSS upgrade changes +(Python 1.x to 2.x, TS 2.x to 3.x): https://docs.mem0.ai/migration/oss-v2-to-v3 ## Contents - [Python](#python) - [TypeScript / JavaScript](#typescript--javascript) - [Return shapes](#return-shapes) - [Dependencies & environment](#dependencies--environment) -- [v2→v3 default/behavior changes](#v2v3-defaultbehavior-changes) +- [OSS vs Platform defaults and behavior](#oss-vs-platform-defaults-and-behavior) --- @@ -35,28 +36,38 @@ memory = MemoryClient() # reads MEM0_API_KEY from the env ``` Notes: - The client reads `MEM0_API_KEY` from the environment when `api_key` is omitted. -- **Drop** `vector_store`, `llm`, `embedder`, `graph_store`, `history_db_path` — these are managed - server-side now. -- **Drop** `org_id` / `project_id` constructor args if present — they're resolved from the API key - in v3. +- **Drop** `vector_store`, `llm`, `embedder`, `reranker`, `history_db_path`, `version` (and + `graph_store` if a pre-2.0 config still has it): these are managed server-side now. +- `custom_instructions` does have a hosted equivalent: `client.project.update(custom_instructions=...)` + (project-wide) or `custom_instructions=` on `add()`. +- **Drop** `org_id` / `project_id` constructor args if present, they're resolved from the API key. - For async codebases, use `AsyncMemoryClient` (same methods, `await`-ed). ### Method calls | Operation | OSS `Memory` | Hosted `MemoryClient` | |---|---|---| -| add | `memory.add(messages, user_id="u")` | `memory.add(messages, user_id="u")` — unchanged (top-level entity IDs accepted) | -| search | `memory.search(q, user_id="u", limit=N)` *(older)* or `…, filters={"user_id":"u"}, top_k=N` *(newer)* | `memory.search(q, filters={"user_id": "u"}, top_k=N)` — entity IDs **must** be inside `filters`; top-level `user_id`/`agent_id`/`app_id`/`run_id` raise `ValueError` | -| get_all | `memory.get_all(user_id="u")` or `…, filters={"user_id":"u"}` | `memory.get_all(filters={"user_id": "u"}, page=1, page_size=N)` — entity IDs in `filters`; paginated with `page`/`page_size` (**not** `top_k`) | -| delete_all | `memory.delete_all(user_id="u")` | `memory.delete_all(user_id="u")` — unchanged | +| add | `memory.add(messages, user_id="u")` | `memory.add(messages, user_id="u")`: same call (top-level entity IDs accepted, plus `app_id`), but the return value differs (see Return shapes) | +| search | `memory.search(q, filters={"user_id": "u"}, top_k=N)` (pre-2.0 code used top-level `user_id=` and `limit=`) | `memory.search(q, filters={"user_id": "u"}, top_k=N)`: entity IDs **must** be inside `filters`; top-level `user_id`/`agent_id`/`app_id`/`run_id` raise `ValueError` (on OSS 2.x too) | +| get_all | `memory.get_all(filters={"user_id": "u"}, top_k=N)` (not paginated) | `memory.get_all(filters={"user_id": "u"}, page=1, page_size=N)`: entity IDs in `filters`; paginated with `page`/`page_size` (**not** `top_k`) | +| delete_all | `memory.delete_all(user_id="u")` | `memory.delete_all(user_id="u")`: same call (entity IDs are query params, at least one is required, `"*"` is a wildcard). `delete_all(filters=...)` is **not** a Platform form | | get | `memory.get(memory_id)` | `memory.get(memory_id)` | -| update | `memory.update(memory_id, text=...)` *(`data=` is a deprecated alias)* | `memory.update(memory_id, text=...)` — unchanged | +| update | `memory.update(memory_id, text=...)` *(`data=` is a deprecated alias)* | `memory.update(memory_id, text=..., metadata=...)`: use keyword `text=`. A positional string (`update(id, "new text")`) breaks because the second positional is `options`, and there is no `data=` alias | | delete | `memory.delete(memory_id)` | `memory.delete(memory_id)` | -| reset | `memory.reset()` (wipes the local store) | **No global reset.** Use `memory.delete_all(filters=...)` scoped to the relevant entity. Flag this. | +| history | `memory.history(memory_id)` | `memory.history(memory_id)`: same call, extra fields on each entry (`input`, `user_id`, `categories`, `metadata`); OSS-only `is_deleted`/`actor_id`/`role` are absent (see Return shapes) | +| reset | `memory.reset()` (wipes the local store) | `memory.reset()` exists but calls `delete_users()`, which deletes **all** users, agents, sessions and memories (first page of entities only, see gotchas). Prefer `delete_all` scoped to an entity. Flag this | Key rule: for **search** and **get_all**, the hosted client requires entity IDs (`user_id`, `agent_id`, `app_id`, `run_id`) inside a `filters` dict and will raise if you pass them top-level. For **add** and **delete_all**, top-level entity IDs are accepted. +Filter differences: Platform validates each top-level filter key against a fixed allowlist +(`AND`/`OR`/`NOT`, `user_id`, `agent_id`, `app_id`, `run_id`, `created_at`, `updated_at`, `timestamp`, +`expiration_date`, `categories`, `metadata`, `memory_ids`, `keywords`) and +returns 400 for anything else, so custom metadata keys must be nested under `"metadata"` +(`{"metadata": {"plan": "pro"}}`). Platform `metadata` supports only `eq`/`ne`/`contains` (`contains` is case-sensitive and matches the whole value or one list member, not a substring), and there is +no `nin` (use `{"NOT": [{"categories": {"in": [...]}}]}`; `NOT` must be a list). OSS accepts arbitrary +metadata keys and a wider operator set. Flag any OSS filter that depends on either. Do not filter on `text`: search fails with a 503 and `get_all` rejects it. Pass the text as the search `query`. + --- ## TypeScript / JavaScript @@ -66,36 +77,64 @@ Confirm option names against `node_modules/mem0ai/` types. ### Import & client construction ```typescript -// OSS (self-hosted) — note the "/oss" subpath +// OSS (self-hosted): note the "/oss" subpath import { Memory } from "mem0ai/oss"; -const memory = new Memory({ /* vectorStore, embedder, llm, historyStore … */ }); +const memory = new Memory({ /* vectorStore, embedder, llm, historyStore, reranker, customInstructions … */ }); -// Platform (hosted) — default export from the package root +// Platform (hosted): default export from the package root import MemoryClient from "mem0ai"; -const memory = new MemoryClient({ apiKey: process.env.MEM0_API_KEY }); -// Drop organizationId / projectId — resolved from the API key in v3. +const memory = new MemoryClient({ apiKey: process.env.MEM0_API_KEY! }); ``` +Notes: +- Unlike Python, the TS client does **not** read `MEM0_API_KEY` itself: `apiKey` is required and the + constructor throws if it is empty. Pass it explicitly. +- Drop `organizationId` / `projectId` if present, they're resolved from the API key. +- Drop `vectorStore`, `embedder`, `llm`, `historyStore`, `historyDbPath`, `reranker`, `disableHistory`, + `version`. `customInstructions` maps to `client.updateProject({ customInstructions })` or + `customInstructions` on `add()`. ### Method calls (option-object differences) -| Operation | OSS / old client | Hosted client (v3) | +| Operation | OSS `Memory` | Hosted client | |---|---|---| -| add | `memory.add(messages, { userId: "u" })` | `memory.add(messages, { userId: "u" })` — unchanged | -| search | `memory.search(q, { userId: "u", limit: 20 })` | `memory.search(q, { filters: { userId: "u" }, topK: 20 })` — entity IDs into `filters`; `limit` → `topK` | -| getAll | `memory.getAll({ userId: "u" })` | `memory.getAll({ filters: { userId: "u" } })` — entity IDs into `filters` | -| deleteAll | `memory.deleteAll({ userId: "u" })` | `memory.deleteAll({ userId: "u" })` | -| get / update / delete | `memory.get(id)` etc. | same, by memory id | +| add | `memory.add(messages, { userId: "u" })` (`messages` may be a string or `Message[]`) | `memory.add(messages, { userId: "u" })`: `messages` must be `Message[]` (wrap a bare string as `[{ role: "user", content: str }]`); the response is an async event (see Return shapes) | +| search | `memory.search(q, { filters: { user_id: "u" }, topK: 20 })` (pre-3.0 code used top-level `userId` and `limit`) | `memory.search(q, { filters: { user_id: "u" }, topK: 20 })`: entity IDs go inside `filters` with **snake_case** keys (`user_id`, not `userId`); top-level `userId` throws; `limit` → `topK` | +| getAll | `memory.getAll({ filters: { user_id: "u" }, topK: 20 })` (not paginated) | `memory.getAll({ filters: { user_id: "u" }, page: 1, pageSize: 50 })`: paginated with `page`/`pageSize` (not `topK`) | +| deleteAll | `memory.deleteAll({ userId: "u" })` | `memory.deleteAll({ userId: "u" })`: same call (at least one entity ID is required) | +| update | `memory.update(id, "new text")` or `memory.update(id, { text, metadata })` | `memory.update(id, { text: "new text" })`: the options object is required, a bare string throws | +| get / delete / history | `memory.get(id)` etc. | same, by memory id (`history` field names differ, see Return shapes) | +| reset | `memory.reset()` (wipes the local store) | No `reset()` on the TS client. `deleteUsers()` with no arguments deletes all users, agents, sessions and memories (first page of entities only, see gotchas). Prefer `deleteAll` scoped to an entity. Flag this | -Also drop legacy options that no longer apply on v3: `async_mode`, `output_format`, `enable_graph`. +Also drop legacy options that no longer apply: `async_mode`, `output_format`, `enable_graph`. --- ## Return shapes -- `search(...)` and `get_all(...)` return `{"results": [...]}`; each item has at least a `memory` - (text) field, plus `id` and (for search) `score`. Code that reads `result["results"]` and pulls - `item["memory"]` keeps working. -- `get_all(...)` on the hosted client is paginated: `{"count", "next", "previous", "results": [...]}`. -- `add(...)` returns the created memories. On v3 it returns **only ADD events** — if the old code - branched on `event == "UPDATE"` / `"DELETE"` from `add()` results, that branch is now dead. +- `search(...)` returns `{"results": [...]}` on both sides; each item has at least a `memory` (text) + field, plus `id` and `score`. Code that reads `result["results"]` and pulls `item["memory"]` keeps + working. +- `get_all(...)`: OSS returns `{"results": [...]}` (no pagination). The hosted client is paginated: + `{"count", "next", "previous", "results": [...]}`. +- `add(...)`: OSS extracts synchronously on both runtimes, but the event sits in a different place: + Python OSS returns `{"results": [{"id", "memory", "event": "ADD"}]}`, TS OSS returns + `{ results: [{ id, memory, metadata: { event: "ADD" } }] }` (no top-level `event`). + The hosted `add` is **asynchronous by default** and returns `{"status": "PENDING", "event_id": "..."}` + from Python. The TS hosted client camelCases response keys, so it returns + `{ status: "PENDING", eventId: "..." }` (its typed return `Array` does not reflect this). + New memories may not be searchable yet. Only `infer=False` is synchronous and returns `results`. + Neither SDK has an event-poll method: poll `GET /v1/event/{event_id}/` over REST if you must wait. + Code that reads `id`/`memory` from `add()` results must change, and any 1.x-era branch on + `event == "UPDATE"` / `"DELETE"` is dead on both sides (add is ADD-only since 2.0). +- `history(...)` field names differ on all four runtimes: + + | Runtime | Entry fields | + |---|---| + | Python OSS | `id`, `memory_id`, `old_memory`, `new_memory`, `event`, `created_at`, `updated_at`, `is_deleted`, `actor_id`, `role` (oldest first) | + | TS OSS | `id`, `memory_id`, `previous_value`, `new_value`, `action`, `created_at`, `updated_at`, `is_deleted` (raw rows, snake_case, newest first) | + | Hosted Python | `id`, `memory_id`, `input`, `old_memory`, `new_memory`, `event`, `user_id`, `categories`, `metadata`, `created_at`, `updated_at` | + | Hosted TS | `id`, `memoryId`, `input`, `oldMemory`, `newMemory`, `event`, `userId`, `categories`, `metadata`, `createdAt`, `updatedAt` | + + Code that reads `previous_value` / `new_value` / `action` from TS OSS history must switch to + `oldMemory` / `newMemory` / `event` on the hosted TS client. --- @@ -109,9 +148,18 @@ Also drop legacy options that no longer apply on v3: `async_mode`, `output_forma - Local-infra services (e.g. a Qdrant docker-compose service) that existed only for mem0 can be retired — flag this rather than deleting infrastructure unilaterally. -## v2→v3 default/behavior changes -From the official migration guide — surface any that affect the project: -- Python `top_k` default changed 100 → 20; TS `limit` renamed to `topK`. -- New `threshold` default `0.1` (was none); new `rerank` default `false` (was true). -- `custom_fact_extraction_prompt` → `custom_instructions`; `custom_update_memory_prompt` deprecated. -- Graph memory (`enable_graph`, `graph_store`) removed from the OSS v3 surface — see gotchas. +## OSS vs Platform defaults and behavior +Surface any that affect the project. Defaults differ between the two sides even when a call looks +identical: +- `search`: OSS `top_k=20`, `threshold=0.1`, `rerank=False`. Platform `top_k=10` (allowed 1 to 1000), + `rerank=false`, and `threshold` is a server-side cutoff, not a floor on the returned `score`. Pass `top_k` explicitly to keep the old result count. +- `get_all`: OSS `top_k=20`, not paginated. Platform `page=1`, `page_size=100`. +- `custom_fact_extraction_prompt` (TS `customPrompt`) was renamed `custom_instructions` + (`customInstructions`) in OSS 2.0/3.0; `custom_update_memory_prompt` is deprecated. See the + constructor notes for the hosted equivalent. +- Graph memory (`enable_graph`, `graph_store`) was removed from OSS (Python 2.0.0, TS 3.0.0). On the + Platform graph is built in and always on, with no flag. See gotchas. +- Platform-only: `app_id`, webhooks, custom categories, batch update/delete, feedback, memory export, + user profiles. `timestamp`, `reference_date` and `decay` raise on OSS. +- OSS-only (no Platform option): `reranker` and `history_db_path` config, `memory_type` and `prompt` + on `add`, `explain` on `search`. diff --git a/skills/mem0-oss-to-platform/references/gotchas.md b/skills/mem0-oss-to-platform/references/gotchas.md index d5e610f72..9f8f8890f 100644 --- a/skills/mem0-oss-to-platform/references/gotchas.md +++ b/skills/mem0-oss-to-platform/references/gotchas.md @@ -9,8 +9,19 @@ section, phrased as a decision for the developer — never silently resolved. Migrating the *code* does not move the *memories*. Anything stored in the local vector store / history DB stays there; the hosted account starts empty. This is the most surprising gap, so call it out prominently. Data migration is **out of scope** unless the developer explicitly asks. If they -do, the rough path is: read everything from the OSS store (`get_all` per user/entity) and re-`add` -it to the hosted client — but treat that as a separate, opt-in task. +do, treat it as a separate, opt-in task: +- **Hosted Qdrant + Python OSS SDK:** the repo ships `scripts/oss-to-platform-migrate.sh` + (`curl -fsSL https://raw.githubusercontent.com/mem0ai/mem0/main/scripts/oss-to-platform-migrate.sh | bash`, + documented at https://docs.mem0.ai/migration/oss-to-platform). It needs `python3`, signs in to the + Platform (`--email`/`--code` or `--api-key`), exports a scope (`--user-id`, `--agent-id`, `--run-id` + or `--all`) from the Qdrant collection (`--qdrant-url`, `--qdrant-api-key`, `--qdrant-collection`, + default `mem0`) to a JSON file under `~/.mem0/migrations/`, and imports it with `infer: False` (stored + verbatim, no re-extraction). `--export-only` / `--import-only` split the two steps so the export can + be reviewed first. Don't run it unprompted: it logs in and writes under `~/.mem0/`. +- **Anything else:** other vector stores are not supported by the script (the docs say hosted Qdrant + only), and its export is written for the Python OSS SDK, so TS-written data is not documented as + supported. The fallback is to read everything from the OSS store (`get_all` per entity) and re-`add` + it with `infer=False`. ## 2. Self-hosting / data residency A local or self-hosted vector store sometimes exists *on purpose* — compliance, data residency, air- @@ -24,15 +35,19 @@ the platform with the platform's configuration. Memory *content and quality may Flag where the project depended on a specific model. ## 4. Graph memory -If the project uses graph memory (`enable_graph`, `graph_store`), this changed in v3 and is handled -differently on the platform. Don't assume a drop-in mapping — verify current platform graph support -in the docs and flag the usage for the developer. +The external graph store (`graph_store`, `enable_graph`; Neo4j/Memgraph/Kuzu/AGE) was removed from OSS +(Python 2.0.0, TS 3.0.0). On the platform graph memory is built in and always on: nothing to enable or +configure, and it only influences ranking (no separate `relations` payload, no typed relationships, +no direct graph queries). Flag any project code that queried its own graph store or read `relations`. +See https://docs.mem0.ai/platform/features/graph-memory. ## 5. Custom prompts / extraction config -`custom_fact_extraction_prompt` → `custom_instructions`, and `custom_update_memory_prompt` is -deprecated. On the platform these tend to be **project-level settings configured in the dashboard** -rather than passed in code. Flag any custom prompt the project relied on so the developer can re- -apply it in the dashboard. +`custom_fact_extraction_prompt` (TS `customPrompt`) was renamed `custom_instructions` +(`customInstructions`), and `custom_update_memory_prompt` is deprecated (fold it into +`custom_instructions`). On the platform `custom_instructions` is a project-level setting: +`client.project.update(custom_instructions=...)` (TS `client.updateProject({ customInstructions })`), +or per call via `custom_instructions=` on `add()`. +Flag any custom prompt the project relied on so the developer can decide where to re-apply it. ## 6. Every call is now a network request Local calls become remote API calls. That introduces latency, network failures, timeouts, rate @@ -41,23 +56,44 @@ error handling / retries / timeouts where the old local calls were effectively i apps, use `AsyncMemoryClient` (Python) so calls don't block the event loop. ## 7. API key & secrets -The hosted client needs `MEM0_API_KEY`. It must come from the environment / a secrets manager — never +The hosted client needs `MEM0_API_KEY`. It must come from the environment / a secrets manager, never hardcoded. Ensure it's added to `.env.example`, local `.env`, CI, and deployment config. Without it -the client fails to initialize. +the client fails to initialize. The Python client reads `MEM0_API_KEY` itself when `api_key` is +omitted; the TS client does not, so pass `apiKey: process.env.MEM0_API_KEY!` explicitly. ## 8. Dropped constructor args & legacy options `org_id` / `project_id` (Python) and `organizationId` / `projectId` (TS) are no longer passed to the -constructor in v3 — they're resolved from the API key. Per-call legacy options like `async_mode`, +constructor, they're resolved from the API key. Per-call legacy options like `async_mode`, `output_format`, and `enable_graph` are gone. Remove them rather than leaving dead args. -## 9. Return-shape drift -- `add()` returns **only ADD events** on v3. Code that inspected `add()` results for `UPDATE` / - `DELETE` events has dead branches now. -- `search` / `get_all` return `{"results": [...]}`; `get_all` is paginated (`count`/`next`/ - `previous`/`results`). Code that limited via `top_k` on `get_all` should move to `page`/`page_size`. -- Default `top_k` dropped 100 → 20, `threshold` now `0.1`, `rerank` now `false` — result counts and - ordering can change even when the call looks equivalent. +## 9. Return-shape and default drift +- `add()` is **asynchronous** on the platform: it returns `{"status": "PENDING", "event_id": "..."}` + (`eventId` on the TS client, which camelCases response keys) instead of the created memories, so new memories may not be searchable yet when it returns + (`infer=False` is synchronous and returns `results`). Code that read `id`/`memory` from `add()` + results, or searched immediately after adding (tests, read-your-writes flows), needs a decision. + Neither SDK exposes an event-poll method; `GET /v1/event/{event_id}/` is REST only. +- `search` returns `{"results": [...]}` on both sides; `get_all` is paginated on the platform + (`count`/`next`/`previous`/`results`). Code that limited via `top_k` on `get_all` should move to + `page`/`page_size` (default `page_size` 100). +- Defaults differ: OSS `search` uses `top_k=20`, the platform uses `top_k=10`. Both default to + `rerank=false`. OSS `threshold` defaults to 0.1; on the platform it is a server-side cutoff, not a floor on the returned `score`. Result counts can change even when the call looks equivalent; + pass `top_k` explicitly. -## 10. No global `reset()` -The OSS `reset()` wipes the whole local store. There's no hosted equivalent that nukes everything; -use `delete_all` scoped by `filters`. Flag any `reset()` call. +## 10. `reset()` is much more destructive +The OSS `reset()` wipes the local store. Python `MemoryClient.reset()` exists but calls `delete_users()`, +which deletes all users, agents, sessions and memories on the platform. The TS client has no `reset()` +(`deleteUsers()` with no arguments does the same). Flag any `reset()` call (often test teardown) and +suggest `delete_all` scoped to the test entity instead. `delete_all(filters=...)` is not a valid +platform form: pass `user_id`/`agent_id`/`app_id`/`run_id` directly. + +The hosted wipe is also incomplete: Python `reset()` and TS `deleteUsers()` with no arguments call +`users()` once and delete only the entities on that first page, so a project with more entities than +one page keeps the rest. Re-run until it raises `No entities to delete`, or delete per entity +(`delete_users(user_id=...)` / `deleteUsers({ userId })`, paging TS with `users({ page, pageSize })`). + +## 11. Filters and update/add signatures +- Platform `filters` only accept an allowlist of top-level keys; custom metadata must be nested under + `"metadata"` and supports only `eq`/`ne`/`contains` (whole value or list member, not a substring; no `nin`; use a `NOT` list, e.g. `{"NOT": [{"categories": {"in": [...]}}]}`). OSS filters on arbitrary metadata + keys or richer operators need rewriting or a decision. +- Python `update` takes `text=` as a keyword (a positional string breaks); TS `update` requires an + options object and TS `add` requires `Message[]`, not a bare string. diff --git a/skills/mem0-oss-to-platform/references/plan-template.md b/skills/mem0-oss-to-platform/references/plan-template.md index bd9cbcd0c..b354e91d6 100644 --- a/skills/mem0-oss-to-platform/references/plan-template.md +++ b/skills/mem0-oss-to-platform/references/plan-template.md @@ -51,13 +51,15 @@ unambiguous. Example: ## Concerns & decisions needed The non-1:1 items from the gotchas that apply here, each phrased as a decision for the developer. Cover, where relevant: data not migrating, self-hosting/data-residency, local models moving server- -side, graph memory, custom prompts (now dashboard settings), network/latency/cost on hot paths, -return-shape changes (`add` ADD-only, `get_all` pagination, default `top_k`/threshold/rerank), and -any `reset()` usage. Be specific about which file/line each concern affects. +side, graph memory, custom prompts (now project-level `custom_instructions`), network/latency/cost on +hot paths, return-shape changes (`add` is async and returns an `event_id` (`eventId` on TS), `get_all` pagination, +default `top_k` 20 vs 10), metadata filters that need rewriting, and any `reset()` usage. Be specific +about which file/line each concern affects. ## Out of scope - Existing memory **data** is not migrated (code only). If wanted, it's a separate opt-in task - (export from the OSS store, re-add to the hosted client). + (for hosted Qdrant + Python OSS, `scripts/oss-to-platform-migrate.sh`; otherwise export from the + OSS store and re-add to the hosted client). - No unrelated refactors, renames, or behavior changes. ## Verification plan @@ -65,7 +67,8 @@ How execution will be confirmed end-to-end: - Imports / type-checks / byte-compiles cleanly. - Smoke test against the hosted API with a real `MEM0_API_KEY`: `add` a fact → `search`/`get_all` returns it → `delete_all` clears it. Plus: the app's own entry point still runs. -- Confirm no local mem0 storage dir is created anymore (e.g. `.mem0/`) — proof memory is hosted. +- Confirm no local OSS storage is created anymore (e.g. `~/.mem0/history.db`, a local Qdrant path). + The client still creates `~/.mem0/config.json`, so the bare `.mem0/` directory is not the check. ## Rollback - All changes are in version control; revert with git if needed. Note the branch/commit strategy. diff --git a/skills/mem0-test-integration/SKILL.md b/skills/mem0-test-integration/SKILL.md index 773d0dd26..d209efd44 100644 --- a/skills/mem0-test-integration/SKILL.md +++ b/skills/mem0-test-integration/SKILL.md @@ -18,7 +18,7 @@ description: > license: Apache-2.0 metadata: author: mem0ai - version: "0.1.0" + version: "0.1.1" category: ai-memory tags: "memory, integration, testing, tdd, platform, oss" coupling: loose @@ -130,7 +130,8 @@ if dependencies don't resolve. - **Eager-init check**: grep the `write_site` and `read_site` files (paths from `product.json`) for `MemoryClient(` or `Memory(` at module scope — i.e., not inside a function, method, or class body. `MemoryClient()` - validates the API key in `__init__` (network call) and OSS `Memory()` + validates the API key in `__init__` (Python pings the API, TS throws on a + blank key and pings in the background) and OSS `Memory()` can eagerly initialize embedding/LLM providers — module-level instantiation hits the wire on import and breaks Pass A's test collection whenever the key is unset. Hit → fail with `file:line` and @@ -140,7 +141,7 @@ if dependencies don't resolve. | Language | Test command (in priority order) | |---|---| -| Python | `pytest` with the test files from step 5 of the companion skill, else `python -m unittest discover`. | +| Python | `pytest` with the test files from step 7 of the companion skill, else `python -m unittest discover`. | | TypeScript / JavaScript | `npm test` if defined in package.json; else auto-detect `vitest` or `jest`. | **Pass A — `feature_flag` unset.** Run the *entire* pre-existing suite @@ -171,26 +172,43 @@ shape for the detected stack. **Platform (Python):** + import os + import time from mem0 import MemoryClient c = MemoryClient() # uses MEM0_API_KEY uid = f"mem0-test-integration-{os.urandom(4).hex()}" c.add([{"role": "user", "content": "I prefer aisle seats"}], user_id=uid) - hits = c.search("seat preference", user_id=uid) + for _ in range(10): + hits = c.search("seat preference", filters={"user_id": uid})["results"] + if hits: + break + time.sleep(2) assert any("aisle" in h.get("memory", "") for h in hits), hits c.delete_all(user_id=uid) # clean up -**Platform (TS):** same shape with `MemoryClient` from `"mem0ai"`. +`add` is asynchronous on Platform (it returns `status: "PENDING"` with an +`event_id`), so the search is retried for a bounded time. Entity IDs go in +`filters` and results come back under `["results"]`. + +**Platform (TS):** same shape with `new MemoryClient({ apiKey: +process.env.MEM0_API_KEY })` from `"mem0ai"` (the TS client does not read the +env var itself), `client.search("seat preference", { filters: { user_id: uid +} })` with hits under `.results`, and `client.deleteAll({ userId: uid })`. **OSS (Python / TS):** uses `Memory()` / `new Memory()` with default config -(OpenAI LLM via `OPENAI_API_KEY`, local Qdrant). If the repo ships a -`docker-compose.yml` with a Qdrant service, the skill starts it first and -tears it down after. If no backing store is reachable → fail with a +(OpenAI LLM via `OPENAI_API_KEY`; Python defaults to an embedded on-disk +Qdrant, TS to an in-memory vector store, so no service is needed unless the +repo's own config points at one). If the repo ships a `docker-compose.yml` +with the configured vector store service, the skill starts it first and tears +it down after. If the configured backing store is not reachable → fail with a clear message naming the fix. The smoke test always uses a **disposable random user_id** prefixed with `mem0-test-integration-` so a failed cleanup doesn't pollute the user's -real data. A background tidy step deletes any prefix-matching entries -older than 24 hours on the next run. +real data. A background tidy step lists Platform entities with `client.users()`, +picks the `type: "user"` entries whose `name` starts with that prefix and whose +`created_at` is older than 24 hours, and calls `delete_all(user_id=...)` for +each on the next run (there is no server-side prefix delete). Capture output to `.mem0-integration/smoke-stdout.log`. @@ -201,7 +219,7 @@ real signal: **does memory actually appear in the app's user-visible output when the integration runs end-to-end?** Requires `plan.md` to contain an `E2E recipe:` section (authored by -`/mem0-integrate` step 5). If absent → status `skipped` (not `fail`), +`/mem0-integrate` step 6). If absent → status `skipped` (not `fail`), note in scorecard that the repo has no runnable entry point. Recipe fields the skill reads: @@ -238,8 +256,8 @@ Execution order: 8. Run `read_call`. 9. Evaluate `read_assert` against `read_call`'s stdout. Miss → fail. 10. Cleanup (always, even on failure): SIGTERM the app, SIGKILL after - 5s, `docker compose down` if services were started, `delete_all` - memories matching `mem0-test-integration-*` on Platform scenarios. + 5s, `docker compose down` if services were started, `delete_all` for + the disposable `MEM0_USER_ID` on Platform scenarios. On any failure, the scorecard includes: diff --git a/skills/mem0-vercel-ai-sdk/README.md b/skills/mem0-vercel-ai-sdk/README.md index 886e352f7..8cd78e52f 100644 --- a/skills/mem0-vercel-ai-sdk/README.md +++ b/skills/mem0-vercel-ai-sdk/README.md @@ -37,7 +37,7 @@ curl -X POST https://api.anthropic.com/v1/skills \ ### Prerequisites - **Node.js 18+** -- **Vercel AI SDK v5** (`ai` package version 5.x) +- **Vercel AI SDK v6** (`ai` package version 6.x) - A Mem0 Platform API key ([Get one here](https://app.mem0.ai/dashboard/api-keys?utm_source=oss&utm_medium=skill-mem0-vercel-ai-sdk-readme)) - An LLM provider API key (OpenAI, Anthropic, Google, Groq, or Cohere) - Set environment variables: @@ -54,7 +54,7 @@ After installing, just ask Claude: - "Add memory to my Vercel AI SDK app" - "Set up mem0 with streamText in my Next.js API route" - "Use retrieveMemories with Anthropic instead of the wrapped model" -- "Show me how to use graph memories with the Vercel AI provider" +- "Show me how to read the Mem0 source from generateText with the Vercel AI provider" - "Help me store conversation history with addMemories" ## What's Inside @@ -67,7 +67,7 @@ skills/mem0-vercel-ai-sdk/ └── references/ # Documentation (loaded on demand) ├── provider-api.md # createMem0, Mem0Provider, types, config ├── memory-utilities.md # addMemories, retrieveMemories, getMemories, searchMemories - └── usage-patterns.md # Working examples: streaming, Next.js, multi-provider, graph + └── usage-patterns.md # Working examples: streaming, Next.js, multi-provider ``` ## Links diff --git a/skills/mem0-vercel-ai-sdk/SKILL.md b/skills/mem0-vercel-ai-sdk/SKILL.md index 8b5e9929e..1d489ebd8 100644 --- a/skills/mem0-vercel-ai-sdk/SKILL.md +++ b/skills/mem0-vercel-ai-sdk/SKILL.md @@ -12,10 +12,11 @@ description: > license: Apache-2.0 metadata: author: mem0ai - version: "1.1.0" + version: "2.0.0" category: ai-memory tags: "vercel, ai-sdk, memory, nextjs, typescript, provider" -compatibility: Node.js 18+, npm install @mem0/vercel-ai-provider, Vercel AI SDK v5 (ai package), MEM0_API_KEY + LLM provider API key + mem0_tested_versions: "@mem0/vercel-ai-provider (npm) >=3.0.0,<4.0.0; ai (npm) >=6.0.0,<7.0.0; mem0ai (npm) >=3.0.0,<4.0.0" +compatibility: Node.js 18+, npm install @mem0/vercel-ai-provider, Vercel AI SDK v6 (ai package ^6), MEM0_API_KEY + LLM provider API key --- # Mem0 Vercel AI SDK Provider @@ -25,9 +26,11 @@ Memory-enhanced AI provider for Vercel AI SDK. Automatically retrieves and store ## Step 1: Install ```bash -npm install @mem0/vercel-ai-provider ai +npm install @mem0/vercel-ai-provider ai@^6 ``` +`ai` and the `@ai-sdk/*` provider packages ship as regular dependencies of `@mem0/vercel-ai-provider`, so nothing else needs installing. The only peer dependency is `zod` (optional, `^3.0.0`). + ## Step 2: Set up environment variables ```bash @@ -53,10 +56,23 @@ const { text } = await generateText({ ``` What happens under the hood: -1. The prompt is sent to Mem0 search (`POST /v3/memories/search/`) to retrieve relevant memories -2. Retrieved memories are injected as a system message at the start of the prompt -3. The underlying LLM (e.g., OpenAI gpt-5-mini) generates a response using the enriched prompt -4. The conversation is stored back to Mem0 (`POST /v3/memories/add/`) as a fire-and-forget async call (no await) +1. The prompt is stored to Mem0 (`POST /v3/memories/add/`), awaited before the LLM call (a failed write is logged and ignored) +2. The prompt is sent to Mem0 search (`POST /v3/memories/search/`) to retrieve relevant memories +3. If any memories are found, they are injected as a system message at the start of the prompt +4. The underlying LLM (e.g., OpenAI gpt-5-mini) generates a response using the enriched prompt + +For `generateText`, the retrieved memories are also attached to the result as a source: + +```typescript +const { text, sources } = await generateText({ + model: mem0("gpt-5-mini", { user_id: "alice" }), + prompt: "Recommend a restaurant", +}); + +console.log(sources.find((s) => s.title === "Mem0 Memories")?.providerMetadata?.mem0); +``` + +The source has `title: "Mem0 Memories"` and `providerMetadata.mem0` holds `memories` (array of memory objects) and `memoriesText`. It is only present when at least one memory was retrieved. ## Pattern 2: Standalone Utilities @@ -111,7 +127,7 @@ for await (const chunk of result.textStream) { } ``` -The wrapped model handles memory retrieval before streaming begins and stores the conversation after. +The wrapped model stores the conversation and retrieves memories before streaming begins. ## Supported Providers @@ -119,7 +135,7 @@ The wrapped model handles memory retrieval before streaming begins and stores th |----------|-------------|------------------| | OpenAI (default) | `"openai"` | `OPENAI_API_KEY` | | Anthropic | `"anthropic"` | `ANTHROPIC_API_KEY` | -| Google | `"google"` | `GOOGLE_GENERATIVE_AI_API_KEY` | +| Google | `"google"` (alias `"gemini"`) | `GOOGLE_GENERATIVE_AI_API_KEY` | | Groq | `"groq"` | `GROQ_API_KEY` | | Cohere | `"cohere"` | `COHERE_API_KEY` | @@ -128,7 +144,7 @@ Select a provider when creating the Mem0 instance: ```typescript const mem0 = createMem0({ provider: "anthropic" }); const { text } = await generateText({ - model: mem0("gpt-5-mini", { user_id: "alice" }), + model: mem0("claude-sonnet-4-20250514", { user_id: "alice" }), prompt: "Hello!", }); ``` @@ -139,11 +155,11 @@ const { text } = await generateText({ ``` User prompt - --> searchInternalMemories (POST /v3/memories/search/) - --> memories injected as system message at start of prompt + --> processMemories: addMemories (POST /v3/memories/add/, awaited) + --> processMemories: getMemories (POST /v3/memories/search/) + --> memories (if any) injected as system message at start of prompt --> underlying LLM generates response (doGenerate or doStream) - --> processMemories fires addMemories as fire-and-forget (no await) - --> response returned to caller + --> response returned to caller (doGenerate also attaches a "Mem0 Memories" source) ``` ### Standalone flow @@ -162,18 +178,20 @@ User controls each step: |----------|---------|----------| | `retrieveMemories` | Formatted system prompt **string** | Injecting directly into `system` parameter | | `getMemories` | Raw memory **array** | Processing memories programmatically | -| `searchMemories` | Full search **response** (results + relations) | Need relations, scores, metadata | +| `searchMemories` | Raw search **response** (as returned by the API) | Need scores and full metadata | | `addMemories` | API response | Storing new messages to Mem0 | -All four accept `LanguageModelV2Prompt | string` as the first argument and optional `Mem0ConfigSettings` as the second. +`retrieveMemories`, `getMemories`, and `searchMemories` accept `LanguageModelV3Prompt | string` as the first argument; `addMemories` is typed as `LanguageModelV3Prompt` (a string also works at runtime). All four take optional `Mem0ConfigSettings` as the second argument. ## Common Edge Cases and Tips -- **Always provide `user_id`** (or `agent_id`/`app_id`/`run_id`) for consistent memory retrieval. Without an entity identifier, memories cannot be scoped. +- **Always provide `user_id`** (or `agent_id`/`app_id`/`run_id`) for consistent memory retrieval. The search endpoint requires at least one entity ID in `filters`; the provider places these IDs there for you. - **Standalone utilities require explicit API key**: pass `mem0ApiKey` in the config object, or set the `MEM0_API_KEY` environment variable. -- **This uses Vercel AI SDK v5** (LanguageModelV2 / ProviderV2 interfaces). It is not compatible with AI SDK v3 or v4. -- **`processMemories` fires `addMemories` as fire-and-forget** (`.then()` without `await`). Memory storage happens asynchronously and does not block the LLM response. -- **The `"gemini"` alias** exists in the provider switch but is NOT in the `supportedProviders` list. Use `"google"` instead. +- **This uses Vercel AI SDK v6** (LanguageModelV3 / ProviderV3 interfaces, `@mem0/vercel-ai-provider` 3.x). Provider 2.x targeted AI SDK v5. It is not compatible with AI SDK v4 or earlier. +- **`processMemories` awaits `addMemories`** before searching and calling the LLM, so each wrapped call includes one memory write and one memory search. If either request fails, the error is logged and the LLM call proceeds without memories. +- **`"google"` and `"gemini"`** are both accepted and map to `@ai-sdk/google`. +- **Removed in 3.0.0**: `org_id`, `project_id`, `org_name`, `project_name`, `output_format`, `filter_memories`, `async_mode`, `enable_graph`, `version`, `api_version`. Graph memory is now a Mem0 Platform project setting, not a provider option. +- **Default `top_k` is 10.** `threshold` and `rerank` are only sent when set (the API default for `rerank` is `false`; `threshold` is a server-side cutoff, not a floor on the returned score). - **Custom host**: set `host` in the config to point to a different Mem0 API endpoint (default: `https://api.mem0.ai`). ## References diff --git a/skills/mem0-vercel-ai-sdk/references/memory-utilities.md b/skills/mem0-vercel-ai-sdk/references/memory-utilities.md index 0ad297fc1..0beeef884 100644 --- a/skills/mem0-vercel-ai-sdk/references/memory-utilities.md +++ b/skills/mem0-vercel-ai-sdk/references/memory-utilities.md @@ -24,7 +24,7 @@ await addMemories( ```typescript async function addMemories( - messages: LanguageModelV2Prompt | string, + messages: LanguageModelV3Prompt, config?: Mem0ConfigSettings ): Promise; ``` @@ -33,15 +33,16 @@ async function addMemories( | Parameter | Type | Description | |-----------|------|-------------| -| `messages` | `LanguageModelV2Prompt \| string` | Messages to store. If a string, wrapped as `[{ role: "user", content: string }]` | +| `messages` | `LanguageModelV3Prompt` | Messages to store. A plain string is also handled at runtime (wrapped as `[{ role: "user", content: string }]`) but is not part of the declared type | | `config` | `Mem0ConfigSettings` | Optional. Must include entity scope (`user_id`, etc.) and API key | **Behavior:** 1. If `messages` is a string, wraps it as a single user message -2. Otherwise, converts `LanguageModelV2Prompt` to Mem0 format via `convertToMem0Format` (handles multimodal content) -3. Calls `POST /v1/memories/` with the converted messages and config +2. Otherwise, converts `LanguageModelV3Prompt` to Mem0 format via `convertToMem0Format` (maps multimodal parts, but the add endpoint rejects them with a 400) +3. Calls `POST {host}/v3/memories/add/` with body `{ messages, user_id?, app_id?, agent_id?, run_id?, metadata?, infer? }` (entity IDs are top-level on add) +4. Throws `HTTP error! status: ` on a non-2xx response -**Returns:** The API response from Mem0 (memory operation result). +**Returns:** The parsed JSON response from Mem0. The v3 add endpoint queues extraction and responds with `{ status: "PENDING", event_id }` (the provider returns the raw REST JSON, so keys stay snake_case, unlike the `mem0ai` client). With `infer: false` messages are stored verbatim synchronously and the response also includes `results`. --- @@ -63,7 +64,7 @@ const systemPrompt = await retrieveMemories("What restaurants do I like?", { ```typescript async function retrieveMemories( - prompt: LanguageModelV2Prompt | string, + prompt: LanguageModelV3Prompt | string, config?: Mem0ConfigSettings ): Promise; ``` @@ -72,13 +73,13 @@ async function retrieveMemories( | Parameter | Type | Description | |-----------|------|-------------| -| `prompt` | `LanguageModelV2Prompt \| string` | The query to search memories for | +| `prompt` | `LanguageModelV3Prompt \| string` | The query to search memories for | | `config` | `Mem0ConfigSettings` | Optional. Entity scope and API key | **Behavior:** -1. Flattens the prompt to a plain string (extracts text from `LanguageModelV2Prompt` parts) -2. Calls `searchInternalMemories` (`POST /v2/memories/search/`) -3. Formats each memory as `"Memory: {memory.memory}\n\n"` +1. Flattens the prompt to a plain string (extracts text from `LanguageModelV3Prompt` parts) +2. Calls `searchInternalMemories` (`POST /v3/memories/search/`) +3. Accepts either a flat array or a `{ results: [...] }` response and formats each memory as `"Memory: {memory.memory}\n\n"` 4. Wraps everything in a system prompt preamble **Returns:** A **string** containing the formatted system prompt with embedded memories. Returns `""` (empty string) if no memories found. @@ -112,7 +113,7 @@ const memories = await getMemories("What are my preferences?", { ```typescript async function getMemories( - prompt: LanguageModelV2Prompt | string, + prompt: LanguageModelV3Prompt | string, config?: Mem0ConfigSettings ): Promise; ``` @@ -121,21 +122,21 @@ async function getMemories( | Parameter | Type | Description | |-----------|------|-------------| -| `prompt` | `LanguageModelV2Prompt \| string` | The query to search memories for | +| `prompt` | `LanguageModelV3Prompt \| string` | The query to search memories for | | `config` | `Mem0ConfigSettings` | Optional. Entity scope and API key | **Behavior:** 1. Flattens the prompt to a plain string -2. Calls `searchInternalMemories` (`POST /v2/memories/search/`) -3. Returns `memories.results` (the array of memory objects) +2. Calls `searchInternalMemories` (`POST /v3/memories/search/`) +3. Normalizes the response: returns the response itself if it is an array, otherwise `response.results` (or `[]`) -**Returns:** Memory object array. +**Returns:** Flat memory object array. --- ## `searchMemories(prompt, config?)` -Retrieves the **full search API response** including results, relations, scores, and metadata. +Retrieves the **raw search API response** including results, scores, and metadata. ```typescript import { searchMemories } from "@mem0/vercel-ai-provider"; @@ -144,14 +145,14 @@ const response = await searchMemories("cooking preferences", { user_id: "alice", mem0ApiKey: "m0-xxx", }); -// Returns: { results: [{ memory: "...", score: 0.95, ... }], relations: [...] } +// Returns: { results: [{ memory: "...", score: 0.95, ... }] } ``` **Signature:** ```typescript async function searchMemories( - prompt: LanguageModelV2Prompt | string, + prompt: LanguageModelV3Prompt | string, config?: Mem0ConfigSettings ): Promise; ``` @@ -160,17 +161,17 @@ async function searchMemories( | Parameter | Type | Description | |-----------|------|-------------| -| `prompt` | `LanguageModelV2Prompt \| string` | The query to search memories for | +| `prompt` | `LanguageModelV3Prompt \| string` | The query to search memories for | | `config` | `Mem0ConfigSettings` | Optional. Entity scope and API key | **Behavior:** 1. Flattens the prompt to a plain string -2. Calls `searchInternalMemories` (`POST /v2/memories/search/`) -3. Returns the full response without any filtering +2. Calls `searchInternalMemories` (`POST /v3/memories/search/`) +3. Returns the response without any normalization -**Returns:** The complete API response object. On error, returns `[]`. +**Returns:** The API response as-is (an object with `results`, or a flat array if the API returns one). On error, logs and returns `[]` instead of throwing (unlike the other utilities, which rethrow). -**Note:** Unlike `getMemories`, this always returns the full response. +**Note:** Unlike `getMemories`, this does not unwrap `results`. --- @@ -180,7 +181,7 @@ async function searchMemories( |----------|---------|----------| | `retrieveMemories` | Formatted system prompt **string** | Injecting directly into a `system` parameter for `generateText`/`streamText` | | `getMemories` | Memory **array** | Processing memories programmatically (filtering, transforming, counting) | -| `searchMemories` | Full API **response** (results + relations) | Need relations, similarity scores, or complete metadata | +| `searchMemories` | Raw API **response** | Need similarity scores or complete metadata | | `addMemories` | API response | Storing new conversation messages as memories | ## Internal: `searchInternalMemories(query, config?, top_k?)` @@ -191,25 +192,27 @@ Not exported. Used by all retrieval functions. async function searchInternalMemories( query: string, config?: Mem0ConfigSettings, - top_k: number = 5 + top_k: number = 10 ): Promise; ``` **Behavior:** -1. Builds a `filters` object from entity identifiers (`user_id`, `app_id`, `agent_id`, `run_id`) -2. Resolves entity identifiers -3. Loads the API key from `config.mem0ApiKey` or `MEM0_API_KEY` env var -4. Calls `POST {host}/v2/memories/search/` with: +1. Builds a `filters` object from `config.filters`, then sets `user_id`, `app_id`, `agent_id`, `run_id` on it when present (entity IDs go inside `filters`, never top-level) +2. Loads the API key from `config.mem0ApiKey` or `MEM0_API_KEY` env var +3. Calls `POST {host}/v3/memories/search/` with: - `query`: the search string - `filters`: the filter object with entity identifiers - - `top_k`: from config or default 5 - - All other config fields spread into the request body + - `top_k`: `config.top_k` or default 10 (an explicit `0` is respected) + - `threshold`, `rerank`, `metadata`: only when set in config + - No other config fields (`infer`, `page`, `page_size`, `host`, `mem0ApiKey`) are sent +4. Sends `Authorization: Token ` plus `X-Mem0-Source: VERCEL_AI_SDK` and `X-Mem0-Client: mem0-vercel-ai-provider/` headers +5. Throws `HTTP error! status: ` on a non-2xx response **Default host:** `https://api.mem0.ai` ## Internal: `convertToMem0Format(messages)` -Not exported. Used by `addMemories` to convert `LanguageModelV2Prompt` messages to Mem0's format. +Not exported. Used by `addMemories` to convert `LanguageModelV3Prompt` messages to Mem0's format. **Multimodal content mapping:** @@ -223,6 +226,8 @@ Not exported. Used by `addMemories` to convert `LanguageModelV2Prompt` messages | MDX content | `{ type: "mdx_url", mdx_url: { url } }` or `{ type: "mdx", ... }` | MDX URL | `{ role, content: { type: "mdx_url", mdx_url: { url } } }` | | PDF content | `{ type: "pdf_url", pdf_url: { url } }` or `{ type: "pdf", ... }` | PDF URL | `{ role, content: { type: "pdf_url", pdf_url: { url } } }` | +`/v3/memories/add/` rejects structured (non-string) `content` with a 400 `Not a valid string.` (live-tested on the Python SDK with `infer` true and false), so a prompt containing these parts is expected to fail with `HTTP error! status: 400` (checked against the endpoint, not through the provider). Only text parts are storable. + The function handles three message content shapes: 1. **String content**: passed through directly 2. **Array content**: each element mapped individually, nulls filtered out @@ -230,7 +235,7 @@ The function handles three message content shapes: ## Internal: `flattenPrompt(prompt)` -Not exported. Extracts plain text from `LanguageModelV2Prompt` for use as a search query. +Not exported. Extracts plain text from `LanguageModelV3Prompt` for use as a search query. - Iterates over prompt parts, extracting text from `user` role messages - For `text` type content: extracts `.text` @@ -249,12 +254,12 @@ All fields are optional. Used across all utility functions. | `agent_id` | `string` | -- | Scope memories to an agent | | `run_id` | `string` | -- | Scope memories to a session/run | | `metadata` | `Record` | -- | Custom metadata | -| `filters` | `Record` | -- | Custom search filters | -| `infer` | `boolean` | -- | Enable inference | -| `page` | `number` | -- | Pagination page number | -| `page_size` | `number` | -- | Results per page | +| `filters` | `Record` | -- | Custom search filters (entity IDs above are merged in and win on conflicts) | +| `infer` | `boolean` | -- | Sent on add only. `false` stores messages verbatim without extraction | +| `page` | `number` | -- | Declared in the type, not sent by the provider | +| `page_size` | `number` | -- | Declared in the type, not sent by the provider | | `mem0ApiKey` | `string` | `MEM0_API_KEY` env | Mem0 API key | -| `top_k` | `number` | `5` | Number of memories to retrieve | -| `threshold` | `number` | -- | Minimum similarity score | -| `rerank` | `boolean` | -- | Enable re-ranking | +| `top_k` | `number` | `10` | Number of memories to retrieve | +| `threshold` | `number` | -- | Server-side relevance cutoff, not a floor on the returned score; sent only when set | +| `rerank` | `boolean` | -- (API default `false`) | Enable re-ranking, sent only when set | | `host` | `string` | `https://api.mem0.ai` | Custom API host | diff --git a/skills/mem0-vercel-ai-sdk/references/provider-api.md b/skills/mem0-vercel-ai-sdk/references/provider-api.md index 63222b815..229a8a1b9 100644 --- a/skills/mem0-vercel-ai-sdk/references/provider-api.md +++ b/skills/mem0-vercel-ai-sdk/references/provider-api.md @@ -25,26 +25,26 @@ When called with no arguments, defaults to `{ provider: "openai" }`. ## `Mem0Provider` Interface -Implements `ProviderV2` from `@ai-sdk/provider`. +Implements `ProviderV3` from `@ai-sdk/provider` (`specificationVersion: "v3"`, AI SDK v6). ```typescript -interface Mem0Provider extends ProviderV2 { +interface Mem0Provider extends ProviderV3 { // Call directly as a function - (modelId: Mem0ChatModelId, settings?: Mem0ChatSettings): LanguageModelV2; + (modelId: Mem0ChatModelId, settings?: Mem0ChatSettings): LanguageModelV3; // Or use named methods - chat(modelId: Mem0ChatModelId, settings?: Mem0ChatSettings): LanguageModelV2; - completion(modelId: Mem0ChatModelId, settings?: Mem0ChatSettings): LanguageModelV2; - languageModel(modelId: Mem0ChatModelId, settings?: Mem0ChatSettings): LanguageModelV2; + chat(modelId: Mem0ChatModelId, settings?: Mem0ChatSettings): LanguageModelV3; + completion(modelId: Mem0ChatModelId, settings?: Mem0ChatSettings): LanguageModelV3; + languageModel(modelId: Mem0ChatModelId, settings?: Mem0ChatSettings): LanguageModelV3; } ``` - **Direct call** (`mem0("gpt-5-mini", {...})`): creates a generic language model (neither chat nor completion mode forced). -- **`chat()`**: creates a model with `modelType: "chat"` (note: in the current source, the chat constructor sets `modelType: "completion"` -- this appears to be a bug; functionally equivalent to `completion()` at present). +- **`chat()`**: creates a model with `modelType: "chat"`. - **`completion()`**: creates a model with `modelType: "completion"`. - **`languageModel()`**: alias for the generic model (same as direct call). -All three return a `Mem0GenericLanguageModel` instance implementing `LanguageModelV2`. +All three return a `Mem0GenericLanguageModel` instance implementing `LanguageModelV3`. ## `Mem0ProviderSettings` Interface @@ -52,14 +52,14 @@ Configuration passed to `createMem0()`. ```typescript interface Mem0ProviderSettings { - baseURL?: string; // Base URL for the LLM provider (default: "http://api.openai.com") - headers?: Record; // Custom headers for LLM requests + baseURL?: string; // Stored on the model config (default: "https://api.openai.com"), not applied to upstream LLM requests + headers?: Record; // Stored on the model config, not applied to upstream LLM requests provider?: string; // LLM provider name (default: "openai") mem0ApiKey?: string; // Mem0 Platform API key (or use MEM0_API_KEY env var) apiKey?: string; // LLM provider API key (e.g., OpenAI key) mem0Config?: Mem0Config; // Default Mem0 config (user_id, etc.) applied to all calls config?: LLMProviderSettings; // Provider-specific settings (OpenAI, Anthropic, etc.) - fetch?: typeof fetch; // Custom fetch implementation (for testing/middleware) + fetch?: typeof fetch; // Stored on the model config, not used by the upstream LLM client or Mem0 API calls generateId?: () => string; // Custom ID generator (internal use) name?: string; // Provider instance name modelType?: "completion" | "chat"; // Force model type @@ -75,7 +75,7 @@ interface Mem0ProviderSettings { | `apiKey` | LLM provider API key | `"sk-xxx"` (OpenAI), `"sk-ant-xxx"` (Anthropic) | | `mem0Config` | Default Mem0 settings for all calls | `{ user_id: "alice" }` | | `config` | Provider-specific SDK settings | `{ organization: "org-xxx" }` for OpenAI | -| `baseURL` | Override LLM provider base URL | `"https://my-proxy.example.com"` | +| `config.baseURL` | Override LLM provider base URL (put it inside `config`; the top-level `baseURL` does not reach the upstream client) | `{ baseURL: "https://my-proxy.example.com/v1" }` | ## `mem0` Singleton @@ -94,7 +94,7 @@ Equivalent to `createMem0()` with no arguments. ## `Mem0ConfigSettings` Interface -Configuration for memory operations. Used as `Mem0ChatSettings` (per-call) or `Mem0Config` (provider-level default). All fields are optional. +Configuration for memory operations. Used as `Mem0ChatSettings` (per-call) or `Mem0Config` (provider-level default; same shape, not exported from the package entry point). All fields are optional. ```typescript interface Mem0ConfigSettings { @@ -104,13 +104,13 @@ interface Mem0ConfigSettings { run_id?: string; // Scope memories to a specific run/session metadata?: Record; // Custom metadata attached to memories filters?: Record; // Custom filters for memory search - infer?: boolean; // Enable inference during memory operations - page?: number; // Pagination: page number - page_size?: number; // Pagination: results per page + infer?: boolean; // Sent on add only: false stores messages verbatim without extraction + page?: number; // Declared in the type, not sent by the provider + page_size?: number; // Declared in the type, not sent by the provider mem0ApiKey?: string; // Mem0 API key (overrides provider-level key) - top_k?: number; // Number of memories to retrieve (default: 5) - threshold?: number; // Minimum similarity score for retrieval (default: 0.1) - rerank?: boolean; // Enable re-ranking of search results (default: false) + top_k?: number; // Number of memories to retrieve (default: 10) + threshold?: number; // Server-side relevance cutoff; sent only when set + rerank?: boolean; // Enable re-ranking of search results; sent only when set (API default: false) host?: string; // Custom Mem0 API host (default: "https://api.mem0.ai") } ``` @@ -137,17 +137,18 @@ mem0("gpt-5-mini", { user_id: "alice" }) ## `LLMProviderSettings` Type -Union of provider-specific settings. Extends all supported provider setting interfaces: +Union of provider-specific settings for all supported provider SDKs: ```typescript -interface LLMProviderSettings extends - OpenAIProviderSettings, - AnthropicProviderSettings, - CohereProviderSettings, - GroqProviderSettings {} +type LLMProviderSettings = + | OpenAIProviderSettings + | AnthropicProviderSettings + | CohereProviderSettings + | GroqProviderSettings + | GoogleGenerativeAIProviderSettings; ``` -Pass via the `config` field of `Mem0ProviderSettings` to forward settings to the underlying LLM provider SDK. +Pass via the `config` field of `Mem0ProviderSettings` to forward settings (e.g., `baseURL`, `headers`, `apiKey`) to the underlying LLM provider SDK. `config` is spread after `apiKey`, so a `config.apiKey` takes precedence. ## Provider Selection: `Mem0ClassSelector` @@ -155,12 +156,12 @@ Internal class that maps the `provider` string to the correct AI SDK provider. ```typescript class Mem0ClassSelector { - static supportedProviders = ["openai", "anthropic", "cohere", "groq", "google"]; + static supportedProviders = ["openai", "anthropic", "cohere", "groq", "google", "gemini"]; // ... } ``` -**Important:** The `"gemini"` alias exists in the provider switch statement (maps to `createGoogleGenerativeAI`) but is **NOT** in the `supportedProviders` list. The constructor validates against `supportedProviders`, so using `"gemini"` will throw `"Model not supported: gemini"`. Use `"google"` instead. +`"gemini"` is an alias of `"google"` (both map to `createGoogleGenerativeAI`). Any other value throws `"Model not supported: "`. ### Provider mapping @@ -170,7 +171,7 @@ class Mem0ClassSelector { | `"anthropic"` | `@ai-sdk/anthropic` | `createAnthropic` | | `"cohere"` | `@ai-sdk/cohere` | `createCohere` | | `"groq"` | `@ai-sdk/groq` | `createGroq` | -| `"google"` | `@ai-sdk/google` | `createGoogleGenerativeAI` | +| `"google"` or `"gemini"` | `@ai-sdk/google` | `createGoogleGenerativeAI` | ## `Mem0` Facade Class @@ -184,7 +185,7 @@ const chatModel = mem0.chat("gpt-5-mini", { user_id: "alice" }); const completionModel = mem0.completion("gpt-5-mini"); ``` -The facade defaults its base URL to `"http://127.0.0.1:11434/api"` (Ollama-style) rather than `"http://api.openai.com"`. It always uses `"openai"` as the provider for created models. +The facade defaults its base URL to `"https://api.openai.com"`. It always uses `"openai"` as the provider for created models, and only stores `baseURL` and `headers` from its options: the `provider`, `mem0ApiKey`, and `apiKey` options are ignored, so `MEM0_API_KEY` and `OPENAI_API_KEY` must come from the environment. Prefer `createMem0` for anything beyond a quick start. **Methods:** - `chat(modelId, settings?)` -- creates a model with `modelType: "chat"` @@ -192,13 +193,11 @@ The facade defaults its base URL to `"http://127.0.0.1:11434/api"` (Ollama-style ## `Mem0GenericLanguageModel` Class -The core class implementing `LanguageModelV2`. Created by `createMem0` or the `Mem0` facade. +The core class implementing `LanguageModelV3`. Created by `createMem0` or the `Mem0` facade. ```typescript -class Mem0GenericLanguageModel implements LanguageModelV2 { - readonly specificationVersion = "v2"; - readonly defaultObjectGenerationMode = "json"; - readonly supportsImageUrls = false; +class Mem0GenericLanguageModel implements LanguageModelV3 { + readonly specificationVersion = "v3"; readonly supportedUrls: Record = { '*': [/.*/] }; provider: string; // e.g., "openai" @@ -206,22 +205,26 @@ class Mem0GenericLanguageModel implements LanguageModelV2 { settings: Mem0ChatSettings; config: Mem0ChatConfig; - async doGenerate(options: LanguageModelV2CallOptions): Promise<...>; - async doStream(options: LanguageModelV2CallOptions): Promise<...>; + async doGenerate(options: LanguageModelV3CallOptions): Promise<...>; + async doStream(options: LanguageModelV3CallOptions): Promise<...>; } ``` +`defaultObjectGenerationMode` and `supportsImageUrls` (V2 properties) no longer exist. + Both `doGenerate` and `doStream` follow the same internal flow: -1. Build `Mem0ConfigSettings` from `config.mem0Config` merged with `settings` +1. Build `Mem0ConfigSettings` from `config.mem0ApiKey`, then `config.mem0Config`, then `settings` (later entries win) 2. Call `processMemories`: - - Fire `addMemories` as fire-and-forget (no await, `.then().catch()`) - - Await `getMemories` to retrieve relevant memories - - Format memories as a system message and prepend to the prompt + - Await `addMemories` (errors are logged and ignored) + - Await `getMemories` to retrieve relevant memories (on failure, continue with no memories) + - If any memories were found, format them as a system message and prepend it to a copy of the prompt 3. Create the underlying LLM model via `Mem0ClassSelector` 4. Delegate to the underlying model's `doGenerate` or `doStream` 5. Return the result +`doGenerate` additionally appends a `source` content part (`title: "Mem0 Memories"`) with `providerMetadata.mem0.memories` and `providerMetadata.mem0.memoriesText` when memories were retrieved. `doStream` returns the underlying stream result unchanged (no Mem0 source) and throws `"Streaming failed or method not implemented."` if streaming setup fails. + **Note:** Entity identifier fields use snake_case (`user_id`, `app_id`, `agent_id`, `run_id`) to match the Mem0 API. ## Type: `Mem0ChatModelId` @@ -230,4 +233,4 @@ Both `doGenerate` and `doStream` follow the same internal flow: type Mem0ChatModelId = string & NonNullable; ``` -Any non-null string. The model ID is passed through to the underlying provider (e.g., `"gpt-5-mini"`, `"gemini-pro"`). +Any non-null string. The model ID is passed through to the underlying provider (e.g., `"gpt-5-mini"`, `"gemini-2.5-flash"`). diff --git a/skills/mem0-vercel-ai-sdk/references/usage-patterns.md b/skills/mem0-vercel-ai-sdk/references/usage-patterns.md index bd1e66518..16cd32b3a 100644 --- a/skills/mem0-vercel-ai-sdk/references/usage-patterns.md +++ b/skills/mem0-vercel-ai-sdk/references/usage-patterns.md @@ -20,7 +20,7 @@ const { text } = await generateText({ console.log(text); ``` -Memories are automatically retrieved before the call and stored after. +The prompt is stored to Mem0 and relevant memories are retrieved before the LLM call (see section 8). ## 2. Wrapped Model with streamText (Streaming) @@ -42,7 +42,7 @@ for await (const chunk of result.textStream) { } ``` -Memory retrieval happens before streaming begins. The conversation is stored to Mem0 as a fire-and-forget call (non-blocking). +The add request and the memory search both finish before streaming begins (extraction itself is async). The Mem0 source (`sources`) is only attached by `generateText`, not by streaming. ## 3. Standalone Utilities with OpenAI @@ -136,7 +136,7 @@ console.log(object); // { breakfast: "Avocado toast (you mentioned loving it)", lunch: "...", ... } ``` -The `defaultObjectGenerationMode` is `"json"`, so structured output works out of the box. +The wrapped model forwards all call options (including the response format) to the underlying provider, so structured output works out of the box. `generateObject` is deprecated in AI SDK v6 in favor of `generateText` with `output: Output.object({ schema })`; both go through the same wrapped model. ## 6. Multi-Provider Setup @@ -195,22 +195,20 @@ A POST handler that uses the wrapped model in a Next.js App Router API route. ```typescript // app/api/chat/route.ts -import { streamText } from "ai"; +import { convertToModelMessages, streamText, UIMessage } from "ai"; import { createMem0 } from "@mem0/vercel-ai-provider"; const mem0 = createMem0(); export async function POST(req: Request) { - const { messages, user_id } = await req.json(); - - const lastMessage = messages[messages.length - 1]; + const { messages, user_id }: { messages: UIMessage[]; user_id: string } = await req.json(); const result = streamText({ model: mem0("gpt-5-mini", { user_id }), - prompt: lastMessage.content, + messages: await convertToModelMessages(messages), }); - return result.toDataStreamResponse(); + return result.toUIMessageStreamResponse(); } ``` @@ -219,22 +217,25 @@ export async function POST(req: Request) { ```typescript // app/api/chat/route.ts import { openai } from "@ai-sdk/openai"; -import { streamText } from "ai"; +import { convertToModelMessages, streamText, UIMessage } from "ai"; import { retrieveMemories, addMemories } from "@mem0/vercel-ai-provider"; export async function POST(req: Request) { - const { messages, user_id } = await req.json(); + const { messages, user_id }: { messages: UIMessage[]; user_id: string } = await req.json(); const lastMessage = messages[messages.length - 1]; + const lastText = lastMessage.parts + .flatMap((part) => (part.type === "text" ? [part.text] : [])) + .join(" "); // Retrieve relevant memories - const memories = await retrieveMemories(lastMessage.content, { + const memories = await retrieveMemories(lastText, { user_id, }); // Stream the response const result = streamText({ model: openai("gpt-5-mini"), - prompt: lastMessage.content, + messages: await convertToModelMessages(messages), system: memories, }); @@ -242,14 +243,14 @@ export async function POST(req: Request) { result.text.then(async (text) => { await addMemories( [ - { role: "user", content: [{ type: "text", text: lastMessage.content }] }, + { role: "user", content: [{ type: "text", text: lastText }] }, { role: "assistant", content: [{ type: "text", text }] }, ], { user_id } ); }); - return result.toDataStreamResponse(); + return result.toUIMessageStreamResponse(); } ``` @@ -260,25 +261,26 @@ export async function POST(req: Request) { ``` 1. doGenerate(options) or doStream(options) is called 2. processMemories(messagesPrompts, mem0Config): - a. addMemories(messagesPrompts, mem0Config) - --> fire-and-forget: .then().catch(), NO await + a. await addMemories(messagesPrompts, mem0Config) --> POST /v3/memories/add/ with converted messages + --> errors are caught and logged b. await getMemories(messagesPrompts, mem0Config) --> POST /v3/memories/search/ with flattened prompt --> returns memory array c. Format memories into system message string - d. Prepend system message to messagesPrompts array + d. If memories were found, prepend the system message to a copy of messagesPrompts e. Return { memories, messagesPrompts } 3. Create underlying LLM via Mem0ClassSelector.createProvider() 4. Call model.doGenerate(updatedOptions) or model.doStream(updatedOptions) -5. Return result +5. doGenerate appends the "Mem0 Memories" source when memories were found +6. Return result ``` -**Critical detail:** The `addMemories` call in step 2a is **NON-BLOCKING**. It uses `.then().catch()` without `await`, meaning: -- Memory storage happens asynchronously in the background -- The LLM response is not delayed by the memory write -- If the memory write fails, it logs an error but does not affect the response -- There is a brief window where the latest conversation is not yet stored +**Critical detail:** The `addMemories` call in step 2a is **awaited**, meaning: +- The add request is sent (and awaited) before the search and the LLM call, but extraction is async (`/v3/memories/add/` only queues the work and returns `PENDING`), so facts from the current prompt are usually not searchable until a later call +- Each wrapped call adds one Mem0 write and one Mem0 search of latency before the LLM starts +- If the memory write fails, it logs an error and the call continues +- `messagesPrompts` is the full prompt (all roles, including earlier turns), so every call sends the entire conversation to the add endpoint ### Memory injection format @@ -318,8 +320,8 @@ const memories = await retrieveMemories(prompt, { const mem0 = createMem0(); const model = mem0("gpt-5-mini", { user_id: "alice", - top_k: 10, // retrieve up to 10 memories (default: 5) - threshold: 0.8, // only memories with score >= 0.8 + top_k: 20, // retrieve up to 20 memories (default: 10) + threshold: 0.8, // server-side cutoff applied before score blending rerank: true, // enable re-ranking of results }); ``` diff --git a/skills/mem0/SKILL.md b/skills/mem0/SKILL.md index 508870f01..4827fcc4b 100644 --- a/skills/mem0/SKILL.md +++ b/skills/mem0/SKILL.md @@ -15,10 +15,11 @@ description: > license: Apache-2.0 metadata: author: mem0ai - version: "3.0.0" + version: "3.1.0" category: ai-memory tags: "memory, personalization, ai, python, typescript, vector-search" -compatibility: Requires Python 3.10+ or Node.js 18+, pip install mem0ai or npm install mem0ai, MEM0_API_KEY env var (Platform), and internet access to api.mem0.ai. SDK v3 with v2 compatibility mode available. + mem0_tested_versions: "mem0ai (PyPI) >=2.0.0,<3.0.0; mem0ai (npm) >=3.0.0,<4.0.0" +compatibility: Requires Python 3.10+ or Node.js 18+, pip install mem0ai or npm install mem0ai, MEM0_API_KEY env var (Platform), and internet access to api.mem0.ai. Targets the v3 API (Python mem0ai 2.x, TypeScript mem0ai 3.x). --- # Mem0 Platform Integration @@ -134,20 +135,20 @@ def chat(user_input: str, user_id: str) -> str: ## Common edge cases -- **Search returns empty:** Memories process asynchronously. Wait 2-3s after `add()` before searching. Also verify `user_id` matches exactly (case-sensitive) and use `filters={"user_id": "..."}` syntax. +- **Search returns empty:** `add()` is asynchronous and returns `{"event_id": "...", "status": "PENDING"}` (`eventId` on the TS client). Memories are searchable once the event is `SUCCEEDED` (poll `GET /v1/event/{event_id}/`, or wait a few seconds). `infer=False` is synchronous. Also verify `user_id` matches exactly (case-sensitive) and use `filters={"user_id": "..."}` syntax. - **AND filter with user_id + agent_id returns empty:** Entities are stored separately. Use `OR` instead, or query separately. - **Duplicate memories:** Don't mix `infer=True` (default) and `infer=False` for the same data. Stick to one mode. -- **Wrong import:** Always use `from mem0 import MemoryClient` (or `AsyncMemoryClient` for async). Do not use `from mem0 import Memory`. -- **v3 defaults:** `top_k=20`, `threshold=0.1`, `rerank=False`. Adjust as needed for your use case. +- **Wrong import:** For the hosted Platform use `from mem0 import MemoryClient` (or `AsyncMemoryClient` for async). `from mem0 import Memory` is the self-hosted OSS class and does not use `MEM0_API_KEY`. +- **v3 defaults (Platform):** `top_k=10`, `rerank=False`. `threshold` is a server-side cutoff applied before score blending, not a floor on the returned `score` (the default and `0.0` return the same or nearly the same results). The client sends none of these unless you pass them. The OSS `Memory.search()` default is `top_k=20`. Adjust as needed for your use case. ## v2 Compatibility -If you're using SDK v2.x, note these differences: -- **Entity IDs:** Pass `user_id` as top-level kwarg to `search()` instead of inside `filters` -- **Defaults:** `top_k=100`, no threshold, `rerank=True` -- **Graph memory:** Available via `enable_graph=True` +The "v2" line is Python SDK 1.x and TypeScript SDK 2.x. If you are still on it, note these differences from the current SDKs (Python 2.x, TypeScript 3.x): +- **Entity IDs:** `user_id` / `agent_id` / `run_id` could be top-level kwargs on `search()` and `get_all()`. They now go inside `filters` (top-level raises an error) +- **Defaults (Platform):** `threshold=0.3`, `rerank=False`. OSS: `top_k=100`, no threshold, `rerank=True` +- **Graph memory:** `enable_graph=True` and `relations` are gone. Entity linking is built in (see [client/python.md](client/python.md) for OSS) -See the [migration guide](https://docs.mem0.ai/migration/oss-v2-to-v3) for details. +See the [Platform migration guide](https://docs.mem0.ai/migration/platform-v2-to-v3) and the [OSS migration guide](https://docs.mem0.ai/migration/oss-v2-to-v3) for details. ## Live documentation search diff --git a/skills/mem0/client/differences.md b/skills/mem0/client/differences.md index e5e80e250..3257e643e 100644 --- a/skills/mem0/client/differences.md +++ b/skills/mem0/client/differences.md @@ -9,9 +9,9 @@ Quick-reference cheatsheet for developers working across both Mem0 SDKs. | Import (Platform) | `from mem0 import MemoryClient` | `import MemoryClient from 'mem0ai'` | | Import (OSS) | `from mem0 import Memory` | `import { Memory } from 'mem0ai/oss'` | | Constructor | `MemoryClient(api_key="m0-xxx")` | `new MemoryClient({ apiKey: 'm0-xxx' })` | -| Required param | `api_key` (positional or kwarg) | `apiKey` (in options object) | +| Required param | `api_key` (optional, falls back to `MEM0_API_KEY`) | `apiKey` (required, in options object) | -Both read from `MEM0_API_KEY` env var if no key provided. +Python reads `MEM0_API_KEY` if no key is passed. TypeScript does not read the environment: pass `apiKey: process.env.MEM0_API_KEY` yourself. ## Method Naming @@ -38,6 +38,11 @@ Both read from `MEM0_API_KEY` env var if no key provided. | Create export | `create_memory_export()` | `createMemoryExport()` | | Get export | `get_memory_export()` | `getMemoryExport()` | | Feedback | `feedback()` | `feedback()` | +| Get profile | `get_profile(entity_id)` | `getProfile({ entityId })` | +| Generate profile | `generate_profile(entity_id)` | `generateProfile({ entityId })` | +| Profile settings | `get_profile_settings()` / `update_profile_settings()` | `getProfileSettings()` / `updateProfileSettings()` | +| Sample profiles | `sample_profiles()` | `sampleProfiles()` | +| Profile job | `get_profile_job()` | `getProfileJob()` | **Rule:** Python uses `snake_case`, TypeScript uses `camelCase` for method names. @@ -61,8 +66,8 @@ await client.search('query', { filters: { user_id: 'alice' }, topK: 5, rerank: t | Aspect | Python | TypeScript | |--------|--------|------------| -| HTTP library | httpx | axios | -| Default timeout | 300s | 60s | +| HTTP library | httpx | native `fetch` | +| Default timeout | 300s | None set by the SDK | | Sync support | Yes (`MemoryClient`) | No (all async) | | Async support | Yes (`AsyncMemoryClient`) | All methods are async | | Project management | `client.project.*` (separate class) | `client.getProject()` / `client.updateProject()` | @@ -87,7 +92,7 @@ These methods exist in Python but not TypeScript: | Method | Description | |--------|-------------| -| `deleteUser(data)` | Convenience method for single entity deletion | +| `deleteUser(data)` | Deprecated single entity deletion (use `deleteUsers`) | | `ping()` | Health check endpoint | ## OSS Config Naming diff --git a/skills/mem0/client/node.md b/skills/mem0/client/node.md index ca85ba7ba..4b72d04f6 100644 --- a/skills/mem0/client/node.md +++ b/skills/mem0/client/node.md @@ -21,12 +21,15 @@ import MemoryClient from 'mem0ai'; const client = new MemoryClient({ apiKey: 'm0-xxx' }); ``` -**Constructor:** `new MemoryClient({ apiKey })`. If `apiKey` is not provided, reads from `MEM0_API_KEY` environment variable. +**Constructor:** `new MemoryClient({ apiKey, host?, identityCacheMax? })`. `apiKey` is required: the constructor throws `Mem0 API key is required` when it is missing or empty. There is no `MEM0_API_KEY` environment fallback, so pass `apiKey: process.env.MEM0_API_KEY` yourself. -- HTTP library: `axios` -- Timeout: 60 seconds -- Base URL: `https://api.mem0.ai` +- Also a named export: `import { MemoryClient, Feedback, WebhookEvent } from 'mem0ai'` +- HTTP library: native `fetch` (the axios instance in `mem0.ts` is unused) +- Timeout: none set by the SDK +- Base URL: `https://api.mem0.ai` (override with `host`) - All methods are async (return `Promise`) +- Top-level option names are camelCase and responses come back camelCased (`event_id` becomes `eventId`). Keys inside `filters` are sent as written, so keep them snake_case (`user_id`). +- `MEM0_SOURCE`, `MEM0_APPLICATION` and `MEM0_CLIENT_STACK` set the surface-identity headers for wrappers that cannot pass options. --- @@ -52,16 +55,22 @@ await client.add(messages, { userId: 'alice' }); | `options.appId` | string | Application identifier | | `options.runId` | string | Session identifier | | `options.metadata` | object | Custom key-value pairs | -| `options.infer` | boolean | If false, store raw text (default: true) | +| `options.infer` | boolean | If false, store messages as-is without extraction (default: true) | +| `options.customCategories` | `{[name]: description}[]` | Per-call category list | +| `options.customInstructions` | string | Per-call extraction instructions | +| `options.agentCustomInstructions` | string | Per-call extraction instructions for agent-scoped memories | +| `options.timestamp` | number | Unix timestamp (seconds) to record as the memory time | +| `options.expirationDate` | string | Date after which the memory is no longer returned | +| `options.structuredDataSchema` | object | Schema for structured extraction | -**Returns:** `Promise` -- list of events +**Returns:** typed `Promise>`, but the v3 API queues extraction and responds with `{ status: 'PENDING', eventId }`. With `infer: false` the call is synchronous and the response carries `message`, `status` and `results`. The client has no event-polling method (REST `GET /v1/event/{event_id}/`, see `../references/api-reference.md`). #### search(query, options?) Search memories by semantic similarity. ```typescript -const results = await client.search('dietary preferences', { filters: { user_id: 'alice' }, topK: 20 }); +const results = await client.search('dietary preferences', { filters: { user_id: 'alice' }, topK: 10 }); for (const mem of results.results) { console.log(mem.memory, mem.score); } @@ -71,11 +80,20 @@ for (const mem of results.results) { |-----------|------|-------------| | `query` | string | Natural language search query | | `options.filters` | object | Filter object with entity IDs (`user_id`, `agent_id`, etc.) and/or `AND`/`OR`/`NOT` conditions | -| `options.topK` | number | Number of results (default: 20) | +| `options.topK` | number | Number of results (default: 10) | | `options.rerank` | boolean | Enable semantic reranking (default: false) | -| `options.threshold` | number | Minimum similarity (default: 0.1) | +| `options.threshold` | number | Server-side relevance cutoff (0 to 1), applied before score blending, so it is not a floor on the returned `score`. Omitting it and passing `0` returned the same results in live tests. Filter on `score` client-side for a precise cutoff | +| `options.latestOnly` | boolean | Return only current (non-superseded) memories | +| `options.fields` | string[] | Not applied in v3 | +| `options.categories` | string[] | Not applied in v3. Use `filters: { AND: [{ categories: { in: [...] } }] }` | +| `options.metadata` | object | Not applied in v3. Use `filters: { AND: [{ metadata: {...} }] }` | +| `options.showExpired` | boolean | Include memories past their expiration date | +| `options.referenceDate` | string \| number | Treat this as "now" for relative time queries | +| `options.keywordSearch` | boolean | Not applied in v3 (removed from the v3 search schema; keyword matching is part of v3 hybrid scoring) | -**Returns:** `Promise` -- `{results: [{id, memory, score, ...}]}` +Entity IDs go inside `filters`. A top-level `userId`, `agentId`, `appId` or `runId` throws. + +**Returns:** `Promise<{ results: Array }>` -- `{results: [{id, memory, score, ...}]}` #### get(memoryId) @@ -85,7 +103,7 @@ const memory = await client.get('ea925981-...'); #### getAll(options?) -Retrieve all memories. Requires at least one entity identifier in filters. +Retrieve all memories. Requires non-empty `filters`; scope them with at least one entity identifier. ```typescript const memories = await client.getAll({ filters: { user_id: 'alice' } }); @@ -99,7 +117,12 @@ const filtered = await client.getAll({ |-----------|------|-------------| | `options.filters` | object | Filter object with entity IDs (`user_id`, `agent_id`, etc.) and/or `AND`/`OR`/`NOT` conditions | | `options.page` | number | Page number | -| `options.pageSize` | number | Results per page | +| `options.pageSize` | number | Results per page (default: 100, max: 200) | +| `options.startDate` / `options.endDate` / `options.categories` | - | Not applied in v3. Use `filters` with `created_at` or `categories` | +| `options.latestOnly` | boolean | Return only current (non-superseded) memories | +| `options.showExpired` | boolean | Include memories past their expiration date | + +**Returns:** `Promise<{ count, next, previous, results: Array }>` #### update(memoryId, data) @@ -113,25 +136,33 @@ await client.update('ea925981-...', { text: 'Updated', metadata: { verified: tru | `memoryId` | string | Memory ID | | `data.text` | string | New content | | `data.metadata` | object | New metadata | -| `data.timestamp` | string | New timestamp | +| `data.timestamp` | number \| string | New timestamp | +| `data.expirationDate` | string \| null | New expiration date, `null` to clear | -#### delete(memoryId) +At least one of `text`, `metadata`, `timestamp` or `expirationDate` is required, otherwise the call throws. + +#### delete(memoryId, options?) ```typescript await client.delete('ea925981-...'); +await client.delete('ea925981-...', { deleteLinked: true }); ``` +`deleteLinked: true` also deletes the older memories this one superseded (default: false). + #### deleteAll(options?) ```typescript await client.deleteAll({ userId: 'alice' }); ``` +Takes top-level `userId`, `agentId`, `appId`, `runId` (not `filters`). + #### history(memoryId) ```typescript const history = await client.history('ea925981-...'); -// Returns: [{previousValue, newValue, action, timestamps}] +// Returns: [{id, memoryId, input, oldMemory, newMemory, event, userId, categories, metadata, createdAt, updatedAt}] ``` --- @@ -147,6 +178,8 @@ await client.batchUpdate([ ]); ``` +Each item must include `text`. `metadata` on a batch item is ignored and a metadata-only item returns a 400. Use `update(memoryId, { metadata })` to change metadata. + #### batchDelete(memories) ```typescript @@ -160,17 +193,19 @@ await client.batchDelete(['uuid-1', 'uuid-2', 'uuid-3']); #### users() ```typescript -const users = await client.users(); -// Returns: {results: [{type: "user", name: "alice"}, ...]} +const users = await client.users({ page: 1, pageSize: 50 }); +// Returns: {count, next, previous, totalUsers, totalAgents, totalApps, totalRuns, results: [{id, name, type, createdAt, updatedAt, owner, metadata, isPlayground}, ...]} ``` -#### deleteUser(data) / deleteUsers(data) +#### deleteUsers(params) ```typescript -await client.deleteUser({ userId: 'alice' }); // Single entity -await client.deleteUsers({ agentId: 'bot-1' }); // Flexible +await client.deleteUsers({ userId: 'alice' }); +await client.deleteUsers({ agentId: 'bot-1' }); ``` +Takes one of `userId`, `agentId`, `appId`, `runId`. Calling it with no arguments deletes ALL users, agents, apps and runs, but only those on the first page returned by `users()`: with many entities, re-run it until it throws `No entities to delete`, or page with `users({ page, pageSize })` and delete per entity. `deleteUser({ entity_id, entity_type })` still exists but is deprecated. + --- ### Project Management @@ -182,24 +217,29 @@ const config = await client.getProject({ fields: ['customCategories'] }); // Update project settings await client.updateProject({ customInstructions: 'Extract dietary preferences and health info', + agentCustomInstructions: 'Extract operational lessons for the agent', customCategories: [{ health: 'Medical and dietary info' }], + decay: true, }); ``` +`getProject` requires its options argument (pass `{}` for no field filter). Other `updateProject` keys: `memoryDepth`, `usecaseSetting`, `multilingual`, `version`. Both methods wait for the org and project identity the client resolves at startup and throw if it cannot be resolved. + --- ### Webhooks ```typescript -// List +import { WebhookEvent } from 'mem0ai'; + +// List (projectId is optional, defaults to the project of your API key) const webhooks = await client.getWebhooks({ projectId: 'proj_123' }); -// Create +// Create (always uses the project resolved from your API key) const webhook = await client.createWebhook({ url: 'https://your-app.com/webhook', name: 'Memory Logger', - projectId: 'proj_123', - eventTypes: ['memory_add', 'memory_update'], + eventTypes: [WebhookEvent.MEMORY_ADDED, WebhookEvent.MEMORY_UPDATED], }); // Update @@ -218,26 +258,50 @@ await client.deleteWebhook({ webhookId: 'wh_123' }); ### Feedback ```typescript +import { Feedback } from 'mem0ai'; + await client.feedback({ memoryId: 'mem-123', - feedback: 'POSITIVE', + feedback: Feedback.POSITIVE, feedbackReason: 'Accurately captured preference', }); ``` +`Feedback` values: `POSITIVE`, `NEGATIVE`, `VERY_NEGATIVE`. `feedback` and `feedbackReason` are optional, and `null` clears existing feedback. + --- ### Export ```typescript const exportReq = await client.createMemoryExport({ - schema: JSON.stringify({ type: 'object', properties: { name: { type: 'string' } } }), - filters: { user_id: 'alice' }, + schema: { type: 'object', properties: { name: { type: 'string' } } }, + filters: { AND: [{ user_id: 'alice' }] }, + exportInstructions: 'Build a profile from all memories', }); const result = await client.getMemoryExport({ memoryExportId: exportReq.id }); ``` +`schema` is an object (not a JSON string) and `schema` and `filters` are both required. `getMemoryExport` needs `memoryExportId` or `filters`. + +--- + +### User Profiles (beta) + +```typescript +await client.updateProfileSettings({ + enabled: true, + schema: { type: 'object', properties: { communication_style: { type: 'string', description: 'How the user prefers to be addressed' } } }, +}); + +const job = await client.generateProfile({ entityId: 'alice' }); +const result = await client.getProfile({ entityId: 'alice' }); +if (result.status === 'succeeded') console.log(result.profile); +``` + +Other methods: `getProfileSettings()`, `sampleProfiles({ limit?, idempotencyKey? })`, `getProfileJob(jobIdOrStatusUrl)`. Generation is asynchronous, so branch on `status` (`succeeded`, `pending`, `failed`, `not_enabled`, `insufficient_data`) rather than on an empty `profile`. Every schema property needs a `description`. + --- ### TypeScript Types @@ -245,15 +309,20 @@ const result = await client.getMemoryExport({ memoryExportId: exportReq.id }); Key interfaces from `mem0.types.ts`: ```typescript -interface Message { role: string; content: string; } -interface Memory { id: string; memory: string; userId: string; categories: string[]; score?: number; /* ... */ } -interface MemoryOptions { userId?: string; agentId?: string; appId?: string; runId?: string; metadata?: object; /* ... */ } -interface SearchOptions { filters?: object; topK?: number; rerank?: boolean; threshold?: number; /* ... */ } -interface MemoryHistory { id: string; memoryId: string; previousValue: string; newValue: string; action: string; /* ... */ } -interface FeedbackPayload { memoryId: string; feedback: string; feedbackReason?: string; } -interface WebhookCreatePayload { url: string; name: string; projectId: string; eventTypes: string[]; } +interface Message { role: 'user' | 'assistant'; content: string | { type: 'image_url'; image_url: { url: string } }; } +interface Memory { id: string; memory?: string; userId?: string; categories?: string[]; score?: number; expirationDate?: string | null; /* ... */ } +interface AddMemoryOptions { userId?: string; agentId?: string; appId?: string; runId?: string; metadata?: object; infer?: boolean; /* ... */ } +interface SearchMemoryOptions { filters?: object; topK?: number; rerank?: boolean; threshold?: number; /* ... */ } +interface GetAllMemoryOptions { filters?: object; page?: number; pageSize?: number; /* ... */ } +interface MemoryHistory { id: string; memoryId: string; oldMemory: string | null; newMemory: string | null; event: string; /* ... */ } +interface FeedbackPayload { memoryId: string; feedback?: Feedback | null; feedbackReason?: string | null; } +interface WebhookCreatePayload { name: string; url: string; eventTypes: WebhookEvent[]; } ``` +`Message.content` is typed to allow an `image_url` object, but `/v3/memories/add/` rejects structured content with a 400 (`Not a valid string.`), so pass a plain string (see Multimodal Support in [features.md](../references/features.md)). + +Also exported: `DeleteAllMemoryOptions`, `MemoryUpdateBody`, `PromptUpdatePayload`, `Webhook`, `WebhookUpdatePayload`, `User`, `AllUsers`, the profile types, and the error classes `MemoryError`, `AuthenticationError`, `RateLimitError`, `ValidationError`, `MemoryNotFoundError`, `NetworkError`, `ConfigurationError`, `MemoryQuotaExceededError`. + --- ## Open Source / Self-Hosted @@ -279,21 +348,21 @@ const m = new Memory(); // Uses default config ```typescript const config = { llm: { - provider: 'openai', // openai, groq, anthropic, google, ollama, lmstudio, mistral, azure + provider: 'openai', // openai, openai_structured, anthropic, groq, ollama, lmstudio, google (gemini), azure_openai, mistral, langchain, deepseek, xai, sarvam, aws_bedrock, litellm, minimax, together, vllm config: { model: 'gpt-5-mini', apiKey: 'sk-xxx', }, }, embedder: { - provider: 'openai', // openai, ollama, lmstudio, google, azure, langchain, anthropic + provider: 'openai', // openai, aws_bedrock, ollama, lmstudio, together, google (gemini), azure_openai, fastembed, langchain, vertexai, huggingface config: { model: 'text-embedding-3-small', apiKey: 'sk-xxx', }, }, vectorStore: { - provider: 'qdrant', // memory, qdrant, redis, supabase, langchain, azure_ai_search, pgvector + provider: 'qdrant', // memory (default), qdrant, chroma, redis, valkey, supabase, langchain, vectorize, azure-ai-search, vertex_ai_vector_search, pgvector, databricks, neptune-analytics, elasticsearch, opensearch, upstash_vector, azure_mysql, cassandra, pinecone, s3-vectors, turbopuffer, milvus, mongodb, weaviate, oracledb, baidu config: { collectionName: 'my_memories', host: 'localhost', @@ -310,6 +379,8 @@ const m = new Memory(config); const m2 = Memory.fromConfig(config); ``` +Defaults when omitted: LLM `openai` `gpt-5-mini`, embedder `openai` `text-embedding-3-small`, vector store `memory` (in-process), history `sqlite` at `memory.db`. `reranker` is also accepted (providers `cohere`, `zero_entropy`, `sentence_transformer`, `huggingface`, `llm_reranker`) and applies when `search` is called with `rerank: true`. There is no graph store in the TS OSS SDK. + ### Methods All methods are async (return `Promise`): @@ -327,14 +398,17 @@ await m.add([ | Parameter | Type | Description | |-----------|------|-------------| | `messages` | `string \| Message[]` | Content to store | -| `config.userId` | string | User identifier (at least one scope required) | +| `config.userId` | string | User identifier (at least one of `userId`, `agentId`, `runId` is required) | | `config.agentId` | string | Agent identifier | | `config.runId` | string | Session identifier | | `config.metadata` | object | Custom key-value pairs | | `config.filters` | object | Additional filters | | `config.infer` | boolean | LLM inference (default: true) | +| `config.expirationDate` | string | `YYYY-MM-DD`, expired memories are hidden from `search` and `getAll` | -**Returns:** `Promise<{results: [...], relations?: [...]}>` +`config` is a required argument. `config.timestamp` is not supported in OSS (it throws). + +**Returns:** `Promise<{results: [...]}>`, each item `{ id, memory, metadata: { event: 'ADD' } }` (the event is under `metadata`, not top-level). #### search(query, config) @@ -347,13 +421,23 @@ const results = await m.search('dietary preferences', { filters: { user_id: 'ali | `query` | string | Search query | | `config.filters` | object | Filter object with entity IDs (`user_id`, `agent_id`, `run_id`, etc.) | | `config.topK` | number | Max results (default: 20) | +| `config.threshold` | number | Minimum similarity (default: 0.1) | +| `config.rerank` | boolean | Rerank with the configured `reranker` (no-op without one) | +| `config.showExpired` | boolean | Include expired memories (default: false) | + +Top-level entity IDs throw. `config.referenceDate` is not supported in OSS (it throws). #### get(memoryId) / getAll(config) / update(memoryId, data) / delete(memoryId) / deleteAll(config) / history(memoryId) -Same interface patterns. Note: OSS `update` takes a string for data, not an object. +Same interface patterns, with these differences: +- `getAll({ filters, topK?, showExpired? })` needs an entity ID in `filters` and has no `page`/`pageSize` (`topK` defaults to 20). +- `deleteAll({ userId?, agentId?, runId? })` takes top-level IDs and requires at least one. Use `reset()` to wipe everything. +- `update` takes a string or `{ text?, metadata?, expirationDate? }` and returns `{ message }`. +- `history` returns raw rows `{ id, memory_id, previous_value, new_value, action, created_at, updated_at, is_deleted }` (snake_case, newest first), not the hosted client's `oldMemory` / `newMemory` / `event`. ```typescript await m.update('mem-id', 'new content'); +await m.update('mem-id', { text: 'new content', metadata: { verified: true } }); ``` #### reset() @@ -371,7 +455,7 @@ await m.reset(); | Aspect | Platform (`MemoryClient`) | OSS (`Memory`) | |--------|--------------------------|----------------| | **Import** | `import MemoryClient from 'mem0ai'` | `import { Memory } from 'mem0ai/oss'` | -| **Auth** | API key required (`MEM0_API_KEY`) | No API key -- config-based | +| **Auth** | API key required (`apiKey` option) | No Mem0 API key -- config-based | | **Execution** | API calls to `api.mem0.ai` | Local execution | | **Infrastructure** | Fully managed | Self-managed vector DB, embedder, LLM | | **Param style** | Top-level: `camelCase` (`userId`, `topK`), filter keys: `snake_case` (`user_id`) | Top-level: `camelCase` (`userId`, `topK`), filter keys: `snake_case` (`user_id`) | @@ -380,14 +464,15 @@ await m.reset(); | **Export** | `createMemoryExport` | Not available | | **Feedback** | `feedback()` | Not available | | **Project mgmt** | `getProject`, `updateProject` | Not available | -| **User listing** | `users()`, `deleteUser()` | Not available | +| **User listing** | `users()`, `deleteUsers()` | Not available | +| **Profiles** | `getProfile`, `generateProfile`, profile settings | Not available | | **History** | Platform-managed | SQLite (configurable) | --- ## v2 Compatibility -If you're using SDK v2.x: +If you're migrating from TS SDK 2.x (the pre-V3 line): **Naming Changes:** - Top-level params now use camelCase: `topK`, `rerank` (not `top_k`) @@ -406,13 +491,17 @@ await client.search("query", { filters: { user_id: "alice" }, topK: 20 }); **Default Changes:** | Param | v2 | v3 | |-------|----|----| -| `topK` | 100 | 20 | -| `threshold` | none | 0.1 | -| `rerank` | true | false | +| `topK` (OSS) | 100 | 20 | +| `threshold` | 0.3 (Platform), none (OSS) | server-side cutoff (Platform), 0.1 (OSS) | +| `rerank` | false (Platform), true (OSS) | false | + +Platform `topK` defaults to 10 (max 1000). **Removed:** - `OutputFormat` and `API_VERSION` enums -- `organizationId`, `projectId` from constructor -- `enableGraph`, `asyncMode`, `outputFormat`, `immutable`, `expirationDate`, `filterMemories`, `batchSize`, `forceAddOnly`, `includes`, `excludes`, `keywordSearch` +- `organizationId`, `projectId`, `organizationName`, `projectName` from the constructor +- `add()`: `enableGraph`, `asyncMode`, `outputFormat`, `immutable`, `filterMemories`, `batchSize`, `forceAddOnly`, `includes`, `excludes`, `keywordSearch` +- `search()` and `getAll()`: `enableGraph` +- OSS config: `customPrompt` (now `customInstructions`), `enableGraph` and `graphStore` See the [v2 to v3 migration guide](https://docs.mem0.ai/migration/oss-v2-to-v3) for details. diff --git a/skills/mem0/client/python.md b/skills/mem0/client/python.md index 0cf35a550..53db5ce27 100644 --- a/skills/mem0/client/python.md +++ b/skills/mem0/client/python.md @@ -21,7 +21,7 @@ from mem0 import MemoryClient client = MemoryClient(api_key="m0-xxx") ``` -**Constructor:** `MemoryClient(api_key=None)`. If `api_key` is not provided, reads from `MEM0_API_KEY` environment variable. Raises `ValueError` if no key found. +**Constructor:** `MemoryClient(api_key=None, host=None, client=None)`. If `api_key` is not provided, reads from `MEM0_API_KEY` environment variable. Raises `ValueError` if no key found. `host` overrides the base URL and `client` accepts a custom `httpx.Client`. `MEM0_SOURCE`, `MEM0_APPLICATION` and `MEM0_CLIENT_STACK` set the request identity headers for wrappers. - HTTP library: `httpx` - Timeout: 300 seconds @@ -45,7 +45,7 @@ Same methods as `MemoryClient`, all `async`/`await`. Supports async context mana ### Memory Methods -#### add(messages, **kwargs) +#### add(messages, options=None, **kwargs) Store new memories from messages. @@ -68,11 +68,13 @@ client.add(messages, user_id="alice") | `infer` | bool | True | If False, store raw text without LLM inference | | `custom_categories` | list | None | Override project categories | | `custom_instructions` | str | None | Override extraction instructions | -| `timestamp` | int \| float \| str | None | Custom timestamp (Unix epoch or ISO 8601) | +| `agent_custom_instructions` | str | None | Extraction instructions for agent-scoped memories | +| `expiration_date` | str | None | `YYYY-MM-DD`, memory is hidden after this date | +| `timestamp` | int | None | Custom timestamp (Unix epoch seconds) | -**Returns:** `dict` -- list of events: `[{"id": "...", "event": "ADD", "data": {"memory": "..."}}]` +**Returns:** `dict` -- asynchronous by default: `{"event_id": "...", "status": "PENDING"}`. Poll `GET /v1/event/{event_id}/` until `SUCCEEDED`. With `infer=False` it is synchronous and returns the stored `results`. -#### search(query, **kwargs) +#### search(query, options=None, **kwargs) Search memories by semantic similarity. @@ -88,9 +90,13 @@ for mem in results.get("results", []): | `filters` | dict | None | Filter object with entity IDs and/or `AND`/`OR`/`NOT` conditions (e.g., `{"user_id": "alice"}`) | | `top_k` | int | 10 | Number of results | | `rerank` | bool | False | Enable deep semantic reranking (+150-200ms) | -| `threshold` | float | 0.1 | Minimum similarity score | -| `fields` | list | None | Specific fields to return | -| `categories` | list | None | Filter by category | +| `threshold` | float | server-side | Relevance cutoff (0.0 to 1.0), applied before score blending, so it is not a floor on the returned `score`. The default and `0.0` returned the same or nearly the same results in live tests | +| `fields` | - | - | Not applied in v3 | +| `categories` | - | - | Not applied in v3. Use `filters={"AND": [{"categories": {"in": [...]}}]}` | +| `metadata` | - | - | Not applied in v3. Use `filters={"AND": [{"metadata": {...}}]}` | +| `reference_date` | str \| int | None | Anchor for relative time queries (`YYYY-MM-DD`, ISO datetime, or Unix epoch) | +| `show_expired` | bool | False | Include memories past their `expiration_date` | +| `latest_only` | bool | None | Only return the latest version of a memory | **Returns:** `dict` -- `{"results": [{id, memory, user_id, categories, score, created_at, ...}]}` @@ -104,9 +110,9 @@ memory = client.get(memory_id="ea925981-...") **Returns:** `dict` -- full memory object -#### get_all(**kwargs) +#### get_all(options=None, **kwargs) -Retrieve all memories with optional filtering. Requires at least one entity identifier. +Retrieve all memories with optional filtering. Requires non-empty `filters`; scope them with at least one entity identifier. ```python memories = client.get_all(filters={"user_id": "alice"}) @@ -117,15 +123,17 @@ memories = client.get_all(filters={"AND": [{"user_id": "alice"}, {"categories": | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `filters` | dict | None | Filter object with entity IDs and/or `AND`/`OR`/`NOT` conditions | -| `top_k` | int | None | Limit results | -| `page` | int | None | Page number | -| `page_size` | int | None | Results per page | +| `page` | int | 1 | Page number | +| `page_size` | int | 100 | Results per page (max 200) | +| `start_date` / `end_date` / `categories` | - | - | Not applied in v3. Use `filters` with `created_at` or `categories` | +| `show_expired` | bool | False | Include expired memories | +| `latest_only` | bool | None | Only return the latest version of a memory | -**Returns:** `dict` -- `{"results": [...]}` +**Returns:** `dict` -- `{"count": int, "next": str | None, "previous": str | None, "results": [...]}` -#### update(memory_id, text=None, metadata=None, timestamp=None) +#### update(memory_id, options=None, **kwargs) -Update a memory's content, metadata, or timestamp. At least one parameter required. +Update a memory's `text`, `metadata`, `timestamp`, or `expiration_date` (pass `expiration_date=None` to clear it). At least one required. ```python client.update("ea925981-...", text="Updated: vegan since 2024") @@ -134,17 +142,18 @@ client.update("ea925981-...", metadata={"verified": True}) **Returns:** `dict` -- updated memory -#### delete(memory_id) +#### delete(memory_id, delete_linked=False) -Permanently delete a single memory. +Permanently delete a single memory. With `delete_linked=True`, also deletes the older memories it superseded. ```python client.delete("ea925981-...") +client.delete("ea925981-...", delete_linked=True) ``` -#### delete_all(**kwargs) +#### delete_all(options=None, **kwargs) -Delete all memories matching filters. Irreversible. +Delete all memories matching the entity IDs (`user_id`, `agent_id`, `app_id`, `run_id`, passed as top-level kwargs). Irreversible. ```python client.delete_all(user_id="alice") @@ -156,7 +165,7 @@ Get the change history of a memory. ```python history = client.history("ea925981-...") -# Returns: [{previous_value, new_value, action, timestamps}] +# Returns: [{id, memory_id, input, old_memory, new_memory, event, user_id, categories, metadata, created_at, updated_at}] ``` --- @@ -170,10 +179,12 @@ Update up to 1000 memories in a single request. ```python client.batch_update([ {"memory_id": "uuid-1", "text": "Updated text"}, - {"memory_id": "uuid-2", "text": "Another update", "metadata": {"verified": True}}, + {"memory_id": "uuid-2", "text": "Another update"}, ]) ``` +Each item must include `text`. `metadata` on a batch item is ignored and a metadata-only item returns a 400. Use `update(memory_id, metadata=...)` to change metadata. + #### batch_delete(memories) Delete up to 1000 memories in a single request. @@ -208,7 +219,7 @@ client.delete_users(user_id="alice") #### reset() -Delete ALL users, agents, sessions, and memories. Complete data reset. +Delete ALL users, agents, sessions, and memories. Complete data reset. It only deletes the entities on the first page returned by `users()`, so with many entities re-run it until it raises `No entities to delete`, or delete per entity with `delete_users(user_id=...)`. ```python client.reset() @@ -223,16 +234,14 @@ client.reset() Create a structured export of memories. ```python -import json - -schema = json.dumps({ +schema = { "type": "object", "properties": { "name": {"type": "string"}, "preferences": {"type": "array", "items": {"type": "string"}}, } -}) -export = client.create_memory_export(schema=schema, user_id="alice") +} +export = client.create_memory_export(schema=schema, filters={"AND": [{"user_id": "alice"}]}) ``` #### get_memory_export(**kwargs) @@ -269,6 +278,19 @@ client.feedback( --- +### User Profiles + +```python +profile = client.get_profile("alice") +client.generate_profile("alice") +client.get_profile_settings() +client.update_profile_settings(enabled=True) +``` + +`get_profile` returns `status` (`succeeded`, `pending`, `failed`, `not_enabled`, `insufficient_data`) plus `profile`; generation is asynchronous, so branch on `status`. Other methods: `sample_profiles(limit=None)` and `get_profile_job(job_id_or_status_url)`. + +--- + ### Webhooks ```python @@ -284,10 +306,10 @@ webhook = client.create_webhook( ) # Update -client.update_webhook(webhook_id=123, name="Updated", url="https://new-url.com") +client.update_webhook(webhook_id="wh_123", name="Updated", url="https://new-url.com") # Delete -client.delete_webhook(webhook_id=123) +client.delete_webhook(webhook_id="wh_123") ``` --- @@ -304,7 +326,9 @@ config = client.project.get(fields=["custom_categories", "custom_instructions"]) client.project.update( custom_instructions="Extract dietary preferences and health info", custom_categories=[{"health": "Medical and dietary info"}], + agent_custom_instructions="Extract only what the agent learned about the user", multilingual=True, + decay=True, ) # Create/delete project @@ -326,6 +350,8 @@ client.project.remove_member(email="user@example.com") ```bash pip install mem0ai +pip install "mem0ai[nlp]" # optional: spaCy entity linking (Python 3.10-3.12) +pip install "mem0ai[extras]" # optional: fastembed for Qdrant BM25 keyword search ``` ### Memory Class @@ -333,9 +359,11 @@ pip install mem0ai ```python from mem0 import Memory -m = Memory() # Uses default config (OpenAI embedder + in-memory vector store) +m = Memory() # Defaults: OpenAI gpt-5-mini + text-embedding-3-small, local Qdrant at /tmp/qdrant ``` +`Memory(config)` takes a `MemoryConfig` object. For a plain dict use `Memory.from_config(config)`. Requires `OPENAI_API_KEY` for the default LLM and embedder. + **Import:** `from mem0 import Memory` (NOT `MemoryClient` -- that is the Platform client) ### Configuration @@ -343,28 +371,28 @@ m = Memory() # Uses default config (OpenAI embedder + in-memory vector store) ```python config = { "llm": { - "provider": "openai", # openai, groq, azure, ollama, lmstudio, google, anthropic, mistral + "provider": "openai", # openai, anthropic, gemini, groq, ollama, lmstudio, azure_openai, aws_bedrock, together, deepseek, xai, vllm, litellm, ... "config": { "model": "gpt-5-mini", "api_key": "sk-xxx", } }, "embedder": { - "provider": "openai", # openai, ollama, azure, lmstudio, google, huggingface + "provider": "openai", # openai, ollama, azure_openai, lmstudio, gemini, vertexai, huggingface, fastembed, aws_bedrock, together "config": { "model": "text-embedding-3-small", "api_key": "sk-xxx", } }, "vector_store": { - "provider": "qdrant", # faiss, qdrant, pgvector, redis, supabase, azure_ai_search, memory + "provider": "qdrant", # qdrant (default), chroma, pgvector, pinecone, milvus, redis, supabase, faiss, azure_ai_search, ... "config": { "collection_name": "my_memories", "host": "localhost", "port": 6333, } }, - "history_db_path": "history.db", # SQLite path for change history + "history_db_path": "history.db", # SQLite path for change history (default ~/.mem0/history.db) "custom_instructions": "...", # Custom LLM prompt for extraction } @@ -374,7 +402,7 @@ m = Memory.from_config(config) ### Context Manager ```python -with Memory(config) as m: +with Memory.from_config(config) as m: m.add("I prefer dark mode", user_id="alice") results = m.search("preferences", filters={"user_id": "alice"}) # SQLite connections released automatically @@ -384,7 +412,7 @@ with Memory(config) as m: All methods mirror the Platform client but run locally: -#### add(messages, *, user_id, agent_id, run_id, metadata, infer=True) +#### add(messages, *, user_id, agent_id, run_id, metadata, expiration_date, infer=True, memory_type, prompt) ```python m.add("I'm a vegetarian", user_id="alice") @@ -396,9 +424,11 @@ m.add([ At least one of `user_id`, `agent_id`, `run_id` required. -**Returns:** `{"results": [...], "relations": [...]}` +`timestamp` raises `ValueError` in OSS (Platform only). -#### search(query, *, filters=None, top_k=20, threshold=0.1, rerank=False) +**Returns:** `{"results": [{"id": "...", "memory": "...", "event": "ADD"}]}` + +#### search(query, *, top_k=20, filters=None, threshold=0.1, rerank=False, explain=False, show_expired=False) ```python results = m.search("dietary preferences", filters={"user_id": "alice"}, top_k=5) @@ -406,11 +436,11 @@ results = m.search("dietary preferences", filters={"user_id": "alice"}, top_k=5) Entity IDs (`user_id`, `agent_id`, `run_id`) must be passed inside the `filters` dict. -Supports filter operators: `eq`, `ne`, `in`, `nin`, `gt`, `gte`, `lt`, `lte`, `contains`, `not_contains`. +Supports filter operators: `eq`, `ne`, `in`, `nin`, `gt`, `gte`, `lt`, `lte`, `contains`, `icontains`, plus `AND` / `OR` / `NOT`. `reference_date` raises `ValueError` in OSS (Platform only). -#### get(memory_id) / get_all(**kwargs) / update(memory_id, data, metadata=None) / delete(memory_id) / delete_all(**kwargs) / history(memory_id) +#### get(memory_id) / get_all(*, filters, top_k=20, show_expired=False) / update(memory_id, text=None, metadata=None, expiration_date) / delete(memory_id) / delete_all(user_id=None, agent_id=None, run_id=None) / history(memory_id) -Same interface as Platform client. +`get_all()` requires entity IDs inside `filters` and returns `{"results": [...]}`. `update()` takes `text` (`data` is a deprecated alias) and needs at least one of `text`, `metadata`, `expiration_date`. `delete_all()` needs at least one entity ID and takes them top-level. `m.project.update()` raises `ValueError` in OSS. #### reset() @@ -429,7 +459,7 @@ Release SQLite connections. Called automatically when using context manager. ```python from mem0 import AsyncMemory -m = AsyncMemory(config) +m = AsyncMemory.from_config(config) await m.add("text", user_id="alice") results = await m.search("query", filters={"user_id": "alice"}) ``` @@ -459,10 +489,10 @@ results = await m.search("query", filters={"user_id": "alice"}) ## v2 Compatibility -If you're using SDK v2.x or the v2 API: +The "v2" line is Python SDK 1.x (TypeScript SDK 2.x). If you are still on it, these are the differences from Python 2.x: **API Changes:** -- **Entity IDs in search/get_all:** Pass `user_id`, `agent_id` as top-level kwargs instead of inside `filters` +- **Entity IDs in search/get_all:** `user_id`, `agent_id` were top-level kwargs, now they go inside `filters` (top-level raises `ValueError`) ```python # v2 results = client.search("query", user_id="alice") @@ -470,18 +500,23 @@ If you're using SDK v2.x or the v2 API: results = client.search("query", filters={"user_id": "alice"}) ``` - **add() returns:** v2 returns ADD, UPDATE, DELETE events; v3 returns ADD only +- **Platform add() is async:** returns `{"event_id": "...", "status": "PENDING"}` **Default Changes:** -| Param | v2 | v3 | -|-------|----|----| -| `top_k` | 100 | 20 | -| `threshold` | None | 0.1 | -| `rerank` | True | False | +| Param | v2 Platform | v3 Platform | v2 OSS | v3 OSS | +|-------|-------------|-------------|--------|--------| +| `top_k` | 10 | 10 | 100 | 20 | +| `threshold` | 0.3 | server-side cutoff | None | 0.1 | +| `rerank` | False | False | True | False | **Removed Parameters:** - Constructor: `org_id`, `project_id` -- add(): `async_mode`, `output_format`, `enable_graph`, `immutable`, `expiration_date`, `filter_memories`, `batch_size`, `force_add_only`, `includes`, `excludes`, `keyword_search` +- add(): `async_mode`, `output_format`, `enable_graph`, `immutable`, `filter_memories`, `batch_size`, `force_add_only`, `includes`, `excludes`, `keyword_search` - search()/get_all(): `enable_graph` -- Config: `enable_graph`, `graph_store`, `custom_fact_extraction_prompt` (renamed to `custom_instructions`) +- Config: `enable_graph`, `graph_store`, `custom_fact_extraction_prompt` (renamed to `custom_instructions`), `custom_update_memory_prompt` (deprecated) + +`expiration_date` is still supported on `add()` and `update()`. + +**Graph memory:** the external graph store (Neo4j, Memgraph, Kuzu, AGE) was removed from OSS. Entity linking is built in (spaCy via `mem0ai[nlp]`, stored in a `{collection}_entities` vector collection) and falls back to semantic-only search without it. See the [v2 to v3 migration guide](https://docs.mem0.ai/migration/oss-v2-to-v3) for full details. diff --git a/skills/mem0/references/api-reference.md b/skills/mem0/references/api-reference.md index 62ec4bea7..01d39ee02 100644 --- a/skills/mem0/references/api-reference.md +++ b/skills/mem0/references/api-reference.md @@ -14,8 +14,16 @@ All endpoints require: `Authorization: Token ` | Get Single Memory | `GET` | `/v1/memories/{memory_id}/` | | Update Memory | `PUT` | `/v1/memories/{memory_id}/` | | Delete Memory | `DELETE` | `/v1/memories/{memory_id}/` | +| Memory History | `GET` | `/v1/memories/{memory_id}/history/` | +| Delete by Filter | `DELETE` | `/v1/memories/` (query params `user_id`, `agent_id`, `app_id`, `run_id`, `metadata`; `*` matches all) | +| Batch Update / Delete | `PUT` / `DELETE` | `/v1/batch/` (max 1000 memories per request) | +| Feedback | `POST` | `/v1/feedback/` | +| Create / Get Export | `POST` | `/v1/exports/`, `/v1/exports/get/` | +| List Entities | `GET` | `/v1/entities/` | +| Delete Entity | `DELETE` | `/v2/entities/{entity_type}/{entity_id}/` | +| Event Status | `GET` | `/v1/event/{event_id}/` | -Note: v1/v2 endpoints still work (backward compatible). +The `GET`/`POST` `/v1/memories/`, `POST` `/v2/memories/`, and `POST` `/v1/memories/search/` and `/v2/memories/search/` endpoints are marked deprecated in the OpenAPI spec. Use the `/v3/` endpoints above. ## Memory Object Structure @@ -26,14 +34,16 @@ Note: v1/v2 endpoints still work (backward compatible). | `user_id` | string | Associated user | | `agent_id` | string (nullable) | Agent identifier | | `app_id` | string (nullable) | Application identifier | -| `run_id` | string (nullable) | Run/session identifier | +| `run_id` | string (nullable) | Run/session identifier (see note below) | | `metadata` | object | Custom key-value pairs | | `categories` | array of strings | Auto-assigned category tags | -| `hash` | string | Content hash | +| `expiration_date` | string (nullable) | Date after which the memory is hidden unless `show_expired` is true | | `created_at` | datetime | Creation timestamp | | `updated_at` | datetime | Last modification timestamp | -Search results additionally include `score` (relevance metric). +Search results additionally include `score` (relevance metric) and `score_breakdown` (per-signal scores). Get and get-all results additionally include `structured_attributes` (temporal breakdown of the creation time), `replaced_by`, and `synthesized`, and get also returns `lifecycle_state`. Get and get-all omit `app_id` and `run_id` when they are not set. + +The run/session identifier is `run_id` in search results but `session_id` in get, get-all, and history results. ## Scoping Identifiers @@ -46,13 +56,16 @@ Memories can be scoped to different levels: | Application | `app_id` | Cross-agent app-level memory | | Run/Session | `run_id` | Session-scoped temporary memory | -**Critical:** Combining `user_id` and `agent_id` in a single AND filter yields empty results. Entities are stored separately. Use `OR` logic or separate queries. +**Critical:** Combining `user_id` and `agent_id` in a single AND filter yields empty results for memories created with `infer=true`. Each extracted fact is attributed to its speaker, so a record carries `user_id` (user messages) or `agent_id` (assistant messages), not both. Use `OR` logic or separate queries. Only Direct Import (`infer=false`) writes both fields on one record. `app_id` and `run_id` are stored on every record. + +Filters only constrain the entities you mention. `{"user_id": "alice"}` does not require `agent_id`, `app_id`, or `run_id` to be null. ## Processing Model - Memories are processed **asynchronously** (v3 default) -- Add responses return queued `ADD` events only (v3 is ADD-only, no UPDATE/DELETE) -- Poll status via `GET /v1/event/{event_id}/` +- Add responses return a `PENDING` event (v3 is ADD-only, no UPDATE/DELETE) +- Poll status via `GET /v1/event/{event_id}/` (`PENDING`, `RUNNING`, `FAILED`, `SUCCEEDED`) +- `infer=false` is synchronous: memories are stored verbatim and the response carries `message` and `results` ## Filter System @@ -68,7 +81,7 @@ Filters use nested JSON with a logical operator at the root: } ``` -Root must be `AND`, `OR`, or `NOT`. Simple shorthand `{"user_id": "alice"}` also works. +The root can also be a bare condition such as `{"user_id": "alice"}`. Sibling top-level keys in a flat object are implicitly ANDed. Use `AND`, `OR`, or `NOT` for OR/NOT semantics or nesting. An unrecognized top-level key returns a 400. ### Supported Operators @@ -88,20 +101,21 @@ Root must be `AND`, `OR`, or `NOT`. Simple shorthand `{"user_id": "alice"}` also | Field | Valid Operators | |-------|-----------------| | `user_id`, `agent_id`, `app_id`, `run_id` | `eq`, `ne`, `in`, `*` | -| `created_at`, `updated_at`, `timestamp` | `gt`, `gte`, `lt`, `lte`, `eq`, `ne` | -| `categories` | `eq`, `ne`, `in`, `contains` | -| `metadata` | `eq`, `ne`, `contains` (top-level keys only) | +| `created_at`, `updated_at`, `timestamp`, `expiration_date` | `gt`, `gte`, `lt`, `lte`, `ne` (explicit `eq` is rejected, pass a bare value; `in` fails with a 503 in search and a 500 in get-all) | +| `categories` | `in`, `contains` (`eq` and `ne` are rejected) | +| `metadata` | `eq`, `ne`, `contains` (top-level keys only). `contains` is case-sensitive and matches the whole stored value or one member of a list value, not a substring. `icontains` is rejected with a 400 | | `keywords` | `contains`, `icontains` | -| `memory_ids` | `in` | +| `memory_ids` | plain list of UUIDs (no `in`) | ### Filter Constraints -1. **Entity scope partitioning:** `user_id` AND `agent_id` in one `AND` block yields empty results. +1. **Entity scope partitioning:** `user_id` AND `agent_id` in one `AND` block yields empty results (except for Direct Import records). 2. **Metadata limitations:** Only top-level keys. Only `eq`, `contains`, `ne`. No `in` or `gt`. -3. **Operator syntax:** Use `gte`, `lt`, `ne`. SQL-style (`>=`, `!=`) rejected. -4. **Entity filter required for get-all:** At least one of `user_id`, `agent_id`, `app_id`, or `run_id`. +3. **Operator syntax:** Use `gte`, `lt`, `ne`. SQL-style (`>=`, `!=`) rejected. There is no `nin` on Platform: use `{"NOT": [{"categories": {"in": [...]}}]}`. +4. **Filters required for get-all:** Empty or missing `filters` return a 400. Scope the listing with at least one of `user_id`, `agent_id`, `app_id`, or `run_id` (search enforces this, get-all does not). 5. **Wildcard excludes null:** `*` matches only non-null values. 6. **Date format:** ISO 8601 (`YYYY-MM-DDTHH:MM:SSZ`). Timezone-naive defaults to UTC. +7. **Keyword filter:** `keywords` works in `get_all` filters but returns a 503 inside `search()` filters (MEM-5746). Pass the text as `query` for search. ## Response Formats @@ -109,13 +123,12 @@ Root must be `AND`, `OR`, or `NOT`. Simple shorthand `{"user_id": "alice"}` also ```json { - "message": "Memory processing has been queued for background execution", - "status": "PENDING", - "event_id": "evt-uuid" + "event_id": "evt-uuid", + "status": "PENDING" } ``` -v3 is ADD-only. No UPDATE or DELETE events. +v3 is ADD-only. No UPDATE or DELETE events. With `infer=false` the call is synchronous and the response also carries `message` and `results` (`[{"id": ..., "data": {"memory": ...}, "event": "ADD"}]`). ### Search Response @@ -134,7 +147,7 @@ v3 is ADD-only. No UPDATE or DELETE events. } ``` -In v3, `score` is a combined multi-signal relevance score. +In v3, `score` is a combined multi-signal relevance score in [0, 1]. Request defaults: `top_k` 10 (1 to 1000), `rerank` false. `threshold` is a server-side cutoff applied before score blending, not a floor on the returned `score`: the default and `0.0` returned the same or nearly the same results in live tests, including scores below 0.1. ### Get All Response (v3) @@ -147,4 +160,4 @@ In v3, `score` is a combined multi-signal relevance score. } ``` -v3 returns paginated envelope. Use `page` and `page_size` query params. +v3 returns paginated envelope. Use `page` (default 1) and `page_size` (default 100, max 200) query params. diff --git a/skills/mem0/references/architecture.md b/skills/mem0/references/architecture.md index 4a04c820b..f0ca4083d 100644 --- a/skills/mem0/references/architecture.md +++ b/skills/mem0/references/architecture.md @@ -23,9 +23,10 @@ Mem0 is a managed memory layer that sits between your AI application and users. User Input → Retrieve relevant memories → Enrich LLM prompt → Generate response → Store new memories ``` -Mem0 handles the complexity of extraction, deduplication, conflict resolution, and semantic retrieval so your application only needs to call `search()` and `add()`. +Mem0 handles the complexity of extraction, deduplication, and hybrid retrieval so your application only needs to call `search()` and `add()`. **Storage architecture:** +- **SQL database**: Facts and metadata (the source of truth for each memory) - **Vector store**: Embeddings for semantic similarity search - **Entity store**: Automatic entity linking for relationship-aware retrieval @@ -64,20 +65,22 @@ Messages In v3 processes memories asynchronously by default: - API returns immediately: `{"status": "PENDING", "event_id": "evt-..."}` -- Poll status via `GET /v1/event/{event_id}/` +- Poll status via `GET /v1/event/{event_id}/` (the TS client camelCases response keys, so it sees `eventId`) - Use webhooks for completion notifications +- `infer=False` is the exception: it runs synchronously and returns `message` and `results` ### Extraction modes **Inferred (`infer=True`, default):** -- LLM extracts structured facts from conversation -- Conflict resolution deduplicates and resolves contradictions +- LLM extracts structured facts from conversation, including facts stated by the assistant +- Redundant facts are removed, but nothing is overwritten: when a fact changes, both versions are kept with temporal context - Best for: natural conversation → memory **Raw (`infer=False`):** - Stores text exactly as provided, no LLM processing -- Skips conflict resolution — same fact can be stored twice -- Only `user` role messages are stored; `assistant` messages ignored +- Skips semantic duplicate detection (same fact in different words can be stored twice); exact repeats are deduplicated by hash +- `user` and `assistant` messages are stored, one memory per message; `system` messages are dropped +- Structured multimodal content (`image_url`, `pdf_url`, `txt_url`, `mdx_url`) is rejected with a 400, not skipped - Best for: bulk imports, pre-structured data, migrations **Warning:** Don't mix `infer=True` and `infer=False` for the same data — the same fact will be stored twice. @@ -101,6 +104,7 @@ Query In │ 2. PARALLEL SCORING │ Semantic search (vector similarity) │ │ BM25 keyword search (term matching) │ │ Entity matching (entity graph boost) +│ │ Temporal scoring (time metadata vs query intent) └─────────┬───────────┘ │ ▼ @@ -117,18 +121,17 @@ Query In | Parameter | Default | Notes | |-----------|---------|-------| -| `top_k` | 20 | Was 100 in v2 | -| `threshold` | 0.1 | Was None in v2 | -| `rerank` | False | Was True in v2 | +| `top_k` | 10 | Range 1-1000 (OSS default is 20) | +| `threshold` | server-side cutoff | Not a floor on the returned `score`. On Platform v3 the default and `0.0` return the same or nearly the same results. Was 0.3 on Platform v2 (None on OSS v2) | +| `rerank` | False | Was False on Platform v2 (True on OSS v2) | -### Implicit null scoping +### Unmentioned entities are not constrained -When you search with `filters={"user_id": "alice"}` only, Mem0 returns memories where `agent_id`, `app_id`, and `run_id` are all null. This prevents cross-scope leakage by default. +When you search with `filters={"user_id": "alice"}` only, Mem0 matches on `user_id` alone. It does not require `agent_id`, `app_id`, or `run_id` to be null, so records that also carry those fields are returned. -To include memories with non-null fields, use explicit filters: +To narrow to a scope, name the entity explicitly: ```python -# Gets memories for alice regardless of agent/app/run -filters={"OR": [{"user_id": "alice"}]} +filters={"AND": [{"user_id": "alice"}, {"run_id": "session_123"}]} ``` --- @@ -149,7 +152,7 @@ v3 uses ADD-only extraction. Memories accumulate over time rather than being con ### Deletion - Single: `client.delete(memory_id)` - Batch: `client.batch_delete([...])` -- Bulk: `client.delete_all(filters={"user_id": "alice"})` +- Bulk: `client.delete_all(user_id="alice")` --- @@ -185,13 +188,15 @@ v3 uses ADD-only extraction. Memories accumulate over time rather than being con | `user_id` | string | Primary entity scope | | `agent_id` | string | Agent scope | | `app_id` | string | Application scope | -| `run_id` | string | Session/run scope | +| `run_id` | string | Session/run scope (named `session_id` in get, get-all, and history responses) | | `metadata` | object | Custom key-value pairs for filtering | | `categories` | array | Auto-assigned or custom category tags | +| `expiration_date` | string | Date after which the memory is hidden unless `show_expired` is true | | `created_at` | datetime | Creation timestamp | | `updated_at` | datetime | Last modification timestamp | | `structured_attributes` | object | Temporal breakdown for time-based queries | -| `score` | float | Semantic similarity (search results only, 0-1) | +| `lifecycle_state` | string | Lifecycle state of the memory (returned by get) | +| `score` | float | Combined multi-signal relevance (search results only, 0-1) | --- @@ -208,12 +213,12 @@ Mem0 separates memories across four dimensions to prevent data mixing: ### Storage model -Each entity combination creates separate records. A memory with `user_id="alice"` is stored separately from one with `user_id="alice"` + `agent_id="bot"`. +`app_id` and `run_id` are stored on every record the call produces. `user_id` and `agent_id` behave differently on the default extraction path: each extracted fact is attributed to whoever stated it, so a record carries `user_id` (from `user` messages) or `agent_id` (from `assistant` messages), not both. Only Direct Import (`infer=False`) writes both on one record. ### Critical: cross-entity queries ```python -# This returns NOTHING — user and agent memories are stored separately +# This returns NOTHING for inferred memories: a record has user_id OR agent_id, not both filters={"AND": [{"user_id": "alice"}, {"agent_id": "bot"}]} # Use OR to query multiple scopes @@ -327,4 +332,4 @@ def chat(user_input: str, user_id: str, session_id: str) -> str: | **RAG over documents** | Good for static knowledge | No personalization, no memory updates | | **Mem0 Platform** | Managed extraction + dedup + graph + scoping | External dependency, async processing delay | -Mem0 combines the best of vector search (semantic retrieval) with automatic extraction (LLM-powered), conflict resolution (deduplication), and structured scoping (multi-tenancy) — in a single managed API. +Mem0 combines the best of vector search (semantic retrieval) with automatic extraction (LLM-powered), deduplication, and structured scoping (multi-tenancy), in a single managed API. diff --git a/skills/mem0/references/features.md b/skills/mem0/references/features.md index f930d9a74..a8ff547fb 100644 --- a/skills/mem0/references/features.md +++ b/skills/mem0/references/features.md @@ -23,6 +23,7 @@ v3 uses multi-signal hybrid search combining: - **Semantic search** (vector similarity) - **BM25 keyword search** (normalized term matching) - **Entity matching** (entity graph boost) +- **Temporal reasoning** (Platform only): memories whose event dates match time expressions in the query ("last week", "as of March 2025") get a boost This is automatic — no configuration needed. @@ -56,10 +57,10 @@ v3 replaces graph memory with built-in entity linking. Entities (proper nouns, q ### How It Works 1. **Extraction**: During `add()`, entities are automatically extracted from memory text -2. **Storage**: Entities are stored in a parallel collection (`{collection}_entities`) +2. **Storage**: Entities are stored in a parallel collection (OSS: `{collection}_entities`; on Platform the entity store is managed for you) 3. **Retrieval**: During `search()`, query entities are matched and used to boost relevant memories -Entity linking is automatic — no configuration required. The boost is folded into the combined `score` on each result. +Entity linking is automatic, no configuration required. The boost is folded into the combined `score` on each result. On Platform this is Graph Memory: built in on all plans, no external graph store to provision, and the dashboard Graph view is Pro and Enterprise only. ### v2 Migration Note @@ -141,6 +142,32 @@ client.project.update(custom_instructions="Your guidelines here...") await client.updateProject({ customInstructions: "Your guidelines here..." }); ``` +### Agent Custom Instructions + +`agent_custom_instructions` (Python SDK 2.0.17+, TypeScript SDK 3.1.5+) is a second set of extraction rules that applies only to agent-scoped memories. It is unset by default, and while unset `custom_instructions` applies to every memory. + +```python +client.project.update( + custom_instructions="Extract the user's preferences, goals, and constraints.", + agent_custom_instructions="Extract tools that failed, and retry strategies that worked.", +) +``` + +```javascript +await client.updateProject({ + customInstructions: "Extract the user's preferences, goals, and constraints.", + agentCustomInstructions: "Extract tools that failed, and retry strategies that worked.", +}); +``` + +| The `add` call passes | Instructions applied | +|-----------------------|----------------------| +| `user_id` only | `custom_instructions` | +| `agent_id` only | `agent_custom_instructions` | +| `user_id` and `agent_id` | `agent_custom_instructions` for memories attributed to the assistant, `custom_instructions` for the rest | + +Both fields can also be passed per `add` call to override the project setting for that call. Clear the project value with an empty string. + ### Template Structure 1. **Task Description** -- brief extraction overview @@ -194,8 +221,11 @@ for item in feedback_data: **TypeScript:** ```typescript -await client.feedback('mem-123', { - feedback: 'POSITIVE', +import { Feedback } from 'mem0ai'; + +await client.feedback({ + memoryId: 'mem-123', + feedback: Feedback.POSITIVE, feedbackReason: 'Accurately captured dietary preference', }); ``` @@ -209,8 +239,6 @@ Create structured exports of memories using customizable schemas with filters. ### Usage ```python -import json - # Define export schema schema = { "type": "object", @@ -223,8 +251,8 @@ schema = { # Create export response = client.create_memory_export( - schema=json.dumps(schema), - filters={"user_id": "alice"}, + schema=schema, + filters={"AND": [{"user_id": "alice"}]}, export_instructions="Create comprehensive profile based on all memories" ) @@ -238,33 +266,39 @@ result = client.get_memory_export(memory_export_id=response["id"]) ## Group Chat -Process multi-participant conversations and automatically attribute memories to individual speakers. +Process multi-participant conversations and keep a separate memory profile per speaker. Scope comes only from the `user_id`, `agent_id`, and `run_id` you pass to `add()`: Mem0 does not infer it from the conversation. ### Usage -```python -messages = [ - {"role": "user", "name": "Alice", "content": "I think we should use React for the frontend"}, - {"role": "user", "name": "Bob", "content": "I prefer Vue.js, it's simpler for our use case"}, - {"role": "assistant", "content": "Both are great choices. Let me note your preferences."}, -] +Call `add()` once per participant with their own `user_id`, and share a `run_id` for the session: -# Mem0 automatically attributes memories to each speaker -response = client.add(messages, run_id="team_meeting_1") +```python +client.add( + [{"role": "user", "content": "I think we should use React for the frontend"}], + user_id="alice", run_id="team_meeting_1", +) +client.add( + [{"role": "user", "content": "I prefer Vue.js, it's simpler for our use case"}], + user_id="bob", run_id="team_meeting_1", +) # Retrieve Alice's memories from that session alice_mems = client.get_all( filters={"AND": [{"user_id": "alice"}, {"run_id": "team_meeting_1"}]} ) + +session_mems = client.get_all( + filters={"AND": [{"user_id": "*"}, {"run_id": "team_meeting_1"}]} +) ``` -Use the `name` field in messages to identify speakers. Mem0 maps names to entity scopes automatically. +A `name` field on a message is stored as extraction context only. Passing messages from two different `name`s in one `add()` call does not split the memories: they all land under the `user_id` you passed. --- ## MCP Integration -Model Context Protocol integration enables AI clients (Claude, Claude Code, Cursor, Windsurf, VS Code, OpenCode) to manage Mem0 memory autonomously. +Model Context Protocol integration enables AI clients (Claude, Claude Code, Codex, Cursor, Windsurf, VS Code, OpenCode) to manage Mem0 memory autonomously. ### Setup @@ -275,15 +309,17 @@ npx mcp-add \ --name mem0-mcp \ --type http \ --url "https://mcp.mem0.ai/mcp" \ - --clients "claude,claude code,cursor,windsurf,vscode,opencode" + --clients "claude code,cursor,windsurf,vscode,opencode" ``` +Claude Desktop rejects `mcp-add`: add it under Settings > Connectors instead. Codex reads `~/.codex/config.toml` (TOML, server name `mem0`). The first tool call opens a browser sign-in, or send your API key as a bearer token for headless environments. + ### Available MCP Tools -The MCP server exposes 9 memory tools that AI agents can use autonomously: -- Add, search, get, update, delete memories -- Get history, list users, delete users -- Search Mem0 documentation +The MCP server exposes 11 memory tools that AI agents can use autonomously: +- `add_memory`, `search_memories`, `get_memories`, `get_memory`, `update_memory` +- `delete_memory`, `delete_all_memories`, `delete_entities` +- `list_entities`, `list_events`, `get_event_status` ### How It Works @@ -307,6 +343,12 @@ Real-time event notifications for memory operations. | `memory_update` | Memory modified | | `memory_delete` | Memory removed | | `memory_categorize` | Memory tagged | +| `ingest_job_completed` | Ingest job finished successfully | +| `ingest_job_partially_completed` | Ingest job finished with some items failed | +| `ingest_job_failed` | Ingest job failed entirely | +| `ingest_job_cancelled` | Ingest job cancelled | + +The TypeScript `WebhookEvent` enum covers only the four `memory_*` events (`MEMORY_ADDED`, `MEMORY_UPDATED`, `MEMORY_DELETED`, `MEMORY_CATEGORIZED`). ### Create Webhook @@ -321,6 +363,18 @@ webhook = client.create_webhook( ) ``` +```typescript +import { WebhookEvent } from 'mem0ai'; + +const webhook = await client.createWebhook({ + url: 'https://your-app.com/webhook', + name: 'Memory Logger', + eventTypes: [WebhookEvent.MEMORY_ADDED, WebhookEvent.MEMORY_CATEGORIZED], +}); +``` + +TypeScript `createWebhook` takes no `projectId`: it uses the project resolved by the client. `getWebhooks({ projectId })` accepts one optionally. + ### Manage Webhooks ```python @@ -341,6 +395,7 @@ client.delete_webhook(webhook_id="wh_123") ### Payload Structure +The POST body wraps everything in `event_details`. Memory events contain: ID, data object with memory content, event type (`ADD`/`UPDATE`/`DELETE`). Categorization events contain: memory ID, event type (`CATEGORIZE`), assigned category labels. @@ -348,59 +403,4 @@ Categorization events contain: memory ID, event type (`CATEGORIZE`), assigned ca ## Multimodal Support -Mem0 can process images and documents alongside text. - -### Supported Media Types - -- Images: JPG, PNG -- Documents: MDX, TXT, PDF - -### Image via URL - -```python -image_message = { - "role": "user", - "content": { - "type": "image_url", - "image_url": {"url": "https://example.com/image.jpg"} - } -} -client.add([image_message], user_id="alice") -``` - -### Image via Base64 - -```python -import base64 -with open("photo.jpg", "rb") as f: - base64_image = base64.b64encode(f.read()).decode("utf-8") - -image_message = { - "role": "user", - "content": { - "type": "image_url", - "image_url": {"url": f"data:image/jpeg;base64,{base64_image}"} - } -} -client.add([image_message], user_id="alice") -``` - -### Document (MDX/TXT) - -```python -doc_message = { - "role": "user", - "content": {"type": "mdx_url", "mdx_url": {"url": document_url}} -} -client.add([doc_message], user_id="alice") -``` - -### PDF Document - -```python -pdf_message = { - "role": "user", - "content": {"type": "pdf_url", "pdf_url": {"url": pdf_url}} -} -client.add([pdf_message], user_id="alice") -``` +`POST /v3/memories/add/` (what `client.add()` calls) accepts only string `content`. Structured multimodal content (`image_url`, `pdf_url`, `txt_url`, `mdx_url`) is rejected with a 400 `Not a valid string.`, with `infer=True` and with `infer=False`. To remember what an image or document says, extract the text yourself and pass it as a plain string. diff --git a/skills/mem0/references/integration-patterns.md b/skills/mem0/references/integration-patterns.md index 68232719e..a6d7e64cd 100644 --- a/skills/mem0/references/integration-patterns.md +++ b/skills/mem0/references/integration-patterns.md @@ -38,7 +38,7 @@ prompt = ChatPromptTemplate.from_messages([ def retrieve_context(query: str, user_id: str): """Retrieve relevant memories from Mem0""" - memories = mem0.search(query, user_id=user_id) + memories = mem0.search(query, filters={"user_id": user_id}) memory_list = memories['results'] serialized = ' '.join([m["memory"] for m in memory_list]) return [ @@ -66,7 +66,9 @@ def chat_turn(user_input: str, user_id: str) -> str: Source: [docs.mem0.ai/integrations/crewai](https://docs.mem0.ai/integrations/crewai) -CrewAI has native Mem0 integration via `memory_config`: +Install: `pip install crewai crewai-tools mem0ai` + +Newer CrewAI versions removed the `memory_config={"provider": "mem0"}` shortcut on `Crew(...)`. Wire Mem0 in explicitly through `MemoryClient` (retrieve, inject into the task, store). CrewAI's own `ExternalMemory` API is the native alternative; see the [CrewAI memory docs](https://docs.crewai.com/en/concepts/memory) for the shape your version expects. ```python from crewai import Agent, Task, Crew, Process @@ -74,7 +76,6 @@ from mem0 import MemoryClient client = MemoryClient() -# Store user preferences first messages = [ {"role": "user", "content": "I am more of a beach person than a mountain person."}, {"role": "assistant", "content": "Noted! I'll recommend beach destinations."}, @@ -82,41 +83,41 @@ messages = [ ] client.add(messages, user_id="crew_user_1") -# Create agent -travel_agent = Agent( - role="Personalized Travel Planner", - goal="Plan personalized travel itineraries", - backstory="You are a seasoned travel planner.", - memory=True, -) +def get_user_context(user_id: str, query: str) -> str: + results = client.search(query, filters={"user_id": user_id}).get("results", []) + return "\n".join(f"- {m['memory']}" for m in results) -# Create task -task = Task( - description="Find places to live, eat, and visit in San Francisco.", - expected_output="A detailed list of places to live, eat, and visit.", - agent=travel_agent, -) +def plan_trip(destination: str, user_id: str): + travel_agent = Agent( + role="Personalized Travel Planner", + goal="Plan personalized travel itineraries", + backstory="You are a seasoned travel planner.", + ) + user_context = get_user_context(user_id, f"travel preferences for {destination}") + task = Task( + description=f"""Find places to live, eat, and visit in {destination}. -# Setup crew with Mem0 memory -crew = Crew( - agents=[travel_agent], - tasks=[task], - process=Process.sequential, - memory=True, - memory_config={ - "provider": "mem0", - "config": {"user_id": "crew_user_1"}, - } -) + Known preferences for this user: + {user_context or "No stored preferences yet."} + """, + expected_output=f"A detailed list of places to live, eat, and visit in {destination}.", + agent=travel_agent, + ) + crew = Crew(agents=[travel_agent], tasks=[task], process=Process.sequential) + result = crew.kickoff() + client.add([{"role": "user", "content": f"Planned a trip to {destination}."}], user_id=user_id) + return result -result = crew.kickoff() +result = plan_trip("San Francisco", "crew_user_1") ``` +`add()` is asynchronous on the Platform, so the seed memories above are not searchable the instant it returns and a `plan_trip` call straight after it can see no preferences. Run the seeding in an earlier session, or wait until the `add` event is `SUCCEEDED` (poll `GET /v1/event/{event_id}/`) before the first `plan_trip`. The `add` at the end of `plan_trip` only writes, so it needs no wait. + --- ## Vercel AI SDK -> **Dedicated skill available.** For comprehensive Vercel AI SDK documentation, see the [mem0-vercel-ai-sdk skill](../mem0-vercel-ai-sdk/SKILL.md) ([GitHub](https://github.com/mem0ai/mem0/tree/main/skills/mem0-vercel-ai-sdk)). +> **Dedicated skill available.** For comprehensive Vercel AI SDK documentation, see the [mem0-vercel-ai-sdk skill](../../mem0-vercel-ai-sdk/SKILL.md) ([GitHub](https://github.com/mem0ai/mem0/tree/main/skills/mem0-vercel-ai-sdk)). Install: `npm install @mem0/vercel-ai-provider` @@ -150,7 +151,7 @@ mem0 = MemoryClient() @function_tool def search_memory(query: str, user_id: str) -> str: """Search through past conversations and memories""" - memories = mem0.search(query, user_id=user_id, top_k=3) + memories = mem0.search(query, filters={"user_id": user_id}, top_k=3) if memories and memories.get('results'): return "\n".join([f"- {mem['memory']}" for mem in memories['results']]) return "No relevant memories found." @@ -209,7 +210,11 @@ result = Runner.run_sync(triage_agent, "Plan a healthy meal for my Italy trip") Source: [docs.mem0.ai/integrations/pipecat](https://docs.mem0.ai/integrations/pipecat) +Install: `pip install "pipecat-ai[mem0]"` + ```python +import os + from pipecat.services.mem0 import Mem0MemoryService memory = Mem0MemoryService( @@ -236,8 +241,6 @@ pipeline = Pipeline([ ]) ``` - - --- ## LangGraph @@ -266,7 +269,7 @@ def chatbot(state: State): user_id = state["mem0_user_id"] # Retrieve relevant memories - memories = mem0.search(messages[-1].content, user_id=user_id) + memories = mem0.search(messages[-1].content, filters={"user_id": user_id}) context = "Relevant context:\n" for memory in memories["results"]: context += f"- {memory['memory']}\n" @@ -344,6 +347,8 @@ Install: `pip install autogen mem0ai` Multi-agent conversational systems with memory persistence. ```python +import os + from autogen import ConversableAgent from mem0 import MemoryClient @@ -359,7 +364,7 @@ agent = ConversableAgent( def get_context_aware_response(question: str) -> str: # Retrieve memories for context - relevant_memories = memory_client.search(question, user_id=USER_ID) + relevant_memories = memory_client.search(question, filters={"user_id": USER_ID}) context = "\n".join([m["memory"] for m in relevant_memories.get("results", [])]) prompt = f"""Answer considering previous interactions: @@ -384,12 +389,15 @@ Beyond the examples above, Mem0 integrates with: | Framework | Type | Install | |-----------|------|---------| -| [Mastra](https://docs.mem0.ai/integrations/mastra) | TS agent framework | `npm install @mastra/mem0` | +| [Mastra](https://docs.mem0.ai/integrations/mastra) | TS agent framework | `npm install @mastra/core @mastra/mem0 @ai-sdk/openai zod` | | [ElevenLabs](https://docs.mem0.ai/integrations/elevenlabs) | Voice AI | `pip install elevenlabs mem0ai` | | [LiveKit](https://docs.mem0.ai/integrations/livekit) | Real-time voice/video | `pip install livekit-agents mem0ai` | -| [Camel AI](https://docs.mem0.ai/integrations/camel-ai) | Multi-agent framework | `pip install camel-ai[all] mem0ai` | -| [AWS Bedrock](https://docs.mem0.ai/integrations/aws-bedrock) | Cloud LLM provider | `pip install boto3 mem0ai` | +| [Camel AI](https://docs.mem0.ai/integrations/camel-ai) | Multi-agent framework | `pip install "camel-ai>=0.2.0" mem0ai` | +| [AWS Bedrock](https://docs.mem0.ai/integrations/aws-bedrock) | Cloud LLM provider | `pip install mem0ai boto3 opensearch-py` | | [Dify](https://docs.mem0.ai/integrations/dify) | Low-code AI platform | Plugin-based | | [Google AI ADK](https://docs.mem0.ai/integrations/google-ai-adk) | Google agent framework | `pip install google-adk mem0ai` | +| [Agno](https://docs.mem0.ai/integrations/agno) | Multimodal agent framework | `pip install agno mem0ai` | +| [Strands Agents](https://docs.mem0.ai/integrations/strands) | AWS agent SDK (native `MemoryStore`) | `pip install mem0-strands` | +| [LangChain Tools](https://docs.mem0.ai/integrations/langchain-tools) | Mem0 tools for any LangChain agent | `pip install langchain_core mem0ai` | For the general Python pattern (no framework), see the "Common integration pattern" in [SKILL.md](../SKILL.md). diff --git a/skills/mem0/references/quickstart.md b/skills/mem0/references/quickstart.md index c4afd7841..1e779a599 100644 --- a/skills/mem0/references/quickstart.md +++ b/skills/mem0/references/quickstart.md @@ -27,7 +27,7 @@ messages = [ client.add(messages, user_id="user123") # Search memories -results = client.search("What are my dietary restrictions?", user_id="user123") +results = client.search("What are my dietary restrictions?", filters={"user_id": "user123"}) print(results) ``` @@ -39,7 +39,7 @@ from mem0 import AsyncMemoryClient client = AsyncMemoryClient(api_key="your-api-key") await client.add(messages, user_id="user123") -results = await client.search("query", user_id="user123") +results = await client.search("query", filters={"user_id": "user123"}) ``` ## TypeScript / JavaScript Setup @@ -74,7 +74,7 @@ console.log(results); export MEM0_API_KEY="m0-your-api-key" # Add memory -curl -X POST https://api.mem0.ai/v1/memories/ \ +curl -X POST https://api.mem0.ai/v3/memories/add/ \ -H "Authorization: Token $MEM0_API_KEY" \ -H "Content-Type: application/json" \ -d '{ @@ -86,7 +86,7 @@ curl -X POST https://api.mem0.ai/v1/memories/ \ }' # Search memories -curl -X POST https://api.mem0.ai/v2/memories/search/ \ +curl -X POST https://api.mem0.ai/v3/memories/search/ \ -H "Authorization: Token $MEM0_API_KEY" \ -H "Content-Type: application/json" \ -d '{ @@ -97,6 +97,8 @@ curl -X POST https://api.mem0.ai/v2/memories/search/ \ ## Sample Response +`add()` is asynchronous and returns `{"event_id": "...", "status": "PENDING"}` (`eventId` on the TS client); poll `GET /v1/event/{event_id}/` until it is `SUCCEEDED`. A search returns: + ```json { "results": [ @@ -112,6 +114,8 @@ curl -X POST https://api.mem0.ai/v2/memories/search/ \ } ``` +The TS client returns the same fields camelCased (`userId`, `createdAt`). + ## Next Steps - [SDK Guide](sdk-guide.md) -- all methods for Python and TypeScript diff --git a/skills/mem0/references/sdk-guide.md b/skills/mem0/references/sdk-guide.md index 512c0d19c..33503d32a 100644 --- a/skills/mem0/references/sdk-guide.md +++ b/skills/mem0/references/sdk-guide.md @@ -24,7 +24,7 @@ import MemoryClient from 'mem0ai'; const client = new MemoryClient({ apiKey: 'm0-your-api-key' }); ``` -Constructor accepts `apiKey` (required) and `host` (optional, default: `https://api.mem0.ai`). +Constructor accepts `apiKey` (required in TypeScript; Python falls back to the `MEM0_API_KEY` env var) and `host` (optional, default: `https://api.mem0.ai`). --- @@ -58,6 +58,7 @@ await client.add(messages, { userId: "alice", metadata: { source: "onboarding" } | `run_id` | string | Session identifier | | `metadata` | object | Custom key-value pairs | | `infer` | boolean | If `false`, store raw text without inference (default: `true`) | +| `expiration_date` | string | `YYYY-MM-DD`, memory is hidden from search and get_all after this date | ### Advanced Add Options @@ -109,7 +110,10 @@ const results = await client.search("work experience", { | `filters` | object | Filter object (AND/OR operators). Use `{"user_id": "..."}` to filter by user | | `top_k` | number | Number of results (default: 10 for Platform) | | `rerank` | boolean | Enable reranking for better relevance (default: `false`) | -| `threshold` | number | Minimum similarity score (default: 0.1) | +| `threshold` | number | Server-side relevance cutoff (0 to 1), applied before score blending, so it is not a floor on the returned `score`. The default and `0.0` returned the same or nearly the same results in live tests | +| `reference_date` | string / number | Anchor for relative time queries such as "last week" (epoch, `YYYY-MM-DD`, or ISO datetime) | +| `show_expired` | boolean | Include memories past their `expiration_date` (default: `false`) | +| `latest_only` | boolean | Only return the latest version of a memory | ### Common Filter Patterns @@ -138,12 +142,11 @@ filters={"AND": [ ]} # Exclude categories with NOT -filters={"AND": [{"user_id": "user_123"}, {"NOT": {"categories": {"in": ["spam", "test"]}}}]} +filters={"AND": [{"user_id": "user_123"}, {"NOT": [{"categories": {"in": ["spam", "test"]}}]}]} # Multi-dimensional query filters={"AND": [ {"user_id": "user_123"}, - {"keywords": {"icontains": "invoice"}}, {"categories": {"in": ["finance"]}}, {"created_at": {"gte": "2024-01-01T00:00:00Z"}} ]} @@ -191,7 +194,7 @@ const memory = await client.get("ea925981-..."); const memories = await client.getAll({ filters: { user_id: "alice" } }); ``` -**Note:** `get_all` requires at least one of `user_id`, `agent_id`, `app_id`, or `run_id` in filters. +**Note:** `get_all` requires non-empty `filters`. Scope them with at least one of `user_id`, `agent_id`, `app_id`, or `run_id`. --- @@ -215,12 +218,14 @@ await client.update("ea925981-...", { text: "Updated: vegan since 2024" }); **Python:** ```python client.delete(memory_id="ea925981-...") +client.delete(memory_id="ea925981-...", delete_linked=True) client.delete_all(user_id="alice") # Irreversible bulk delete ``` **TypeScript:** ```typescript await client.delete("ea925981-..."); +await client.delete("ea925981-...", { deleteLinked: true }); await client.deleteAll({ userId: "alice" }); ``` @@ -231,7 +236,7 @@ await client.deleteAll({ userId: "alice" }); **Python:** ```python history = client.history(memory_id="ea925981-...") -# Returns: [{previous_value, new_value, action, timestamps}] +# Returns: [{id, memory_id, input, old_memory, new_memory, event, user_id, categories, metadata, created_at, updated_at}] ``` **TypeScript:** @@ -241,8 +246,19 @@ const history = await client.history("ea925981-..."); --- -## Batch Operations (TypeScript) +## Batch Operations +**Python:** +```python +client.batch_update([ + {"memory_id": "uuid-1", "text": "Updated text"}, + {"memory_id": "uuid-2", "text": "Another updated text"}, +]) + +client.batch_delete([{"memory_id": "uuid-1"}, {"memory_id": "uuid-2"}]) +``` + +**TypeScript:** ```typescript // Batch update await client.batchUpdate([ @@ -254,6 +270,8 @@ await client.batchUpdate([ await client.batchDelete(["uuid-1", "uuid-2", "uuid-3"]); ``` +Each batch update item must include `text`. `metadata` on an item is ignored and a metadata-only item returns a 400. + --- ## Additional Methods @@ -269,8 +287,14 @@ client.delete_users(user_id="alice") client.feedback(memory_id="...", feedback="POSITIVE", feedback_reason="Accurate extraction") # Export memories -export = client.create_memory_export(filters={"AND": [{"user_id": "alice"}]}) +export = client.create_memory_export( + schema={"type": "object", "properties": {"diet": {"type": "string"}}}, + filters={"AND": [{"user_id": "alice"}]}, +) data = client.get_memory_export(memory_export_id=export["id"]) + +profile = client.get_profile("alice") +client.generate_profile("alice") ``` --- @@ -281,8 +305,8 @@ data = client.get_memory_export(memory_export_id=export["id"]) 2. **SQL operators rejected** -- use `gte`, `lt`, etc. Not `>=`, `<`. 3. **Metadata filtering is limited** -- only top-level keys with `eq`, `contains`, `ne`. 4. **Wildcard `*` excludes null** -- only matches non-null values. -5. **Default threshold is 0.1** -- increase for stricter matching. -6. **Async processing** -- memories process asynchronously. Wait 2-3s after `add()` before searching. +5. **Threshold is a server-side cutoff** -- raise it to drop weak matches, but it is applied before score blending, so it is not a floor on the returned `score`. Filter on `score` client-side for a precise cutoff. +6. **Async processing** -- `add()` returns `{"event_id": ..., "status": "PENDING"}` (`eventId` on the TS client). Memories are searchable after the event is `SUCCEEDED` (poll `GET /v1/event/{event_id}/`, or wait a few seconds). `infer=False` is synchronous. ## Naming Conventions @@ -334,8 +358,8 @@ v3 TypeScript uses camelCase for all parameters: | Parameter | v2 Default | v3 Default | |-----------|------------|------------| -| `threshold` | 0.3 | 0.1 | -| `rerank` | (not specified) | `false` | +| `threshold` | 0.3 | server-side cutoff | +| `rerank` | `false` | `false` | **4. Removed Parameters** @@ -347,7 +371,6 @@ The following parameters are no longer supported: | `keyword_search` | Removed from search | | `filter_memories` | Removed | | `immutable` | Removed from add | -| `expiration_date` | Removed from add | | `includes` | Removed from add | | `excludes` | Removed from add | | `async_mode` | Removed from add | diff --git a/skills/mem0/references/use-cases.md b/skills/mem0/references/use-cases.md index 5f3ba655d..dbb514afa 100644 --- a/skills/mem0/references/use-cases.md +++ b/skills/mem0/references/use-cases.md @@ -30,7 +30,7 @@ openai_client = OpenAI() def chat(user_input: str, user_id: str) -> str: # 1. Retrieve relevant memories - memories = mem0.search(user_input, user_id=user_id) + memories = mem0.search(user_input, filters={"user_id": user_id}) context = "\n".join([f"- {m['memory']}" for m in memories.get("results", [])]) # 2. Generate response with memory context @@ -99,7 +99,7 @@ async function chat(userInput: string, userId: string): Promise { ### Key Benefits - Context persists across app restarts — no session management needed -- Memories are automatically deduplicated and updated +- Facts are extracted automatically and accumulate (ADD-only: nothing is overwritten or deleted) - Works with any LLM provider (OpenAI, Anthropic, etc.) **Best for:** Fitness coaches, tutors, therapists — any assistant that needs to remember goals across sessions. @@ -172,7 +172,7 @@ const client = new MemoryClient({ apiKey: process.env.MEM0_API_KEY! }); // Setup categories (one-time) await client.updateProject({ - custom_categories: [ + customCategories: [ { support_tickets: 'Customer issues and resolutions' }, { billing: 'Payment history and billing questions' }, { product_feedback: 'Feature requests and feedback' }, @@ -226,7 +226,7 @@ def save_patient_info(user_id: str, information: str): def consult(user_id: str, question: str) -> str: # High threshold for medical accuracy - memories = mem0.search(question, user_id=user_id, top_k=5, threshold=0.7) + memories = mem0.search(question, filters={"user_id": user_id}, top_k=5, threshold=0.7) context = "\n".join([f"- {m['memory']}" for m in memories.get("results", [])]) response = openai_client.chat.completions.create( @@ -295,7 +295,7 @@ async function consult(userId: string, question: string): Promise { ### Key Benefits -- High threshold (0.7) ensures only confident matches for safety-critical retrieval +- High threshold (0.7) drops weak matches for safety-critical retrieval (it is a server-side cutoff applied before score blending, so check `score` too) - Session scoping via `run_id` groups related health interactions - Metadata tagging separates patient info from conversation history @@ -384,7 +384,7 @@ async function draftContent(userId: string, topic: string): Promise { - Voice consistency across all content without repeating guidelines - Scoped sessions let you maintain different style profiles -- Preferences update automatically as you refine them +- Refined preferences are added alongside earlier ones (ADD-only), and retrieval ranks relevance **Best for:** Marketing teams, technical writers, agencies — consistent voice across all content. @@ -426,7 +426,7 @@ def search_user_session(query: str, user_id: str, app_id: str, run_id: str): ) def search_agent_knowledge(query: str, agent_id: str, app_id: str): - """Search all memories an agent has across all users.""" + """Search facts attributed to an agent (from its assistant messages) in an app.""" return client.search( query, filters={ @@ -449,7 +449,7 @@ store_scoped_memory( # User-scoped query: "What does Cam prefer?" user_mems = search_user_session("dietary restrictions?", "traveler_cam", "concierge_app", "tokyo-2025") -# Agent-scoped query: "What do all travelers prefer?" (across users) +# Agent-scoped query: facts attributed to the travel_planner agent, not user preferences agent_mems = search_agent_knowledge("common dietary restrictions?", "travel_planner", "concierge_app") ``` @@ -490,6 +490,7 @@ async function searchAgentKnowledge(query: string, agentId: string, appId: strin - Full isolation between users, agents, sessions, and apps - Query at any scope level — user, agent, session, or app-wide - No memory leakage between tenants +- When `add` gets both `user_id` and `agent_id`, each fact is attributed to its speaker (user messages carry `user_id`, assistant messages carry `agent_id`), so an `AND` of both ids returns nothing; use `OR` (see [entity-scoped memory](https://docs.mem0.ai/platform/features/entity-scoped-memory)) **Best for:** Multi-agent workflows, multi-tenant SaaS — proper isolation at every level. @@ -516,7 +517,7 @@ Extract dietary preferences, location, interests, and purchase history.""" def personalized_search(user_id: str, query: str, search_results: list) -> str: # Get user context from memory - memories = mem0.search(query, user_id=user_id, top_k=5) + memories = mem0.search(query, filters={"user_id": user_id}, top_k=5) user_context = "\n".join([f"- {m['memory']}" for m in memories.get("results", [])]) response = openai_client.chat.completions.create( @@ -599,7 +600,7 @@ def store_email(user_id: str, sender: str, subject: str, body: str, date: str): def search_emails(user_id: str, query: str): return client.search( query, - filters={"AND": [{"user_id": user_id}, {"categories": {"contains": "email"}}]}, + filters={"AND": [{"user_id": user_id}, {"metadata": {"email_type": "incoming"}}]}, top_k=10 ) @@ -608,7 +609,7 @@ def get_emails_from_sender(user_id: str, sender: str): filters={ "AND": [ {"user_id": user_id}, - {"metadata": {"contains": sender}} + {"metadata": {"sender": sender}} ] } ) @@ -637,7 +638,7 @@ async function storeEmail(userId: string, sender: string, subject: string, body: async function searchEmails(userId: string, query: string) { return client.search(query, { - filters: { AND: [{ user_id: userId }, { categories: { contains: 'email' } }] }, + filters: { AND: [{ user_id: userId }, { metadata: { email_type: 'incoming' } }] }, topK: 10, }); } @@ -646,7 +647,7 @@ async function searchEmails(userId: string, query: string) { ### Key Benefits - Rich metadata enables multi-dimensional queries (sender, date, subject) -- Category filtering separates emails from other memory types +- Metadata filtering (`email_type`) separates emails from other memory types - Semantic search across all email content **Best for:** Inbox management, email automation — searchable email memories with metadata filtering. @@ -661,7 +662,7 @@ Every use case follows the same 3-step loop: ```python # 1. Retrieve relevant context -memories = mem0.search(user_input, user_id=user_id) +memories = mem0.search(user_input, filters={"user_id": user_id}) context = "\n".join([m["memory"] for m in memories.get("results", [])]) # 2. Generate with context @@ -717,4 +718,4 @@ client.project.update( ## More Examples -For 30+ cookbooks with complete working code: [docs.mem0.ai/cookbooks](https://docs.mem0.ai/cookbooks) +For 30+ cookbooks with complete working code: [docs.mem0.ai/cookbooks/overview](https://docs.mem0.ai/cookbooks/overview) diff --git a/skills/mem0/scripts/mem0_doc_search.py b/skills/mem0/scripts/mem0_doc_search.py index a04c89afb..0457038b2 100755 --- a/skills/mem0/scripts/mem0_doc_search.py +++ b/skills/mem0/scripts/mem0_doc_search.py @@ -1,10 +1,10 @@ #!/usr/bin/env python3 """ -Mem0 Documentation Search Agent (Mintlify-based) +Mem0 Documentation Search Agent On-demand search tool for querying Mem0 documentation without storing content locally. -This tool leverages Mintlify's documentation structure to perform just-in-time -retrieval of technical information from docs.mem0.ai. +This tool searches the docs.mem0.ai llms.txt index and fetches pages as markdown +to perform just-in-time retrieval of technical information. Usage: python mem0_doc_search.py --query "how to add graph memory" @@ -20,137 +20,124 @@ Purpose: - Search across the full Mem0 documentation site """ +from __future__ import annotations + import argparse import json +import re import sys import urllib.error import urllib.parse import urllib.request DOCS_BASE = "https://docs.mem0.ai" -SEARCH_ENDPOINT = f"{DOCS_BASE}/api/search" +DOCS_HOST = urllib.parse.urlsplit(DOCS_BASE).netloc LLMS_INDEX = f"{DOCS_BASE}/llms.txt" +ENTRY_URL = re.compile(r"\((https?://[^)\s]+)\)") +MAX_RESULTS = 20 +MAX_PAGE_CHARS = 10000 +MAX_INDEX_BYTES = 2_000_000 -# Known documentation sections for targeted retrieval -SECTION_MAP = { - "platform": [ - "/platform/overview", - "/platform/quickstart", - "/platform/features", - "/platform/features/graph-memory", - "/platform/features/selective-memory", - "/platform/features/custom-categories", - "/platform/features/v2-memory-filters", - "/platform/features/async-client", - "/platform/features/webhooks", - "/platform/features/multimodal-support", - ], - "api": [ - "/api-reference/memory/add-memories", - "/api-reference/memory/v2-search-memories", - "/api-reference/memory/v2-get-memories", - "/api-reference/memory/get-memory", - "/api-reference/memory/update-memory", - "/api-reference/memory/delete-memory", - ], - "open-source": [ - "/open-source/overview", - "/open-source/python-quickstart", - "/open-source/node-quickstart", - "/open-source/features", - "/open-source/features/graph-memory", - "/open-source/features/rest-api", - "/open-source/configure-components", - ], - "sdks": [ - "/sdks/python", - "/sdks/js", - ], - "integrations": [ - "/integrations", - ], +SECTION_PREFIXES = { + "platform": ("/platform/",), + "api": ("/api-reference/",), + "open-source": ("/open-source/", "/components/"), + "integrations": ("/integrations",), } -def fetch_url(url: str) -> str: - """Fetch content from a URL.""" +def require_docs_url(url: str) -> None: + """Exit unless the URL is an https URL on the Mem0 docs host.""" + parts = urllib.parse.urlsplit(url) + if parts.scheme != "https" or parts.netloc != DOCS_HOST: + sys.exit(f"Refusing to fetch {url}: only {DOCS_BASE} is allowed") + + +class DocsRedirectHandler(urllib.request.HTTPRedirectHandler): + """Follow redirects only when they stay on the Mem0 docs host.""" + + def redirect_request(self, req, fp, code, msg, headers, newurl): + require_docs_url(newurl) + return super().redirect_request(req, fp, code, msg, headers, newurl) + + +def fetch_url(url: str, max_bytes: int) -> tuple[str, bool]: + """Fetch at most max_bytes from a docs URL, returning the text and whether it was cut short.""" + require_docs_url(url) + opener = urllib.request.build_opener(DocsRedirectHandler) req = urllib.request.Request(url, headers={"User-Agent": "Mem0DocSearchAgent/1.0"}) try: - with urllib.request.urlopen(req, timeout=15) as resp: - return resp.read().decode("utf-8") + with opener.open(req, timeout=15) as resp: + data = resp.read(max_bytes + 1) except urllib.error.HTTPError as e: - return f"HTTP Error {e.code}: {e.reason}" - except urllib.error.URLError as e: - return f"URL Error: {e.reason}" + sys.exit(f"Error fetching {url}: HTTP {e.code} {e.reason}") + except OSError as e: + sys.exit(f"Error fetching {url}: {e}") + return data[:max_bytes].decode("utf-8", errors="replace"), len(data) > max_bytes + + +def index_entries() -> list: + """Return the page entries listed in the llms.txt index.""" + content, truncated = fetch_url(LLMS_INDEX, MAX_INDEX_BYTES) + if truncated: + sys.exit(f"Error: {LLMS_INDEX} exceeds {MAX_INDEX_BYTES} bytes") + return [line.strip()[2:] for line in content.splitlines() if line.strip().startswith("- [")] + + +def entry_path(entry: str) -> str: + """Extract the URL path from an llms.txt index entry.""" + match = ENTRY_URL.search(entry) + return urllib.parse.urlparse(match.group(1)).path if match else "" def search_docs(query: str, section: str | None = None) -> dict: - """ - Search Mem0 documentation using Mintlify's search API. - Falls back to the llms.txt index for keyword matching if the API is unavailable. - """ - # Try Mintlify search API first - params = urllib.parse.urlencode({"query": query}) - search_url = f"{SEARCH_ENDPOINT}?{params}" + """Search the llms.txt index for entries matching the query terms, best matches first.""" + terms = re.findall(r"[a-z0-9_]+", query.lower()) + entries = index_entries() - try: - result = fetch_url(search_url) - data = json.loads(result) - if isinstance(data, dict) and data.get("results"): - results = data["results"] - if section and section in SECTION_MAP: - section_paths = SECTION_MAP[section] - results = [r for r in results if any(r.get("url", "").startswith(p) for p in section_paths)] - return {"source": "mintlify_search", "results": results} - except (json.JSONDecodeError, Exception): - pass + if section in SECTION_PREFIXES: + entries = [e for e in entries if entry_path(e).startswith(SECTION_PREFIXES[section])] - # Fallback: search llms.txt index for matching URLs - index_content = fetch_url(LLMS_INDEX) - query_lower = query.lower() - matching_urls = [] - - for line in index_content.splitlines(): - line = line.strip() - if not line or line.startswith("#"): - continue - if query_lower in line.lower(): - matching_urls.append(line) - - if section and section in SECTION_MAP: - section_paths = SECTION_MAP[section] - matching_urls = [u for u in matching_urls if any(p in u for p in section_paths)] + scored = [] + for entry in entries: + haystack = entry.lower() + title = haystack.split("]")[0] + score = sum((term in haystack) + (term in title) for term in terms) + if score: + scored.append((score, entry)) + scored.sort(key=lambda item: -item[0]) return { "source": "llms_txt_index", "query": query, - "matching_urls": matching_urls[:20], - "suggestion": "Fetch specific URLs for detailed content", + "matching_urls": [entry for _, entry in scored[:MAX_RESULTS]], + "suggestion": "Fetch specific pages with --page for detailed content", } def fetch_page(page_path: str) -> dict: - """Fetch a specific documentation page.""" - url = f"{DOCS_BASE}{page_path}" if page_path.startswith("/") else page_path - content = fetch_url(url) - return {"url": url, "content": content[:10000], "truncated": len(content) > 10000} + """Fetch a specific documentation page as markdown.""" + parts = urllib.parse.urlsplit(urllib.parse.urljoin(DOCS_BASE, page_path)) + path = parts.path.rstrip("/") + if not path.endswith(".md"): + path = f"{path}.md" + url = urllib.parse.urlunsplit((parts.scheme, parts.netloc, path, "", "")) + content, cut_short = fetch_url(url, MAX_PAGE_CHARS * 4) + return {"url": url, "content": content[:MAX_PAGE_CHARS], "truncated": cut_short or len(content) > MAX_PAGE_CHARS} def get_index() -> dict: """Fetch the full documentation index from llms.txt.""" - content = fetch_url(LLMS_INDEX) - urls = [line.strip() for line in content.splitlines() if line.strip() and not line.startswith("#")] - return {"total_pages": len(urls), "urls": urls, "sections": list(SECTION_MAP.keys())} + urls = index_entries() + return {"total_pages": len(urls), "urls": urls, "sections": list(SECTION_PREFIXES)} def list_section(section: str) -> dict: - """List all known pages in a documentation section.""" - if section not in SECTION_MAP: - return {"error": f"Unknown section: {section}", "available": list(SECTION_MAP.keys())} - return { - "section": section, - "pages": [f"{DOCS_BASE}{p}" for p in SECTION_MAP[section]], - } + """List the llms.txt index entries in a documentation section.""" + if section not in SECTION_PREFIXES: + return {"error": f"Unknown section: {section}", "available": list(SECTION_PREFIXES)} + pages = [e for e in index_entries() if entry_path(e).startswith(SECTION_PREFIXES[section])] + return {"section": section, "pages": pages} def main(): @@ -206,7 +193,7 @@ def main(): elif "content" in result: print(f"URL: {result['url']}") if result.get("truncated"): - print("[Content truncated to 10000 chars]") + print(f"[Content truncated to {MAX_PAGE_CHARS} chars]") print(result["content"]) elif "error" in result: print(f"Error: {result['error']}") From d26ba5e4518cef7fff3c66d4f715b21adf9feabe Mon Sep 17 00:00:00 2001 From: Kartik Date: Mon, 12 Oct 2026 21:58:27 +0530 Subject: [PATCH 47/55] fix(client): reject empty entity IDs and filters in add and delete_all (#7581) --- .../memory-operations/delete.mdx | 4 + docs/platform/features/async-client.mdx | 2 +- .../platform/features/custom-instructions.mdx | 2 +- mem0-ts/src/client/mem0.ts | 32 +++ .../tests/memoryClient.entityGuards.test.ts | 234 ++++++++++++++++++ mem0/client/main.py | 49 +++- mem0/client/types.py | 39 ++- mem0/proxy/main.py | 5 +- tests/test_client.py | 6 +- tests/test_client_entity_guards.py | 198 +++++++++++++++ tests/test_proxy.py | 19 ++ 11 files changed, 548 insertions(+), 42 deletions(-) create mode 100644 mem0-ts/src/client/tests/memoryClient.entityGuards.test.ts create mode 100644 tests/test_client_entity_guards.py diff --git a/docs/core-concepts/memory-operations/delete.mdx b/docs/core-concepts/memory-operations/delete.mdx index eb8f4c8c9..ddd86a8e3 100644 --- a/docs/core-concepts/memory-operations/delete.mdx +++ b/docs/core-concepts/memory-operations/delete.mdx @@ -137,6 +137,10 @@ You can also filter by other parameters such as: **Breaking change:** `delete_all` previously wiped all project memories when called with no filters. It now **raises an error** if no filters are provided. Use `"*"` wildcards for intentional bulk deletion (see below). + + Pass entity IDs as top-level arguments (`user_id="alice"` or `userId: "alice"`). `delete_all` does not accept `filters`. An empty or whitespace-only ID such as `user_id=""` matches every memory in the project, so the SDKs raise an error before sending the request. `delete_users` and `deleteUsers` apply the same check. + + ### Wildcard deletes Setting a filter to `"*"` deletes **all memories** for that entity type across the entire project. This is an intentionally explicit opt-in to bulk deletion. diff --git a/docs/platform/features/async-client.mdx b/docs/platform/features/async-client.mdx index 6effd9995..964fb1ce5 100644 --- a/docs/platform/features/async-client.mdx +++ b/docs/platform/features/async-client.mdx @@ -124,7 +124,7 @@ await client.deleteAll({ userId: "alice" }); - At least one filter (`user_id`, `agent_id`, `app_id`, or `run_id`) is required: calling `delete_all` with no filters raises an error to prevent accidental data loss. You can pass `"*"` as a value to delete all memories for a given entity type (e.g., `user_id="*"` removes memories for every user). A full project wipe requires all four filters set to `"*"`. When multiple entity filters are combined on a single `delete_all` call, only one is currently guaranteed to be honored; scope each call to a single entity id to be safe. + At least one filter (`user_id`, `agent_id`, `app_id`, or `run_id`) is required: calling `delete_all` with no filters raises an error to prevent accidental data loss. You can pass `"*"` as a value to delete all memories for a given entity type (e.g., `user_id="*"` removes memories for every user). A full project wipe requires all four filters set to `"*"`. When multiple entity filters are combined on a single `delete_all` call, only one is currently guaranteed to be honored; scope each call to a single entity id to be safe. Entity IDs are top-level arguments, not `filters`, and an empty or whitespace-only ID raises an error instead of matching every memory. ### History diff --git a/docs/platform/features/custom-instructions.mdx b/docs/platform/features/custom-instructions.mdx index 8b5b1f35e..9acd741f2 100644 --- a/docs/platform/features/custom-instructions.mdx +++ b/docs/platform/features/custom-instructions.mdx @@ -153,7 +153,7 @@ Both fields are also accepted per request, overriding the project setting for th ```python Python client.add( messages, - filters={"agent_id": "support-agent"}, + agent_id="support-agent", agent_custom_instructions="Only remember which tools errored and why.", ) ``` diff --git a/mem0-ts/src/client/mem0.ts b/mem0-ts/src/client/mem0.ts index 0f8725164..c386be323 100644 --- a/mem0-ts/src/client/mem0.ts +++ b/mem0-ts/src/client/mem0.ts @@ -74,6 +74,34 @@ function rejectTopLevelEntityParams( } } +function rejectFilters( + options: Record | undefined, + methodName: string, +): void { + if (options?.filters != null) { + throw new Error( + `filters is not supported in ${methodName}(). ` + + `Pass entity IDs at the top level, e.g. userId: "...".`, + ); + } +} + +/** Throws on an empty entity ID, which the API treats as matching every memory. */ +function rejectBlankEntityIds(options: Record | undefined): void { + for (const [key, value] of Object.entries(options ?? {})) { + if ( + ENTITY_PARAMS.includes(key) && + typeof value === "string" && + value.trim() === "" + ) { + throw new Error( + `${key} cannot be empty or whitespace-only: an empty ID would match every memory in the project. ` + + `To delete everything on purpose, call deleteAll() with "*" explicitly.`, + ); + } + } +} + function encodePathSegment(value: unknown): string { return encodeURIComponent(String(value)); } @@ -396,6 +424,7 @@ export default class MemoryClient { if (!messages || (Array.isArray(messages) && messages.length === 0)) { throw new Error("Cannot process an empty messages payload."); } + rejectFilters(options, "add"); const payload = this._preparePayload(messages, options); const payloadKeys = Object.keys(payload); @@ -540,6 +569,8 @@ export default class MemoryClient { async deleteAll( options: DeleteAllMemoryOptions = {}, ): Promise<{ message: string }> { + rejectFilters(options, "deleteAll"); + rejectBlankEntityIds(options); const payloadKeys = Object.keys(options || {}); this._captureEvent("delete_all", [payloadKeys]); const snakeOptions = camelToSnakeKeys(this._prepareParams(options)); @@ -611,6 +642,7 @@ export default class MemoryClient { runId?: string; } = {}, ): Promise<{ message: string }> { + rejectBlankEntityIds(params); let to_delete: Array<{ type: string; name: string }> = []; const { userId, agentId, appId, runId } = params; diff --git a/mem0-ts/src/client/tests/memoryClient.entityGuards.test.ts b/mem0-ts/src/client/tests/memoryClient.entityGuards.test.ts new file mode 100644 index 000000000..463284852 --- /dev/null +++ b/mem0-ts/src/client/tests/memoryClient.entityGuards.test.ts @@ -0,0 +1,234 @@ +/** MemoryClient unit tests for entity ID handling in add, deleteAll, and deleteUsers. */ +import { MemoryClient } from "../mem0"; +import { createMockAllUsers, createMockUser, TEST_API_KEY } from "./helpers"; +import { + setupMockFetch, + findFetchCall, + getFetchBody, + installConsoleSuppression, +} from "./setup"; + +installConsoleSuppression(); + +const BLANK_IDS = ["", " ", "\t\n"]; +const ENTITY_KEYS = [ + "userId", + "agentId", + "appId", + "runId", + "user_id", + "agent_id", + "app_id", + "run_id", +]; + +function mockDeleteAll() { + const extra = new Map(); + extra.set("/v1/memories/", { status: 200, body: { message: "Deleted" } }); + return setupMockFetch(extra); +} + +describe("MemoryClient - deleteAll() blank entity IDs", () => { + test.each( + ENTITY_KEYS.flatMap((key) => BLANK_IDS.map((blank) => [key, blank])), + )("rejects %s=%j without sending a request", async (key, blank) => { + const mock = mockDeleteAll(); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await expect(client.deleteAll({ [key]: blank } as never)).rejects.toThrow( + key, + ); + + expect(findFetchCall(mock, "/v1/memories/", "DELETE")).toBeUndefined(); + }); + + test("rejects a blank ID next to a valid ID", async () => { + const mock = mockDeleteAll(); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await expect( + client.deleteAll({ userId: "u1", agentId: "" }), + ).rejects.toThrow("agentId"); + + expect(findFetchCall(mock, "/v1/memories/", "DELETE")).toBeUndefined(); + }); + + test("error explains the risk and the wildcard", async () => { + mockDeleteAll(); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await expect(client.deleteAll({ userId: "" })).rejects.toThrow( + /every memory in the project.*"\*"/, + ); + }); +}); + +describe("MemoryClient - deleteAll() valid inputs", () => { + test("sends the entity ID as a query param", async () => { + const mock = mockDeleteAll(); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await client.deleteAll({ userId: "u1" }); + + const call = findFetchCall(mock, "/v1/memories/?", "DELETE"); + expect(call![0]).toContain("user_id=u1"); + }); + + test("still allows the explicit wildcard", async () => { + const mock = mockDeleteAll(); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await client.deleteAll({ userId: "*" }); + + const call = findFetchCall(mock, "/v1/memories/?", "DELETE"); + expect(call![0]).toContain("user_id=*"); + }); + + test("ignores undefined entity IDs", async () => { + const mock = mockDeleteAll(); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await client.deleteAll({ userId: "u1", agentId: undefined }); + + const call = findFetchCall(mock, "/v1/memories/?", "DELETE"); + expect(call![0]).not.toContain("agent_id"); + }); +}); + +describe("MemoryClient - deleteAll() rejects filters", () => { + test("throws and sends no request", async () => { + const mock = mockDeleteAll(); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await expect( + client.deleteAll({ filters: { user_id: "u1" } } as never), + ).rejects.toThrow(/filters.*userId/); + + expect(findFetchCall(mock, "/v1/memories/", "DELETE")).toBeUndefined(); + }); +}); + +describe("MemoryClient - deleteUsers() blank entity IDs", () => { + test.each( + ["userId", "agentId", "appId", "runId"].flatMap((key) => + BLANK_IDS.map((blank) => [key, blank]), + ), + )("rejects %s=%j before any request", async (key, blank) => { + const extra = new Map(); + extra.set("/v1/entities/", { + status: 200, + body: createMockAllUsers([createMockUser()]), + }); + const mock = setupMockFetch(extra); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await expect(client.deleteUsers({ [key]: blank })).rejects.toThrow(key); + + expect(findFetchCall(mock, "/v1/entities/")).toBeUndefined(); + expect(findFetchCall(mock, "/v2/entities/", "DELETE")).toBeUndefined(); + }); +}); + +describe("MemoryClient - deleteUsers() valid inputs", () => { + test("deletes the named entity", async () => { + const extra = new Map(); + extra.set("/v2/entities/user/u1/", { + status: 200, + body: { message: "ok" }, + }); + const mock = setupMockFetch(extra); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await client.deleteUsers({ userId: "u1" }); + + expect( + findFetchCall(mock, "/v2/entities/user/u1/", "DELETE"), + ).toBeDefined(); + }); + + test("with no IDs still deletes every listed entity", async () => { + const extra = new Map(); + extra.set("/v1/entities/", { + status: 200, + body: createMockAllUsers([ + createMockUser({ name: "u1", type: "user" }), + createMockUser({ name: "a1", type: "agent" }), + ]), + }); + extra.set("/v2/entities/user/u1/", { + status: 200, + body: { message: "ok" }, + }); + extra.set("/v2/entities/agent/a1/", { + status: 200, + body: { message: "ok" }, + }); + const mock = setupMockFetch(extra); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await client.deleteUsers(); + + expect( + findFetchCall(mock, "/v2/entities/user/u1/", "DELETE"), + ).toBeDefined(); + expect( + findFetchCall(mock, "/v2/entities/agent/a1/", "DELETE"), + ).toBeDefined(); + }); +}); + +describe("MemoryClient - add() entity IDs", () => { + function mockAdd() { + const extra = new Map(); + extra.set("/v3/memories/add/", { status: 200, body: [] }); + return setupMockFetch(extra); + } + + test("rejects filters and sends no request", async () => { + const mock = mockAdd(); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await expect( + client.add([{ role: "user", content: "hi" }], { + filters: { user_id: "u1" }, + }), + ).rejects.toThrow(/filters.*userId/); + + expect(findFetchCall(mock, "/v3/memories/add/", "POST")).toBeUndefined(); + }); + + test("treats filters: undefined as not provided", async () => { + const mock = mockAdd(); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await client.add([{ role: "user", content: "hi" }], { + userId: "u1", + filters: undefined, + }); + + const call = findFetchCall(mock, "/v3/memories/add/", "POST"); + expect(getFetchBody(call!).user_id).toBe("u1"); + }); + + test("sends top-level entity IDs in the body", async () => { + const mock = mockAdd(); + const client = new MemoryClient({ apiKey: TEST_API_KEY }); + + await client.add([{ role: "user", content: "hi" }], { + userId: "u1", + agentId: "a1", + appId: "p1", + runId: "r1", + }); + + const body = getFetchBody( + findFetchCall(mock, "/v3/memories/add/", "POST")!, + ); + expect(body).toMatchObject({ + user_id: "u1", + agent_id: "a1", + app_id: "p1", + run_id: "r1", + }); + }); +}); diff --git a/mem0/client/main.py b/mem0/client/main.py index d65d4f0b1..18896466a 100644 --- a/mem0/client/main.py +++ b/mem0/client/main.py @@ -91,6 +91,24 @@ def _encode_path_segment(value: Any) -> str: return quote(str(value), safe="") +def _reject_filters(method: str, params: Dict[str, Any]) -> None: + """Raise when filters is passed to an endpoint that reads entity IDs at the top level.""" + if params.get("filters") is not None: + raise ValueError( + f"filters is not supported in {method}(). Pass entity IDs at the top level, e.g. user_id='...'." + ) + + +def _reject_blank_entity_ids(params: Dict[str, Any]) -> None: + """Raise on an empty or whitespace-only entity ID, which the API treats as matching every memory.""" + for name, value in params.items(): + if name in ENTITY_PARAMS and isinstance(value, str) and not value.strip(): + raise ValueError( + f"{name} cannot be empty or whitespace-only: an empty ID would match every memory in the project. " + f"To delete everything on purpose, call delete_all() with '*' explicitly." + ) + + def _maybe_alias_anon_to_email(user_email): """Fire $identify per prior anon ID so PostHog merges them into email. @@ -309,7 +327,7 @@ class MemoryClient: a user message. options: Typed options for the add operation (AddMemoryOptions). **kwargs: Additional parameters such as user_id, agent_id, app_id, - metadata, filters. + run_id, metadata. Entity IDs go at the top level, not in filters. Returns: A dictionary containing the API response in v1.1 format. @@ -321,8 +339,10 @@ class MemoryClient: MemoryQuotaExceededError: If memory quota is exceeded. NetworkError: If network connectivity issues occur. MemoryNotFoundError: If the memory doesn't exist (for updates/deletes). + ValueError: If filters is passed. """ kwargs = {**(options.model_dump(exclude_unset=True) if options else {}), **kwargs} + _reject_filters("add", kwargs) # Handle different message input formats (align with OSS behavior) if isinstance(messages, str): messages = [{"role": "user", "content": messages}] @@ -533,12 +553,12 @@ class MemoryClient: @api_error_handler def delete_all(self, options: Optional[DeleteAllMemoryOptions] = None, **kwargs) -> Dict[str, str]: - """Delete all memories, with optional filtering. + """Delete all memories for the given entity IDs. Args: options: Typed options for the delete_all operation (DeleteAllMemoryOptions). - **kwargs: Optional parameters for filtering (user_id, agent_id, - app_id). + **kwargs: Entity IDs to delete memories for (user_id, agent_id, app_id, run_id). + Pass '*' to target every entity of that type. Returns: A dictionary containing the API response. @@ -550,8 +570,11 @@ class MemoryClient: MemoryQuotaExceededError: If memory quota is exceeded. NetworkError: If network connectivity issues occur. MemoryNotFoundError: If the memory doesn't exist (for updates/deletes). + ValueError: If filters is passed or an entity ID is empty or whitespace-only. """ kwargs = {**(options.model_dump(exclude_unset=True) if options else {}), **kwargs} + _reject_filters("delete_all", kwargs) + _reject_blank_entity_ids(kwargs) params = self._prepare_params(kwargs) response = self.client.delete("/v1/memories/", params=params) response.raise_for_status() @@ -615,12 +638,13 @@ class MemoryClient: Dict with success message Raises: - ValueError: If specified entity not found + ValueError: If specified entity not found or an entity ID is empty or whitespace-only ValidationError: If the input data is invalid. AuthenticationError: If authentication fails. MemoryNotFoundError: If the entity doesn't exist. NetworkError: If network connectivity issues occur. """ + _reject_blank_entity_ids({"user_id": user_id, "agent_id": agent_id, "app_id": app_id, "run_id": run_id}) if user_id: to_delete = [{"type": "user", "name": user_id}] @@ -1404,7 +1428,7 @@ class AsyncMemoryClient: a user message. options: Typed options for the add operation (AddMemoryOptions). **kwargs: Additional parameters such as user_id, agent_id, app_id, - metadata, filters. + run_id, metadata. Entity IDs go at the top level, not in filters. Returns: A dictionary containing the API response in v1.1 format. @@ -1416,8 +1440,10 @@ class AsyncMemoryClient: MemoryQuotaExceededError: If memory quota is exceeded. NetworkError: If network connectivity issues occur. MemoryNotFoundError: If the memory doesn't exist (for updates/deletes). + ValueError: If filters is passed. """ kwargs = {**(options.model_dump(exclude_unset=True) if options else {}), **kwargs} + _reject_filters("add", kwargs) # Handle different message input formats (align with OSS behavior) if isinstance(messages, str): messages = [{"role": "user", "content": messages}] @@ -1614,11 +1640,12 @@ class AsyncMemoryClient: @api_error_handler async def delete_all(self, options: Optional[DeleteAllMemoryOptions] = None, **kwargs) -> Dict[str, str]: - """Delete all memories, with optional filtering. + """Delete all memories for the given entity IDs. Args: options: Typed options for the delete_all operation (DeleteAllMemoryOptions). - **kwargs: Optional parameters for filtering (user_id, agent_id, app_id). + **kwargs: Entity IDs to delete memories for (user_id, agent_id, app_id, run_id). + Pass '*' to target every entity of that type. Returns: A dictionary containing the API response. @@ -1630,8 +1657,11 @@ class AsyncMemoryClient: MemoryQuotaExceededError: If memory quota is exceeded. NetworkError: If network connectivity issues occur. MemoryNotFoundError: If the memory doesn't exist (for updates/deletes). + ValueError: If filters is passed or an entity ID is empty or whitespace-only. """ kwargs = {**(options.model_dump(exclude_unset=True) if options else {}), **kwargs} + _reject_filters("delete_all", kwargs) + _reject_blank_entity_ids(kwargs) params = self._prepare_params(kwargs) response = await self.async_client.delete("/v1/memories/", params=params) response.raise_for_status() @@ -1694,12 +1724,13 @@ class AsyncMemoryClient: Dict with success message Raises: - ValueError: If specified entity not found + ValueError: If specified entity not found or an entity ID is empty or whitespace-only ValidationError: If the input data is invalid. AuthenticationError: If authentication fails. MemoryNotFoundError: If the entity doesn't exist. NetworkError: If network connectivity issues occur. """ + _reject_blank_entity_ids({"user_id": user_id, "agent_id": agent_id, "app_id": app_id, "run_id": run_id}) if user_id: to_delete = [{"type": "user", "name": user_id}] diff --git a/mem0/client/types.py b/mem0/client/types.py index 5663dcf5d..5d88b821f 100644 --- a/mem0/client/types.py +++ b/mem0/client/types.py @@ -1,11 +1,4 @@ -"""Pydantic option models for MemoryClient methods. - -These models provide IDE autocompletion, runtime validation, and type safety. -Methods accept both typed options and **kwargs for backward compatibility. - -Identity fields (user_id, agent_id, app_id, run_id) must be passed inside -the ``filters`` dict — the v3 API does not accept them at the top level. -""" +"""Pydantic option models for MemoryClient methods.""" from typing import Any, Dict, List, Optional, Union @@ -13,15 +6,12 @@ from pydantic import BaseModel, Field class AddMemoryOptions(BaseModel): - """Options for the add() method. + """Options for the add() method, with entity IDs passed at the top level.""" - Identity fields (user_id, agent_id, app_id, run_id) must be passed inside - the ``filters`` dict — the v3 API does not accept them at the top level. - """ - - filters: Optional[Dict[str, Any]] = Field( - default=None, description="Filters containing entity IDs (e.g. {'user_id': '...'})" - ) + user_id: Optional[str] = Field(default=None, description="User the memory belongs to") + agent_id: Optional[str] = Field(default=None, description="Agent the memory belongs to") + app_id: Optional[str] = Field(default=None, description="App the memory belongs to") + run_id: Optional[str] = Field(default=None, description="Run the memory belongs to") metadata: Optional[Dict[str, Any]] = Field(default=None, description="Additional metadata for the memory") infer: Optional[bool] = Field(default=None, description="Whether to infer memories from the input") custom_categories: Optional[List[Dict[str, Any]]] = Field( @@ -86,15 +76,12 @@ class GetAllMemoryOptions(BaseModel): class DeleteAllMemoryOptions(BaseModel): - """Options for the delete_all() method. + """Options for the delete_all() method, with entity IDs passed at the top level.""" - Identity fields (user_id, agent_id, app_id, run_id) must be passed inside - the ``filters`` dict — the API does not accept them at the top level. - """ - - filters: Optional[Dict[str, Any]] = Field( - default=None, description="Filters containing entity IDs (e.g. {'user_id': '...'})" - ) + user_id: Optional[str] = Field(default=None, description="Delete memories belonging to this user") + agent_id: Optional[str] = Field(default=None, description="Delete memories belonging to this agent") + app_id: Optional[str] = Field(default=None, description="Delete memories belonging to this app") + run_id: Optional[str] = Field(default=None, description="Delete memories belonging to this run") class UpdateMemoryOptions(BaseModel): @@ -103,7 +90,9 @@ class UpdateMemoryOptions(BaseModel): text: Optional[str] = Field(default=None, description="New text content for the memory") metadata: Optional[Dict[str, Any]] = Field(default=None, description="Updated metadata") timestamp: Optional[Union[int, float, str]] = Field(default=None, description="Updated timestamp") - expiration_date: Optional[str] = Field(default=None, description="Expiration date in YYYY-MM-DD format, or None to clear") + expiration_date: Optional[str] = Field( + default=None, description="Expiration date in YYYY-MM-DD format, or None to clear" + ) class ProjectUpdateOptions(BaseModel): diff --git a/mem0/proxy/main.py b/mem0/proxy/main.py index 167bc3f58..5806fca74 100644 --- a/mem0/proxy/main.py +++ b/mem0/proxy/main.py @@ -99,7 +99,7 @@ class Completions: prepared_messages = self._prepare_messages(messages) if prepared_messages[-1]["role"] == "user": - self._async_add_to_memory(messages, user_id, agent_id, run_id, metadata, filters) + self._async_add_to_memory(messages, user_id, agent_id, run_id, metadata) relevant_memories = self._fetch_relevant_memories(messages, user_id, agent_id, run_id, filters, top_k) logger.debug(f"Retrieved {len(relevant_memories)} relevant memories") prepared_messages[-1]["content"] = self._format_query_with_memories(messages, relevant_memories) @@ -146,7 +146,7 @@ class Completions: return [{"role": "system", "content": MEMORY_ANSWER_PROMPT}] + messages return messages - def _async_add_to_memory(self, messages, user_id, agent_id, run_id, metadata, filters): + def _async_add_to_memory(self, messages, user_id, agent_id, run_id, metadata): def add_task(): logger.debug("Adding to memory asynchronously") self.mem0_client.add( @@ -155,7 +155,6 @@ class Completions: agent_id=agent_id, run_id=run_id, metadata=metadata, - filters=filters, ) threading.Thread(target=add_task, daemon=True).start() diff --git a/tests/test_client.py b/tests/test_client.py index 07fc2052b..138b8a97d 100644 --- a/tests/test_client.py +++ b/tests/test_client.py @@ -602,7 +602,7 @@ class TestAddAgentCustomInstructions: mock_memory_client.add( "hello", - filters={"agent_id": "a1"}, + agent_id="a1", agent_custom_instructions="remember tool failures", ) @@ -617,7 +617,7 @@ class TestAddAgentCustomInstructions: mock_memory_client.add( "hello", AddMemoryOptions( - filters={"agent_id": "a1"}, + agent_id="a1", agent_custom_instructions="remember tool failures", ), ) @@ -629,7 +629,7 @@ class TestAddAgentCustomInstructions: """Callers that don't use the feature send an unchanged payload.""" self._mock_add(mock_memory_client) - mock_memory_client.add("hello", filters={"user_id": "u1"}) + mock_memory_client.add("hello", user_id="u1") _, kwargs = mock_memory_client.client.post.call_args assert "agent_custom_instructions" not in kwargs["json"] diff --git a/tests/test_client_entity_guards.py b/tests/test_client_entity_guards.py new file mode 100644 index 000000000..28bef2a75 --- /dev/null +++ b/tests/test_client_entity_guards.py @@ -0,0 +1,198 @@ +"""Tests for entity ID handling in MemoryClient add, delete_all, and delete_users.""" + +import asyncio +from unittest.mock import AsyncMock, MagicMock, patch + +import pytest + +from mem0.client.main import AsyncMemoryClient, MemoryClient +from mem0.client.types import AddMemoryOptions, DeleteAllMemoryOptions + +ENTITY_FIELDS = ["user_id", "agent_id", "app_id", "run_id"] +BLANK_IDS = ["", " ", "\t\n"] + + +def _ok_response(body=None): + response = MagicMock() + response.json.return_value = body if body is not None else {"message": "ok"} + response.raise_for_status.return_value = None + return response + + +@pytest.fixture +def sync_client(): + client = MemoryClient.__new__(MemoryClient) + client.client = MagicMock() + client.client.post.return_value = _ok_response() + client.client.delete.return_value = _ok_response() + with patch("mem0.client.main.capture_client_event"): + yield client + + +@pytest.fixture +def async_client(): + client = AsyncMemoryClient.__new__(AsyncMemoryClient) + client.async_client = MagicMock() + client.async_client.post = AsyncMock(return_value=_ok_response()) + client.async_client.delete = AsyncMock(return_value=_ok_response()) + with patch("mem0.client.main.capture_client_event"): + yield client + + +class TestDeleteAllBlankEntityIds: + @pytest.mark.parametrize("field", ENTITY_FIELDS) + @pytest.mark.parametrize("blank", BLANK_IDS) + def test_sync_raises_without_http_call(self, sync_client, field, blank): + with pytest.raises(ValueError, match=field): + sync_client.delete_all(**{field: blank}) + + sync_client.client.delete.assert_not_called() + + @pytest.mark.parametrize("field", ENTITY_FIELDS) + @pytest.mark.parametrize("blank", BLANK_IDS) + def test_async_raises_without_http_call(self, async_client, field, blank): + with pytest.raises(ValueError, match=field): + asyncio.run(async_client.delete_all(**{field: blank})) + + async_client.async_client.delete.assert_not_called() + + def test_blank_id_next_to_valid_id_still_raises(self, sync_client): + with pytest.raises(ValueError, match="agent_id"): + sync_client.delete_all(user_id="u1", agent_id="") + + sync_client.client.delete.assert_not_called() + + def test_blank_id_in_typed_options_raises(self, sync_client): + with pytest.raises(ValueError, match="user_id"): + sync_client.delete_all(DeleteAllMemoryOptions(user_id=" ")) + + sync_client.client.delete.assert_not_called() + + def test_error_explains_the_risk_and_the_wildcard(self, sync_client): + with pytest.raises(ValueError) as exc_info: + sync_client.delete_all(user_id="") + + message = str(exc_info.value) + assert "every memory in the project" in message + assert "'*'" in message + + +class TestDeleteAllValidInputs: + def test_sync_sends_entity_id_as_query_param(self, sync_client): + sync_client.delete_all(user_id="u1") + + sync_client.client.delete.assert_called_once_with("/v1/memories/", params={"user_id": "u1"}) + + def test_async_sends_entity_id_as_query_param(self, async_client): + asyncio.run(async_client.delete_all(user_id="u1")) + + async_client.async_client.delete.assert_called_once_with("/v1/memories/", params={"user_id": "u1"}) + + def test_typed_options_send_entity_id_as_query_param(self, sync_client): + sync_client.delete_all(DeleteAllMemoryOptions(user_id="u1")) + + sync_client.client.delete.assert_called_once_with("/v1/memories/", params={"user_id": "u1"}) + + def test_wildcard_is_still_allowed(self, sync_client): + sync_client.delete_all(user_id="*") + + sync_client.client.delete.assert_called_once_with("/v1/memories/", params={"user_id": "*"}) + + +class TestDeleteAllRejectsFilters: + def test_sync_raises_without_http_call(self, sync_client): + with pytest.raises(ValueError, match="filters"): + sync_client.delete_all(filters={"user_id": "u1"}) + + sync_client.client.delete.assert_not_called() + + def test_async_raises_without_http_call(self, async_client): + with pytest.raises(ValueError, match="filters"): + asyncio.run(async_client.delete_all(filters={"user_id": "u1"})) + + async_client.async_client.delete.assert_not_called() + + +class TestDeleteUsersBlankEntityIds: + @pytest.mark.parametrize("field", ENTITY_FIELDS) + @pytest.mark.parametrize("blank", BLANK_IDS) + def test_sync_raises_before_any_request(self, sync_client, field, blank): + with patch.object(sync_client, "users") as users: + with pytest.raises(ValueError, match=field): + sync_client.delete_users(**{field: blank}) + + users.assert_not_called() + sync_client.client.delete.assert_not_called() + + @pytest.mark.parametrize("field", ENTITY_FIELDS) + @pytest.mark.parametrize("blank", BLANK_IDS) + def test_async_raises_before_any_request(self, async_client, field, blank): + with patch.object(async_client, "users", new=AsyncMock()) as users: + with pytest.raises(ValueError, match=field): + asyncio.run(async_client.delete_users(**{field: blank})) + + users.assert_not_called() + async_client.async_client.delete.assert_not_called() + + +class TestDeleteUsersValidInputs: + def test_sync_deletes_the_named_entity(self, sync_client): + sync_client.delete_users(user_id="u1") + + sync_client.client.delete.assert_called_once_with("/v2/entities/user/u1/", params={}) + + def test_async_deletes_the_named_entity(self, async_client): + asyncio.run(async_client.delete_users(user_id="u1")) + + async_client.async_client.delete.assert_called_once_with("/v2/entities/user/u1/", params={}) + + def test_no_ids_still_deletes_every_listed_entity(self, sync_client): + listing = {"results": [{"type": "user", "name": "u1"}, {"type": "agent", "name": "a1"}]} + + with patch.object(sync_client, "users", return_value=listing): + sync_client.delete_users() + + deleted_paths = [call.args[0] for call in sync_client.client.delete.call_args_list] + assert deleted_paths == ["/v2/entities/user/u1/", "/v2/entities/agent/a1/"] + + +class TestAddEntityIds: + def test_sync_rejects_filters_without_http_call(self, sync_client): + with pytest.raises(ValueError, match="user_id"): + sync_client.add("hello", filters={"user_id": "u1"}) + + sync_client.client.post.assert_not_called() + + def test_async_rejects_filters_without_http_call(self, async_client): + with pytest.raises(ValueError, match="user_id"): + asyncio.run(async_client.add("hello", filters={"user_id": "u1"})) + + async_client.async_client.post.assert_not_called() + + def test_filters_none_is_treated_as_not_provided(self, sync_client): + sync_client.add("hello", user_id="u1", filters=None) + + payload = sync_client.client.post.call_args.kwargs["json"] + assert payload["user_id"] == "u1" + assert "filters" not in payload + + def test_sync_typed_options_put_entity_ids_in_payload(self, sync_client): + sync_client.add("hello", AddMemoryOptions(user_id="u1", agent_id="a1", app_id="p1", run_id="r1")) + + payload = sync_client.client.post.call_args.kwargs["json"] + assert payload["user_id"] == "u1" + assert payload["agent_id"] == "a1" + assert payload["app_id"] == "p1" + assert payload["run_id"] == "r1" + + def test_async_typed_options_put_entity_ids_in_payload(self, async_client): + asyncio.run(async_client.add("hello", AddMemoryOptions(user_id="u1"))) + + payload = async_client.async_client.post.call_args.kwargs["json"] + assert payload["user_id"] == "u1" + + def test_kwargs_put_entity_ids_in_payload(self, sync_client): + sync_client.add("hello", user_id="u1") + + payload = sync_client.client.post.call_args.kwargs["json"] + assert payload["user_id"] == "u1" diff --git a/tests/test_proxy.py b/tests/test_proxy.py index 8e48a4c6d..26209695e 100644 --- a/tests/test_proxy.py +++ b/tests/test_proxy.py @@ -86,6 +86,25 @@ def test_completions_create(mock_memory_client, mock_litellm): assert response == {"choices": [{"message": {"content": "I'm doing well, thank you!"}}]} +def test_completions_create_keeps_filters_out_of_add(mock_memory_client, mock_litellm): + completions = Completions(mock_memory_client) + mock_memory_client.search.return_value = [] + mock_litellm.supports_function_calling.return_value = True + + with patch("mem0.proxy.main.threading.Thread") as mock_thread: + mock_thread.side_effect = lambda target, daemon: Mock(start=target) + completions.create( + model="gpt-4.1-nano-2025-04-14", + messages=[{"role": "user", "content": "Hello"}], + user_id="test_user", + filters={"categories": {"in": ["travel"]}}, + ) + + assert "filters" not in mock_memory_client.add.call_args.kwargs + assert mock_memory_client.add.call_args.kwargs["user_id"] == "test_user" + assert mock_memory_client.search.call_args.kwargs["filters"] == {"categories": {"in": ["travel"]}} + + def test_completions_create_with_system_message(mock_memory_client, mock_litellm): completions = Completions(mock_memory_client) From 0724291bd864cf807e88ee8981c8226644e8fb42 Mon Sep 17 00:00:00 2001 From: Karthik Date: Wed, 14 Oct 2026 21:09:50 +0530 Subject: [PATCH 48/55] Add OSS Halloween Happy Hour banner to README (#7637) --- README.md | 11 +++++++++++ docs/images/halloween-happy-hour.png | Bin 0 -> 742301 bytes 2 files changed, 11 insertions(+) create mode 100644 docs/images/halloween-happy-hour.png diff --git a/README.md b/README.md index 9a81e74ef..c9ed6dbfb 100644 --- a/README.md +++ b/README.md @@ -3,6 +3,17 @@ Mem0 - The Memory Layer for Personalized AI

+ +

+ + Mem0 OSS Halloween Happy Hour: The People Who Read the Source. Tuesday, Oct 27, 5:00 PM, San Francisco. Costumes encouraged. + +
+ 🎃 Register here → · Contributors get priority +

+ + +

mem0ai%2Fmem0 | Trendshift diff --git a/docs/images/halloween-happy-hour.png b/docs/images/halloween-happy-hour.png new file mode 100644 index 0000000000000000000000000000000000000000..8b5ab3874af3dc497c5fcc347001261e482d6992 GIT binary patch literal 742301 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 N{+MfkQ0SAu8l*O-++Sxv2!RmIj)0#P&u8 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≠pcB|zW<~S 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

2YES3!fc9 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 X?}Gw|bfX9<00000NkvXXu0mjfnYs6O literal 0 HcmV?d00001 From 2c81af3bbe27d9bccb09c772d583df9e9be72ee5 Mon Sep 17 00:00:00 2001 From: harsh-mem0 Date: Tue, 20 Oct 2026 21:16:17 -0400 Subject: [PATCH 49/55] docs(platform): rewrite the BYOK page as a feature guide (#7661) Co-authored-by: AGAMPANDEYY --- docs/docs.json | 3 +- .../images/platform/byok-accuracy-vs-cost.png | Bin 0 -> 451843 bytes docs/images/platform/byok-picks.png | Bin 0 -> 76519 bytes docs/llms.txt | 1 + docs/platform/features/byok.mdx | 126 ++++++++++++++++++ 5 files changed, 129 insertions(+), 1 deletion(-) create mode 100644 docs/images/platform/byok-accuracy-vs-cost.png create mode 100644 docs/images/platform/byok-picks.png create mode 100644 docs/platform/features/byok.mdx diff --git a/docs/docs.json b/docs/docs.json index 4371c1ffe..c3ffd6d87 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -87,7 +87,8 @@ "platform/advanced-memory-operations", "platform/features/custom-instructions", "platform/features/memory-decay", - "platform/features/dream" + "platform/features/dream", + "platform/features/byok" ] }, { diff --git a/docs/images/platform/byok-accuracy-vs-cost.png b/docs/images/platform/byok-accuracy-vs-cost.png new file mode 100644 index 0000000000000000000000000000000000000000..020c40fc04ec74b5a948b3baef954dff988c4113 GIT binary patch literal 451843 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

r&aVBw259VuS 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 z

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%0D-yX4?!1TRPv-BV^Fh1 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≫0>vb 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 z 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 RWjMP|8A(Nn0x_eP{|{B0jI00v literal 0 HcmV?d00001 diff --git a/docs/images/platform/byok-picks.png b/docs/images/platform/byok-picks.png new file mode 100644 index 0000000000000000000000000000000000000000..f09b9b2af95e04754f9541485836a66bc1986132 GIT binary patch literal 76519 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

j$wR-|IsRx}EvM{jqZxlfEx7(27rmaas@Gynb!@ za;RjV#|1eqm6ru1E%%PeAx?1m(Qn=OCl<3}8;iFJ9zamCkL~{XXM~96&f{Cmg@kQ6 z!ApRx6^^%R&OfI-F>h!mB!7f|1}GO4Nxpd)cIH5c3NOI0@u^s42jTQk$#eyU`KM_{ za2P#eHEfdWA(A#JM6e7v3;5Yx$j#l(08H(SXfOhMcxzQ}^BaRi=Anw5BkOgT%hEkQ zBjRCpJY&Xl=z95a>FHwo4P@1Okemv}6_0i;^8RUGY4%;ZOAfi=j7pWw)}?cIOn9p+ z574ud4epya|H|%6*XHdVGFI;a@ku#lbK6B0dpr_=cqImS}Ye>(z_!sU>RKR z5QK(g*{Iqz0(_uDWRwDBK}%E>yc}T3QBwz-bqqV7&fdzVCi)(IS5NwJ9F_&tKnjt+ zZm6|Rpt2SR{7+N`FXFNm%vzIocBg>ypPmO-^aNybKtFOnYR0nI&hFaOB+2z<>1zE6 zfXS1jLqCE}@h0)(h9GHgcQ`s)#kHYk1Fdg~2`z#Dwu#Sl8^=Hokl2B2hb^>8& z*-+AEbL{9#!z~|GBQE_xn-r<`Q}R=aKAyK9JJKc&5FAo>5g~A?(IwE zB?Csn9gT8hM+blxgwKc>|4?$k9D`W+sbK6N$bu2mP+9i(oA_M z8Nx60ap?UJ!aBS z7&v=?w0uxnP)V&a9Og3ZuJ5o1u^3nUD6RSqt5gK&G7!2*c{9VhFf&$0(S_; ztkv2_iJ>c7JsH;R?<*TK%>8BDebRl#{=EV{V=)961W)g>ACq58wvl!eLOt9Y@11}n99z4O)*JhX4-J-wBze8q%=77 z@PSLYi?|!`F^K9?&ue2|A58n{OV}JPBcn-9BfN5_+31x+?q;xaV5RAa-!BArU%tRq z9^V^LUJ@D^U7T(f?S!pdt_HuQoF5MF+t1&h3BWKZsZnpXa9M$_s$aY~-rP6N)CZ*% zv%c1h1gdOIDDmcxjXG=3XQ22O1ZAoKrVYxx8|T(mb(uFkEC0q zM7+KLh{VZZ#@M4zAKARNrgN+rS_T+xWnbM}Eb+uB3HKkYBdwd&XU^PADo%d*jbrHY zC{bwrqxS5BV^Lkut@W?+r%!vq2m!z;826^8=3PbJXXw?{(TVBlRR}Eahc^X@eR4Z= zGFIFQBQ1%c4rK(M<^)YRyh*u!qOYaX^gD-Y_AP#Hj8`=$6Pv~DyLI#wycx*DFK) z-lFvre-J{A2&gHiSB|o>t>CTegpBEaE$e&+MIcgU=yS81HmXcIGx)s?)OHVwtJ(NB zl%b229giCtCrS6~+QORoR#C|3YrfQSaB2?66dZl9)j=@p7^@UztN&jZf1WP?GX5S} zzpkwn5Ky%*lVpOQP4m;mBP3;4{F*zLDyfRah;Ub`$JDP7TW&8yK%`1>fm!SHT-DrV z3}U~CC-XMXl+zRY<@No7Rffr-_V*!yhRM;Pd}S|f9Skp+$27FMce|oBr60Y+Wlb&H ziMbW^2y}0VF7fBJjg0P!p7U$7Ox#G-n}I#bxeL=(!QIiUD2WMkGOh|H28@v`-fHR&&0i1=hUrQKN^ThR*P5D|Au~3u=OjnjT%zO_o!F2e_$hG9Qxl>cEZX!S{zN{WoiE=} z8<}%a@sLINmCg5E^w#uVw1`}BBK{JDSMm_4n;BwZest8=uit1rC@_8Aqppxkk$OHwSyg{olTLU|W=^AA+W z3}>BM>gU%6HxdP=)9Tev zNa9qeQBhHq+?U#-@Z`xo$r2*Ac)$L@45zl1D$*OmhPWoXc7+&BDDAfS}kmKMfzfrdTo$kApy?C{e^aj-H7-~DyKQU7jUj0eUn5jrnMBE9_Q8qV{i-}IW0EZ_%Kic-Eg9F*_uOfMMmho*aT^_eMT_k{`dE6yK}uW#~f``;$C$YE!bqPxP?{H zV2#z|9SQ=$5G?=d8BzcBvUB%^5uu?Bl+rh<+oYLo3NpV?96sg6SWL1Z#3g%elX>

k#`M`D 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 literal 0 HcmV?d00001 diff --git a/docs/llms.txt b/docs/llms.txt index c511033ce..7ceef9578 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -209,6 +209,7 @@ If the user is on a pre-current major (Python < 2, TS < 3, or a Platform call st - [Custom Instructions](https://docs.mem0.ai/platform/features/custom-instructions) [Platform]: Use when tailoring what Mem0 extracts and stores on Platform. - [Memory Decay](https://docs.mem0.ai/platform/features/memory-decay) [Platform]: Use when search results should boost recently-reinforced memories and dampen stale ones. Opt in per project; applies at search time and never filters candidates out. - [Dream](https://docs.mem0.ai/platform/features/dream) [Platform]: Use when long-lived user memory should stay coherent on its own - synthesizing recurring patterns, superseding outdated facts, and merging duplicates in the background. Synthesis is opt-in (Pro+); Supersede and Merge are always on. +- [Bring Your Own Key (BYOK)](https://docs.mem0.ai/platform/features/byok) [Platform]: Use when connecting your own OpenAI, Anthropic, OpenRouter or Azure OpenAI key so memories are created on your model - setup, key-check errors, failed adds, rate limits and choosing a model. - [Advanced Memory Operations](https://docs.mem0.ai/platform/advanced-memory-operations) [Platform]: Use when basic CRUD is not enough - batch ops, complex filters, workflows. ### Features - Data Management diff --git a/docs/platform/features/byok.mdx b/docs/platform/features/byok.mdx new file mode 100644 index 000000000..6a57c6cd8 --- /dev/null +++ b/docs/platform/features/byok.mdx @@ -0,0 +1,126 @@ +--- +title: "Bring Your Own Key (BYOK)" +sidebarTitle: "BYOK" +description: "Run memory creation on your own LLM provider and model, billed to your own API key." +--- + +## Overview + +With Bring Your Own Key (BYOK), Mem0 runs the LLM calls that turn your messages into memories on a model you choose, using your own API key. Mem0 sends your message text to that provider under your account, and your provider bills you directly. If your key stops working, Mem0 doesn't switch to its own key. The add fails and shows why. Embeddings, search and reranking still run on Mem0. + +## Where to find it + +BYOK is set per organization, in **Settings → BYOK** in the [Mem0 dashboard](https://app.mem0.ai/dashboard/settings?tab=org-llm). Only organization owners see this tab. One key covers every project in the organization. + + + Organizations created through the Vercel Marketplace are managed from Vercel and can't use BYOK. + + +## Supported providers + +| Provider | What you need | Model | +|---|---|---| +| OpenAI | An OpenAI API key | Pick from the list or enter any OpenAI model ID. GPT-6 Luna is recommended for best value. | +| Anthropic | An Anthropic API key | Pick from the list or enter any Claude model ID. Claude Haiku 5.5 is recommended for best value. | +| OpenRouter | An OpenRouter API key | Pick from the list or enter any OpenRouter model ID, such as `deepseek/deepseek-v4.1-flash`. DeepSeek V4.1 Flash is recommended for best value. | +| Azure OpenAI | An API key and your endpoint URL | Your deployment name | + +For Azure OpenAI, use your resource's endpoint from the Azure portal, such as `https://your-resource.openai.azure.com/`. + +## Set up BYOK + + + +Go to **Settings → BYOK** in the dashboard. + + +Pick OpenAI, Anthropic, OpenRouter or Azure OpenAI from the **Provider** list. + + +The **Model** list shows the models we tested, with a **Recommended** tag on our pick for that provider. Under the model, the tab shows its estimated cost per 1,000 adds on your provider account. + +To use a model that isn't in the list, choose **Other model ID** and type the model ID exactly as your provider names it. For Azure OpenAI, type your deployment name in **Deployment / Model**. + + +Paste your key into **API key**. For Azure OpenAI, also fill in **Endpoint URL**. + + +Click **Save key**. Mem0 sends a short test request to your provider with your key and model, then saves them. When the test passes, the top of the tab shows your provider and model, such as **Running on OpenAI · gpt-6-luna**. + + + +Mem0 encrypts your key and never shows it again. To change only the model, pick the new model and leave **API key** empty to keep the saved key. To stop using BYOK, click **Remove key**. New adds then run on Mem0's default model, within your plan's limits. + +## Errors and rate limits + +### When you save a key + +If the test request finds one of these problems, Mem0 doesn't save the key: + +| Message | What to check | +|---|---| +| The provider rejected the API key. Double-check the key and try again. | The key is wrong, revoked, or from a different provider. | +| The provider couldn't find that model or deployment. Double-check the Model name and try again. | The model ID is misspelled, your account can't use that model, or the Azure deployment doesn't exist on that resource. | +| Could not reach the endpoint. Double-check the Endpoint URL and try again. | The Azure OpenAI **Endpoint URL** is misspelled, doesn't exist, or isn't reachable. | +| The Endpoint URL responded unexpectedly (HTTP …). Double-check the Endpoint URL and try again. | The Azure OpenAI **Endpoint URL** doesn't point to an Azure OpenAI resource. | +| Could not reach the provider. Try again in a moment. | Mem0 couldn't connect to your provider. This is usually brief. | +| The provider responded unexpectedly (HTTP …). Try again in a moment. | Your provider returned an error Mem0 didn't expect. | + +Some problems don't stop the save, because they can be fixed on your provider's side without changing anything in Mem0. In that case Mem0 saves the key and shows a warning at the top of the tab that names your provider. For example, with an OpenAI key: + +- **No credit:** "Key saved, but OpenAI says this account has no credit. Adds will fail until you add credit with OpenAI." +- **Rate limited:** "Key saved, but OpenAI is rate limiting requests right now. Adds may fail until the limit resets." + +After you add credit or the limit resets, click **Check again** to run the test again on the saved key. + +### When an add fails + +Adds run in the background. Each add returns an `event_id`, and you can follow it with [Get Event](/api-reference/events/get-event). When an add fails for one of the reasons below, the event ends as `FAILED` and its `error` field says why: + +```json +{ + "id": "6f1d3a2e-8c4b-4f6a-9d2e-1b7c5a9e0f42", + "event_type": "ADD", + "status": "FAILED", + "error": "The configured LLM provider account is out of quota or credits." +} +``` + +| `error` | What to do | +|---|---| +| The configured LLM provider rejected the API credentials. | Save a valid key in **Settings → BYOK**. | +| The configured LLM provider account is out of quota or credits. | Add credit with your provider. | +| The configured LLM model or deployment was not found. | Pick a model your account can use, or fix the Azure deployment name. | +| The configured LLM provider returned a response that could not be parsed. | Switch to a model from the **Model** list. This model replied in a format Mem0 couldn't read. | +| The configured LLM credentials could not be read. Please re-save your provider settings. | Save your key again in **Settings → BYOK**. | +| Input exceeds the model's context window. | Send shorter messages, or pick a model with a larger context window. | + +In the dashboard, open the failed add on the **Requests** page to see the same reason. Mem0 doesn't retry these adds, so send them again after you fix the cause. + +### Rate limits and temporary errors + +When your provider rate limits a request, times out or returns a server error, Mem0 retries it automatically, so the add can take longer to finish. If this happens often, raise the rate limits on your provider account. + +## Choose a model + +Three things decide which model fits: + +- **Accuracy:** how well the memories a model writes answer questions later. +- **Cost:** what your provider charges for the calls behind one add. +- **Latency:** how long it takes from sending an add until its memories show up in search. + +We measured these on [LoCoMo](https://github.com/snap-research/locomo), a public benchmark of long conversations, for a limited set of popular models. Your own data can give different results. Based on what we measured, these are our picks: **Best value** balances accuracy and price, **Best under \$1** is the most accurate model under \$1 per 1,000 add requests, and **Best quality** has the highest accuracy. + + + The three picks. Best value: DeepSeek V4.1 Flash, open weights, on OpenRouter: 92.9% accuracy, $5.34 per 1,000 add requests, 18.5 s latency at p95. Best under $1: Amazon Nova Micro, closed, on OpenRouter: 88.0% accuracy, $0.86 per 1,000 add requests, 10.2 s latency at p95. Best quality: Claude Opus 5.5, closed, on Anthropic, OpenRouter: 93.5% accuracy, $158.55 per 1,000 add requests, 18.1 s latency at p95. + + + +The latency above is for adds, which run asynchronously: the add call returns an event ID right away, and the memories become searchable once processing finishes. Search doesn't use your model, and its server-side latency is about 270 ms at p50 and 640 ms at p95. + + +Accuracy against cost for every model we tested. The green line marks the best accuracy available at each price, the gold area holds the models under $2 per 1,000 add requests, and the gray dashed line is Mem0's default model, at 92.5%. + + + Scatter chart of accuracy against cost per 1,000 add requests on a log scale, one ring per model, each labelled with its accuracy. Mistral Nemo sits at the far left at $0.68 and 84.1%; Claude Opus 5.5 at the far right at $158.55 and 93.5%. A dashed gray line marks Mem0's default model (free tier) at 92.5%. A green shaded region holds the models above it for under $10 per 1,000 add requests, a gold one the models under $2 per 1,000 add requests, and a dashed green line marks the best accuracy available at each price. Tags mark our picks: best value, DeepSeek V4.1 Flash; best under $1, Amazon Nova Micro; best quality, Claude Opus 5.5. + From 26cdefb46600c0fa5953c4b5ee5003c125539fc4 Mon Sep 17 00:00:00 2001 From: harsh-mem0 Date: Mon, 26 Oct 2026 10:51:39 -0400 Subject: [PATCH 50/55] docs(platform): add the pricing FAQ page (#7711) --- docs/docs.json | 3 +- docs/llms.txt | 1 + docs/platform/pricing.mdx | 96 +++++++++++++++++++++++++++++++++++++++ 3 files changed, 99 insertions(+), 1 deletion(-) create mode 100644 docs/platform/pricing.mdx diff --git a/docs/docs.json b/docs/docs.json index c3ffd6d87..b694e288a 100644 --- a/docs/docs.json +++ b/docs/docs.json @@ -116,7 +116,8 @@ "group": "Support", "icon": "life-buoy", "pages": [ - "platform/faqs" + "platform/faqs", + "platform/pricing" ] }, { diff --git a/docs/llms.txt b/docs/llms.txt index 7ceef9578..f13e2fc07 100644 --- a/docs/llms.txt +++ b/docs/llms.txt @@ -225,6 +225,7 @@ If the user is on a pre-current major (Python < 2, TS < 3, or a Platform call st ### Support & Migration - [FAQs](https://docs.mem0.ai/platform/faqs) [Platform]: Use when answering common Platform questions. +- [Pricing FAQ](https://docs.mem0.ai/platform/pricing) [Platform]: Use when a user asks how the October 26, 2026 pricing change affects their plan - existing Starter, Growth and Pro plans, free plan limits and the 30-day period, connecting their own LLM key, Vercel accounts and usage-based billing. - [Contribute to Platform](https://docs.mem0.ai/platform/contribute) [Platform]: Use when a user wants to contribute to Platform docs or code. - [OSS to Platform Migration](https://docs.mem0.ai/migration/oss-to-platform) [Both]: Use when moving from self-hosted to managed. - [OSS v2 to v3 Migration](https://docs.mem0.ai/migration/oss-v2-to-v3) [OSS]: Use when upgrading a self-hosted deployment across major versions. diff --git a/docs/platform/pricing.mdx b/docs/platform/pricing.mdx new file mode 100644 index 000000000..5d27d8252 --- /dev/null +++ b/docs/platform/pricing.mdx @@ -0,0 +1,96 @@ +--- +title: "Pricing FAQ" +sidebarTitle: "Pricing" +description: "Frequently asked questions about Mem0's plans, limits and using your own LLM key." +icon: "credit-card" +--- + +## Existing paid plans + + + + Nothing. Your price, limits, extra usage and billing date stay the same, and you can still turn extra usage on or off from your dashboard. These plans are no longer sold to new accounts. + + + Plan changes now go through our team. If you need higher limits or more features, [talk to us](https://app.mem0.ai/enterprise?ref=docs) and we'll set up a custom plan. If you cancel, your account moves to the free plan, any extra usage up to then is billed on your last invoice, and the old plan can't be restarted. + + + +## Free plan + + + + For your first 30 days, Mem0 pays for the model calls, with limits of 10,000 adds and 1,000 retrievals a month. After that, connect your own LLM key to keep adding memories, and your limits go up to 50,000 adds and 10,000 retrievals a month at no charge from Mem0. You can connect a key at any time, including during your first 30 days. + + + If you signed up before October 26, 2026, you have until November 25, 2026. Otherwise, your 30 days start on the day you sign up. + + + Your memories stay, and searches keep working up to 1,000 a month. New adds return an error until you connect a key. + + + Calls past the limit return an error until your limits reset next month. + + + Yes. We email the organization owner at 50%, 80% and 100% of each monthly limit, and of your usage-based billing cap. + + + +## Your own LLM key + + + + Adding a memory runs language model calls that extract and organize it. With your key, those calls bill to your provider account. That is how we keep the free plan free at higher limits. + + + It depends on the model. Our recommended models cost about \$3.55 to \$5.34 per 1,000 adds: GPT-6 Luna on OpenAI, Claude Haiku 5.5 on Anthropic and DeepSeek V4.1 Flash on OpenRouter. The [BYOK guide](/platform/features/byok#choose-a-model) compares accuracy and cost across every model we tested. + + + OpenAI, Anthropic, Azure OpenAI and OpenRouter. + + + Yes. The text you add is sent to your provider under your account and its terms. Mem0 stores your key encrypted, never shows it again after you save it, and you can remove it at any time. + + + Organization owners, in **Settings → BYOK**. One key covers every project in the organization. + + + Adds fail with a reason you can see in the dashboard, and we email the organization owner, at most once a day. Mem0 doesn't switch to its own key, so send the failed adds again once the key works. Searches keep working. + + + Your limits go back to the ones without a key, and usage-based billing stops until you connect a key again. Anything you used before removing it is still billed on your next invoice. + + + +## Vercel + + + + Nothing changes. Your plan is billed through Vercel. Organizations created through the Vercel Marketplace are managed from Vercel and can't use BYOK. + + + +## Need more + + + + Once you've connected your own key, you can turn on usage-based billing from your dashboard and set a monthly spending cap. For SSO, an SLA or a contract, [talk to us](https://app.mem0.ai/enterprise?ref=docs). + + + You pay only for adds and retrievals above your free limits, billed once a month. The rate is shown when you turn it on, and those extra calls stop when you reach your monthly cap. + + + Yes, at any time from your dashboard. If you turn it off, you're still billed for what you used before. + + + +## Learn more + + + + Connect your provider key, pick a model and fix failed adds. + + + Accuracy, cost and latency for every model we tested. + + From d2b8432b772a5923ab5ba145cf1ae2a9f8b1c3f2 Mon Sep 17 00:00:00 2001 From: harsh-mem0 Date: Fri, 30 Oct 2026 17:35:20 -0400 Subject: [PATCH 51/55] fix(ts): never re-create a deleted memory when update races delete (#7788) --- mem0-ts/src/oss/src/memory/index.ts | 10 +- mem0-ts/src/oss/src/tests/chroma.test.ts | 35 +++- mem0-ts/src/oss/src/tests/mongodb.test.ts | 30 +++- mem0-ts/src/oss/src/tests/pinecone.test.ts | 32 +++- .../oss/src/vector_stores/azure_ai_search.ts | 8 +- .../src/oss/src/vector_stores/azure_mysql.ts | 8 +- mem0-ts/src/oss/src/vector_stores/base.ts | 3 +- mem0-ts/src/oss/src/vector_stores/chroma.ts | 13 +- .../src/oss/src/vector_stores/databricks.ts | 9 +- .../oss/src/vector_stores/elasticsearch.ts | 11 +- mem0-ts/src/oss/src/vector_stores/memory.ts | 5 +- mem0-ts/src/oss/src/vector_stores/mongodb.ts | 5 +- .../src/vector_stores/neptune_analytics.ts | 7 +- .../src/oss/src/vector_stores/opensearch.ts | 13 +- mem0-ts/src/oss/src/vector_stores/oracledb.ts | 6 +- mem0-ts/src/oss/src/vector_stores/pgvector.ts | 5 +- mem0-ts/src/oss/src/vector_stores/pinecone.ts | 7 +- mem0-ts/src/oss/src/vector_stores/qdrant.ts | 19 +- mem0-ts/src/oss/src/vector_stores/redis.ts | 43 ++++- .../oss/src/vector_stores/upstash_vector.ts | 12 +- mem0-ts/src/oss/src/vector_stores/valkey.ts | 47 ++++- mem0-ts/src/oss/src/vector_stores/weaviate.ts | 11 +- .../src/oss/tests/elasticsearch.unit.test.ts | 33 +++- mem0-ts/src/oss/tests/memory.crud.test.ts | 24 +++ mem0-ts/src/oss/tests/opensearch.unit.test.ts | 40 +++++ mem0-ts/src/oss/tests/oracledb.unit.test.ts | 38 ++++ mem0-ts/src/oss/tests/pgvector.unit.test.ts | 25 +++ .../oss/tests/qdrant-keyword-search.test.ts | 22 +++ mem0-ts/src/oss/tests/redis.unit.test.ts | 125 +++++++++++-- .../src/oss/tests/upstash_vector.unit.test.ts | 44 ++++- mem0-ts/src/oss/tests/valkey.test.ts | 136 ++++++++++++++ .../src/oss/tests/vector-store.unit.test.ts | 11 +- .../oss/tests/vector-stores-compat.test.ts | 169 +++++++++++++++++- 33 files changed, 934 insertions(+), 72 deletions(-) diff --git a/mem0-ts/src/oss/src/memory/index.ts b/mem0-ts/src/oss/src/memory/index.ts index 42f3ca22e..00fdc7d97 100644 --- a/mem0-ts/src/oss/src/memory/index.ts +++ b/mem0-ts/src/oss/src/memory/index.ts @@ -1990,7 +1990,15 @@ export class Memory { updatedAt: new Date().toISOString(), }; - await this.vectorStore.update(memoryId, embedding, newMetadata); + const updated = await this.vectorStore.update( + memoryId, + embedding, + newMetadata, + ); + // The memory was deleted between the get above and this write. + if (updated === false) { + throw new Error(`Memory with ID ${memoryId} not found`); + } await this.db.addHistory( memoryId, prevValue, diff --git a/mem0-ts/src/oss/src/tests/chroma.test.ts b/mem0-ts/src/oss/src/tests/chroma.test.ts index 3b51e7eef..6efb2df2f 100644 --- a/mem0-ts/src/oss/src/tests/chroma.test.ts +++ b/mem0-ts/src/oss/src/tests/chroma.test.ts @@ -271,14 +271,47 @@ describe("get", () => { describe("update", () => { it("updates a single record with embedding and metadata", async () => { + __mocks__.get.mockResolvedValue({ ids: ["vec-1"], metadatas: [{}] }); const db = await initDb(); - await db.update("vec-1", [1, 2, 3], { text: "updated" }); + expect(await db.update("vec-1", [1, 2, 3], { text: "updated" })).toBe(true); expect(__mocks__.update).toHaveBeenCalledWith({ ids: ["vec-1"], embeddings: [[1, 2, 3]], metadatas: [{ text: "updated" }], }); }); + + it("returns false and inserts nothing when the id does not exist", async () => { + const db = await initDb(); + expect(await db.update("missing", [1, 2, 3], { text: "x" })).toBe(false); + expect(__mocks__.get).toHaveBeenCalledWith({ + ids: ["missing"], + include: [], + }); + expect(__mocks__.add).not.toHaveBeenCalled(); + expect(__mocks__.upsert).not.toHaveBeenCalled(); + }); + + it("returns undefined, not an error, when the read-back after a landed update fails", async () => { + const warn = jest.spyOn(console, "warn").mockImplementation(() => {}); + const db = await initDb(); + __mocks__.get.mockRejectedValueOnce(new Error("chroma unavailable")); + expect(await db.update("vec-1", [1, 2, 3], { text: "x" })).toBeUndefined(); + expect(__mocks__.update).toHaveBeenCalledTimes(1); + expect(warn).toHaveBeenCalled(); + warn.mockRestore(); + }); + + it("supports a payload-only update", async () => { + __mocks__.get.mockResolvedValue({ ids: ["vec-1"], metadatas: [{}] }); + const db = await initDb(); + expect(await db.update("vec-1", null as any, { text: "only" })).toBe(true); + expect(__mocks__.update).toHaveBeenCalledWith({ + ids: ["vec-1"], + embeddings: undefined, + metadatas: [{ text: "only" }], + }); + }); }); describe("delete", () => { diff --git a/mem0-ts/src/oss/src/tests/mongodb.test.ts b/mem0-ts/src/oss/src/tests/mongodb.test.ts index fe847b56c..d6600bf04 100644 --- a/mem0-ts/src/oss/src/tests/mongodb.test.ts +++ b/mem0-ts/src/oss/src/tests/mongodb.test.ts @@ -330,7 +330,9 @@ describe("MongoDB Vector Store", () => { it("should update document correctly", async () => { mockUpdateOne.mockResolvedValue({ matchedCount: 1 }); - await store.update("id1", [0.1, 0.2, 0.3, 0.4], { name: "new-alice" }); + expect( + await store.update("id1", [0.1, 0.2, 0.3, 0.4], { name: "new-alice" }), + ).toBe(true); expect(mockUpdateOne).toHaveBeenCalledWith( { _id: "id1" }, @@ -343,6 +345,32 @@ describe("MongoDB Vector Store", () => { ); }); + it("should return false and not insert when updating a missing id", async () => { + mockUpdateOne.mockResolvedValue({ matchedCount: 0, modifiedCount: 0 }); + await store.initialize(); + mockInsertOne.mockClear(); + + expect(await store.update("missing", [0.1, 0.2, 0.3, 0.4], {})).toBe(false); + expect(mockUpdateOne.mock.calls[0][2]?.upsert).toBeFalsy(); + expect(mockInsertOne).not.toHaveBeenCalled(); + expect(mockInsertMany).not.toHaveBeenCalled(); + }); + + it("should return undefined when the write is unacknowledged", async () => { + mockUpdateOne.mockResolvedValue({ acknowledged: false, matchedCount: 0 }); + expect(await store.update("id1", [0.1, 0.2, 0.3, 0.4], {})).toBeUndefined(); + }); + + it("should merge a payload-only update without touching the embedding", async () => { + mockUpdateOne.mockResolvedValue({ matchedCount: 1 }); + + expect(await store.update("id1", null as any, { name: "bob" })).toBe(true); + expect(mockUpdateOne).toHaveBeenCalledWith( + { _id: "id1" }, + { $set: { "payload.name": "bob" } }, + ); + }); + it("should delete document correctly", async () => { mockDeleteOne.mockResolvedValue({ deletedCount: 1 }); diff --git a/mem0-ts/src/oss/src/tests/pinecone.test.ts b/mem0-ts/src/oss/src/tests/pinecone.test.ts index 3c008538e..5342d7a49 100644 --- a/mem0-ts/src/oss/src/tests/pinecone.test.ts +++ b/mem0-ts/src/oss/src/tests/pinecone.test.ts @@ -9,12 +9,13 @@ // so `beforeEach` can reach them before the lazy import has fired; the factory, // which runs on first use, just returns a reference to the Pinecone class mock. const upsert = jest.fn().mockResolvedValue(undefined); +const update = jest.fn().mockResolvedValue(undefined); const query = jest.fn().mockResolvedValue({ matches: [] }); const fetch = jest.fn().mockResolvedValue({ records: {} }); const deleteOne = jest.fn().mockResolvedValue(undefined); const deleteAll = jest.fn().mockResolvedValue(undefined); -const nsHandle = { upsert, query, fetch, deleteOne, deleteAll }; +const nsHandle = { upsert, update, query, fetch, deleteOne, deleteAll }; const namespace = jest.fn().mockReturnValue(nsHandle); const describeIndexStats = jest @@ -26,6 +27,7 @@ const indexHandle = { describeIndexStats, // expose ops directly for the no-namespace path upsert, + update, query, fetch, deleteOne, @@ -45,6 +47,7 @@ const Pinecone = jest.fn().mockImplementation(() => ({ const __mocks__ = { upsert, + update, query, fetch, deleteOne, @@ -104,6 +107,7 @@ beforeEach(() => { const nsHandle = { upsert: __mocks__.upsert, + update: __mocks__.update, query: __mocks__.query, fetch: __mocks__.fetch, deleteOne: __mocks__.deleteOne, @@ -114,6 +118,7 @@ beforeEach(() => { namespace: __mocks__.namespace, describeIndexStats: __mocks__.describeIndexStats, upsert: __mocks__.upsert, + update: __mocks__.update, query: __mocks__.query, fetch: __mocks__.fetch, deleteOne: __mocks__.deleteOne, @@ -399,14 +404,27 @@ describe("get", () => { }); describe("update", () => { - it("upserts a single record", async () => { + it("updates by id and never upserts", async () => { const db = await initDb(); - await db.update("vec-1", [1, 2, 3, 4], { text: "updated" }); - expect(__mocks__.upsert).toHaveBeenCalledWith({ - records: [ - { id: "vec-1", values: [1, 2, 3, 4], metadata: { text: "updated" } }, - ], + await expect( + db.update("vec-1", [1, 2, 3, 4], { text: "updated" }), + ).resolves.toBeUndefined(); + expect(__mocks__.update).toHaveBeenCalledWith({ + id: "vec-1", + values: [1, 2, 3, 4], + metadata: { text: "updated" }, }); + expect(__mocks__.upsert).not.toHaveBeenCalled(); + }); + + it("payload-only update leaves the vector values alone", async () => { + const db = await initDb(); + await db.update("vec-1", null as any, { text: "renamed" }); + expect(__mocks__.update).toHaveBeenCalledWith({ + id: "vec-1", + metadata: { text: "renamed" }, + }); + expect(__mocks__.upsert).not.toHaveBeenCalled(); }); }); diff --git a/mem0-ts/src/oss/src/vector_stores/azure_ai_search.ts b/mem0-ts/src/oss/src/vector_stores/azure_ai_search.ts index 52576aca0..84117718b 100644 --- a/mem0-ts/src/oss/src/vector_stores/azure_ai_search.ts +++ b/mem0-ts/src/oss/src/vector_stores/azure_ai_search.ts @@ -474,7 +474,7 @@ export class AzureAISearch implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); const document: Record = { id: vectorId }; @@ -493,15 +493,19 @@ export class AzureAISearch implements VectorStore { } } - const response = await this.searchClient.mergeOrUploadDocuments([document]); + const response = await this.searchClient.mergeDocuments([document]); for (const result of response.results) { + if (result.statusCode === 404) { + return false; + } if (!result.succeeded) { throw new Error( `Update failed for document ${vectorId}: ${result.errorMessage}`, ); } } + return true; } /** diff --git a/mem0-ts/src/oss/src/vector_stores/azure_mysql.ts b/mem0-ts/src/oss/src/vector_stores/azure_mysql.ts index 123767484..d525fcca7 100644 --- a/mem0-ts/src/oss/src/vector_stores/azure_mysql.ts +++ b/mem0-ts/src/oss/src/vector_stores/azure_mysql.ts @@ -1,4 +1,4 @@ -import type { Pool, RowDataPacket } from "mysql2/promise"; +import type { Pool, ResultSetHeader, RowDataPacket } from "mysql2/promise"; import { VectorStore } from "./base"; import { SearchFilters, VectorStoreConfig, VectorStoreResult } from "../types"; import { loadPeer } from "../utils/load_peer"; @@ -275,16 +275,18 @@ export class AzureMySQLDB implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); const conn = await this.pool!.getConnection(); try { await conn.beginTransaction(); - await conn.execute( + // mysql2 sets CLIENT_FOUND_ROWS by default, so affectedRows counts matched rows. + const [result] = await conn.execute( `UPDATE ${this.col()} SET vector = ?, payload = ? WHERE id = ?`, [JSON.stringify(vector), JSON.stringify(payload), vectorId], ); await conn.commit(); + return result.affectedRows > 0; } catch (err) { await conn.rollback(); throw err; diff --git a/mem0-ts/src/oss/src/vector_stores/base.ts b/mem0-ts/src/oss/src/vector_stores/base.ts index 975541cf8..970981274 100644 --- a/mem0-ts/src/oss/src/vector_stores/base.ts +++ b/mem0-ts/src/oss/src/vector_stores/base.ts @@ -17,11 +17,12 @@ export interface VectorStore { filters?: SearchFilters, ): Promise; get(vectorId: string): Promise; + /** Must not create a record. true: record changed; false: id does not exist; void: the store cannot tell. */ update( vectorId: string, vector: number[], payload: Record, - ): Promise; + ): Promise; delete(vectorId: string): Promise; deleteCol(): Promise; list( diff --git a/mem0-ts/src/oss/src/vector_stores/chroma.ts b/mem0-ts/src/oss/src/vector_stores/chroma.ts index bec0e961a..994b0a596 100644 --- a/mem0-ts/src/oss/src/vector_stores/chroma.ts +++ b/mem0-ts/src/oss/src/vector_stores/chroma.ts @@ -186,13 +186,24 @@ export class ChromaDB implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { const collection = await this.getCollection(); await collection.update({ ids: [vectorId], embeddings: vector ? [vector] : undefined, metadatas: payload ? [payload] : undefined, } as any); + // Chroma skips unknown ids on update without an error, so check existence after the write. + try { + const existing = await collection.get({ ids: [vectorId], include: [] }); + return existing.ids.length > 0; + } catch (error) { + // The write already ran; failing here would surface an error for a landed update. + console.warn( + `Chroma update of '${vectorId}' could not be confirmed:`, + error, + ); + } } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/databricks.ts b/mem0-ts/src/oss/src/vector_stores/databricks.ts index 627e522ee..f09e8f2b5 100644 --- a/mem0-ts/src/oss/src/vector_stores/databricks.ts +++ b/mem0-ts/src/oss/src/vector_stores/databricks.ts @@ -665,7 +665,7 @@ export class DatabricksVectorStore implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); this.assertVectorDimension(vector, "Vector"); @@ -673,7 +673,8 @@ export class DatabricksVectorStore implements VectorStore { // are written once at insert(). Mirror Python's `excluded_keys`: update() must never rewrite // them from the payload -- a partial payload that omits these keys would otherwise SET them to // NULL and hide the row from every session-scoped search and list(). - await this.executeSql(` + // A Delta UPDATE returns one row with num_affected_rows; without it we cannot tell. + const rows = await this.executeSql(` UPDATE ${this.fullTableName} SET embedding = ${formatSqlValue(vector)}, payload = ${formatSqlValue(JSON.stringify(payload || {}))}, @@ -681,6 +682,10 @@ export class DatabricksVectorStore implements VectorStore { WHERE memory_id = ${formatSqlValue(vectorId)} `); this.requestIndexSync(); + const raw = extractRowValue(rows[0] ?? {}, ["num_affected_rows"]); + // Number(null) and Number("") are 0, which would read as "missing". + const affected = raw == null || raw === "" ? NaN : Number(raw); + if (Number.isFinite(affected)) return affected > 0; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/elasticsearch.ts b/mem0-ts/src/oss/src/vector_stores/elasticsearch.ts index 27ec5dde6..c8a5d0e5b 100644 --- a/mem0-ts/src/oss/src/vector_stores/elasticsearch.ts +++ b/mem0-ts/src/oss/src/vector_stores/elasticsearch.ts @@ -236,17 +236,24 @@ export class ElasticsearchDB implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); const doc: Record = {}; if (vector) doc.vector = vector; if (payload) doc.metadata = payload; - await this.client.update({ + const request = this.client.update({ index: this.collectionName, id: vectorId, doc, }); + try { + await request; + } catch (error: any) { + if (error?.meta?.statusCode === 404) return false; + throw error; + } + return true; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/memory.ts b/mem0-ts/src/oss/src/vector_stores/memory.ts index 7969194f0..bbbbabaf7 100644 --- a/mem0-ts/src/oss/src/vector_stores/memory.ts +++ b/mem0-ts/src/oss/src/vector_stores/memory.ts @@ -407,16 +407,17 @@ export class MemoryVectorStore implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { if (vector.length !== this.dimension) { throw new Error( `Vector dimension mismatch. Expected ${this.dimension}, got ${vector.length}`, ); } const vectorBuffer = Buffer.from(new Float32Array(vector).buffer); - this.db + const result = this.db .prepare(`UPDATE vectors SET vector = ?, payload = ? WHERE id = ?`) .run(vectorBuffer, JSON.stringify(payload), vectorId); + return result.changes > 0; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/mongodb.ts b/mem0-ts/src/oss/src/vector_stores/mongodb.ts index a3bcecf21..776bf7138 100644 --- a/mem0-ts/src/oss/src/vector_stores/mongodb.ts +++ b/mem0-ts/src/oss/src/vector_stores/mongodb.ts @@ -379,7 +379,7 @@ export class MongoDB implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); const updateFields: any = {}; if (vector) { @@ -397,9 +397,12 @@ export class MongoDB implements VectorStore { { _id: vectorId as any }, { $set: updateFields }, ); + // An unacknowledged write reports no real matchedCount. + if (result.acknowledged === false) return; if (result.matchedCount === 0) { console.warn(`No document found with ID '${vectorId}' to update.`); } + return result.matchedCount > 0; } catch (error) { console.error("Error updating document:", error); throw error; diff --git a/mem0-ts/src/oss/src/vector_stores/neptune_analytics.ts b/mem0-ts/src/oss/src/vector_stores/neptune_analytics.ts index 79f6e5c9a..f569ed24e 100644 --- a/mem0-ts/src/oss/src/vector_stores/neptune_analytics.ts +++ b/mem0-ts/src/oss/src/vector_stores/neptune_analytics.ts @@ -173,7 +173,7 @@ export class NeptuneAnalyticsVectorStore implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { if (vector.length > 0) { this.assertVectorDimension(vector, "Vector"); } @@ -195,7 +195,7 @@ export class NeptuneAnalyticsVectorStore implements VectorStore { if (hasPayload) { const properties = this.buildStoredPayload(payload); - await this.executeQuery( + const payloadResults = await this.executeQuery( ` MATCH (n:${this.collectionLabelExpr} {\`~id\`: $vectorId}) SET n = $properties @@ -206,6 +206,7 @@ export class NeptuneAnalyticsVectorStore implements VectorStore { properties, }, ); + if (payloadResults.length === 0) return false; } if (hasVector) { @@ -224,6 +225,7 @@ export class NeptuneAnalyticsVectorStore implements VectorStore { }, ); this.assertSuccessfulResults(updateResults, "Update"); + if (updateResults.length === 0) return false; } catch (error) { if (priorResult) { try { @@ -249,6 +251,7 @@ export class NeptuneAnalyticsVectorStore implements VectorStore { throw error; } } + if (hasPayload || hasVector) return true; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/opensearch.ts b/mem0-ts/src/oss/src/vector_stores/opensearch.ts index 10f42e46a..b16717c6f 100644 --- a/mem0-ts/src/oss/src/vector_stores/opensearch.ts +++ b/mem0-ts/src/oss/src/vector_stores/opensearch.ts @@ -367,13 +367,13 @@ export class OpenSearchDB implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); if (vector) { this.validateVector(vector, 0); } - await this.client.update({ + const request = this.client.update({ index: this.collectionName, id: vectorId, body: { @@ -385,6 +385,15 @@ export class OpenSearchDB implements VectorStore { }, refresh: this.autoRefresh, }); + try { + await request; + } catch (error: any) { + if (error?.statusCode === 404 || error?.meta?.statusCode === 404) { + return false; + } + throw error; + } + return true; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/oracledb.ts b/mem0-ts/src/oss/src/vector_stores/oracledb.ts index 46cf016b8..08c2d12a3 100644 --- a/mem0-ts/src/oss/src/vector_stores/oracledb.ts +++ b/mem0-ts/src/oss/src/vector_stores/oracledb.ts @@ -654,7 +654,7 @@ export class OracleAIVectorSearch implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); const assignments: string[] = []; @@ -670,7 +670,7 @@ export class OracleAIVectorSearch implements VectorStore { } if (assignments.length === 0) return; - await this.withConnection( + const result = await this.withConnection( (connection) => connection.execute( `UPDATE ${this.collectionName} SET ${assignments.join(", ")} WHERE id = :vector_id`, @@ -678,6 +678,8 @@ export class OracleAIVectorSearch implements VectorStore { ), true, ); + const affected = result.rowsAffected; + return typeof affected === "number" ? affected > 0 : undefined; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/pgvector.ts b/mem0-ts/src/oss/src/vector_stores/pgvector.ts index b7f2c2f69..1bd4d9a2c 100644 --- a/mem0-ts/src/oss/src/vector_stores/pgvector.ts +++ b/mem0-ts/src/oss/src/vector_stores/pgvector.ts @@ -464,10 +464,10 @@ export class PGVector implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); const vectorStr = `[${vector.join(",")}]`; - await this.client.query( + const result = await this.client.query( ` UPDATE ${this.col()} SET vector = $1::vector, payload = $2::jsonb @@ -475,6 +475,7 @@ export class PGVector implements VectorStore { `, [vectorStr, payload, vectorId], ); + return (result.rowCount ?? 0) > 0; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/pinecone.ts b/mem0-ts/src/oss/src/vector_stores/pinecone.ts index 3d8f4e851..ed6f9eb96 100644 --- a/mem0-ts/src/oss/src/vector_stores/pinecone.ts +++ b/mem0-ts/src/oss/src/vector_stores/pinecone.ts @@ -305,8 +305,11 @@ export class PineconeDB implements VectorStore { payload: Record, ): Promise { await this.initialize(); - await this.namespacedIndex().upsert({ - records: [{ id: vectorId, values: vector, metadata: payload }], + // update() never creates a missing id but does not report whether it existed. + await this.namespacedIndex().update({ + id: vectorId, + ...(vector ? { values: vector } : {}), + metadata: payload, }); } diff --git a/mem0-ts/src/oss/src/vector_stores/qdrant.ts b/mem0-ts/src/oss/src/vector_stores/qdrant.ts index e84a138f1..99f72b20c 100644 --- a/mem0-ts/src/oss/src/vector_stores/qdrant.ts +++ b/mem0-ts/src/oss/src/vector_stores/qdrant.ts @@ -319,9 +319,13 @@ export class Qdrant implements VectorStore { // named-vector and BM25-inference shapes are not typed. private async upsertPoints( points: { id: string | number; vector: any; payload?: any }[], + options: { update_mode?: "update_only" } = {}, ): Promise { try { - await this.client.upsert(this.collectionName, { points: points as any }); + await this.client.upsert(this.collectionName, { + points: points as any, + ...options, + }); } catch (error) { if (!this._hasBm25Slot) { throw error; @@ -338,6 +342,7 @@ export class Qdrant implements VectorStore { })); await this.client.upsert(this.collectionName, { points: denseOnly as any, + ...options, }); } } @@ -430,7 +435,7 @@ export class Qdrant implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); const point = { id: vectorId, @@ -439,7 +444,15 @@ export class Qdrant implements VectorStore { payload, }; - await this.upsertPoints([point]); + // One write keeps the vector and payload of concurrent updates together. + // update_only (Qdrant 1.17+) never creates a point; older servers upsert as before. + await this.upsertPoints([point], { update_mode: "update_only" }); + const found = await this.client.retrieve(this.collectionName, { + ids: [vectorId], + with_payload: false, + with_vector: false, + }); + return found.length > 0; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/redis.ts b/mem0-ts/src/oss/src/vector_stores/redis.ts index ecb326ac2..be016bada 100644 --- a/mem0-ts/src/oss/src/vector_stores/redis.ts +++ b/mem0-ts/src/oss/src/vector_stores/redis.ts @@ -122,6 +122,11 @@ const EXCLUDED_KEYS = new Set([ "updated_at", ]); +// HSET alone creates a missing hash; the script checks and writes atomically. +const HSET_IF_EXISTS = + "if redis.call('EXISTS', KEYS[1]) == 0 then return 0 end " + + "redis.call('HSET', KEYS[1], unpack(ARGV)) return 1"; + // Utility function to convert object keys to snake_case function toSnakeCase(obj: Record): Record { if (typeof obj !== "object" || obj === null) return obj; @@ -574,7 +579,7 @@ export class RedisDB implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); const snakePayload = toSnakeCase(payload); const createdAt = snakePayload.created_at @@ -589,8 +594,8 @@ export class RedisDB implements VectorStore { memory: snakePayload.data ?? "", created_at: createdAt, updated_at: updatedAt, - embedding: Buffer.from(new Float32Array(vector).buffer), }; + if (vector) entry.embedding = Buffer.from(new Float32Array(vector).buffer); // Add optional fields ["agent_id", "run_id", "user_id"].forEach((field) => { @@ -606,8 +611,40 @@ export class RedisDB implements VectorStore { ), ); + const key = `${this.indexPrefix}:${vectorId}`; try { - await this.client.hSet(`${this.indexPrefix}:${vectorId}`, entry); + const updated = await this.client + .sendCommand([ + "EVAL", + HSET_IF_EXISTS, + "1", + key, + ...Object.entries(entry).flatMap(([field, value]) => [ + field, + typeof value === "number" ? String(value) : value, + ]), + ]) + .catch(async (error: Error) => { + // ACL users without +@scripting: WATCH/MULTI is also atomic, but needs its own connection. + if (!String(error?.message).includes("NOPERM")) throw error; + const { WatchError } = await import("redis"); + return this.client.executeIsolated(async (conn) => { + for (;;) { + await conn.watch(key); + if (!(await conn.exists(key))) { + await conn.unwatch(); + return 0; + } + try { + await conn.multi().hSet(key, entry).exec(); + return 1; + } catch (e) { + if (!(e instanceof WatchError)) throw e; + } + } + }); + }); + return updated === 1; } catch (error) { console.error("Error during vector update:", error); throw error; diff --git a/mem0-ts/src/oss/src/vector_stores/upstash_vector.ts b/mem0-ts/src/oss/src/vector_stores/upstash_vector.ts index 2fa539dd6..bd627f409 100644 --- a/mem0-ts/src/oss/src/vector_stores/upstash_vector.ts +++ b/mem0-ts/src/oss/src/vector_stores/upstash_vector.ts @@ -141,19 +141,19 @@ export class UpstashVector implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); - // Upstash's `update` can't set the vector and metadata in one call (its - // payload is a discriminated union of vector | data | metadata), so a - // single `upsert` replaces both atomically, the same way insert() writes. - await this.client.upsert( + const { updated } = await this.client.update( { id: vectorId, - vector, + ...(vector ? { vector } : {}), metadata: payload, + metadataUpdateMode: "OVERWRITE", }, { namespace: this.collectionName }, ); + // 0 is not documented as "missing" and can come back for an existing id. + return typeof updated === "number" && updated > 0 ? true : undefined; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/valkey.ts b/mem0-ts/src/oss/src/vector_stores/valkey.ts index cd4f85920..61c557551 100644 --- a/mem0-ts/src/oss/src/vector_stores/valkey.ts +++ b/mem0-ts/src/oss/src/vector_stores/valkey.ts @@ -14,6 +14,16 @@ interface ValkeyClient { set: (key: string, value: string) => Promise<"OK">; quit: () => Promise<"OK">; on: (event: string, listener: (...args: any[]) => void) => void; + duplicate: () => ValkeyClient; + watch: (key: string) => Promise<"OK">; + unwatch: () => Promise<"OK">; + multi: () => { + hset: ( + key: string, + data: Record, + ) => { exec: () => Promise<[Error | null, unknown][] | null> }; + }; + disconnect: () => void; } /** @@ -36,6 +46,11 @@ const EXCLUDED_KEYS = new Set([ "updated_at", ]); +// HSET alone creates a missing hash; the script checks and writes atomically. +const HSET_IF_EXISTS = + "if redis.call('EXISTS', KEYS[1]) == 0 then return 0 end " + + "redis.call('HSET', KEYS[1], unpack(ARGV)) return 1"; + function toSnakeCase(obj: Record): Record { if (typeof obj !== "object" || obj === null) return obj; return Object.fromEntries( @@ -503,7 +518,7 @@ export class ValkeyDB implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { const snakePayload = toSnakeCase(payload); const key = `${this.indexPrefix}:${vectorId}`; @@ -518,13 +533,15 @@ export class ValkeyDB implements VectorStore { created_at: String( Math.floor(new Date(snakePayload.created_at).getTime() / 1000), ), - embedding: Buffer.from(new Float32Array(vector).buffer), metadata: JSON.stringify( Object.fromEntries( Object.entries(snakePayload).filter(([k]) => !EXCLUDED_KEYS.has(k)), ), ), }; + if (vector) { + hashData.embedding = Buffer.from(new Float32Array(vector).buffer); + } if (snakePayload.updated_at) { hashData.updated_at = String( @@ -538,7 +555,31 @@ export class ValkeyDB implements VectorStore { } } - await this.client.hset(key, hashData); + const updated = await this.client + .call("EVAL", HSET_IF_EXISTS, 1, key, ...Object.entries(hashData).flat()) + .catch(async (error: Error) => { + // ACL users without +@scripting: WATCH/MULTI is also atomic, but needs its own connection. + if (!String(error?.message).includes("NOPERM")) throw error; + const conn = this.client.duplicate(); + try { + for (;;) { + await conn.watch(key); + if (!(await conn.exists(key))) { + await conn.unwatch(); + return 0; + } + // exec() resolves to null when a watched key changed: retry. + const replies = await conn.multi().hset(key, hashData).exec(); + if (!replies) continue; + const failed = replies.find(([err]) => err); + if (failed) throw failed[0]; + return 1; + } + } finally { + conn.disconnect(); + } + }); + return updated === 1; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/src/vector_stores/weaviate.ts b/mem0-ts/src/oss/src/vector_stores/weaviate.ts index 3c7d51246..ff0a6f95c 100644 --- a/mem0-ts/src/oss/src/vector_stores/weaviate.ts +++ b/mem0-ts/src/oss/src/vector_stores/weaviate.ts @@ -189,13 +189,20 @@ export class WeaviateDB implements VectorStore { vectorId: string, vector: number[], payload: Record, - ): Promise { + ): Promise { await this.initialize(); - await this._col.data.update({ + const request = this._col.data.update({ id: vectorId, properties: payload, vectors: vector, }); + try { + await request; + } catch (error: any) { + if (error?.code === 404) return false; + throw error; + } + return true; } async delete(vectorId: string): Promise { diff --git a/mem0-ts/src/oss/tests/elasticsearch.unit.test.ts b/mem0-ts/src/oss/tests/elasticsearch.unit.test.ts index 2793bf6a5..dbffc4c33 100644 --- a/mem0-ts/src/oss/tests/elasticsearch.unit.test.ts +++ b/mem0-ts/src/oss/tests/elasticsearch.unit.test.ts @@ -365,7 +365,9 @@ describe("ElasticsearchDB", () => { host: "localhost", }); - await store.update("id-1", [1, 2, 3, 4], { key: "val" }); + expect(await store.update("id-1", [1, 2, 3, 4], { key: "val" })).toBe( + true, + ); expect(mockUpdate).toHaveBeenCalledWith({ index: "mem0", @@ -373,6 +375,35 @@ describe("ElasticsearchDB", () => { doc: { vector: [1, 2, 3, 4], metadata: { key: "val" } }, }); }); + + it("returns false and inserts nothing when the document is missing", async () => { + mockUpdate.mockRejectedValue({ meta: { statusCode: 404 } }); + const store = new ElasticsearchDB({ + collectionName: "mem0", + embeddingModelDims: 4, + host: "localhost", + }); + + expect(await store.update("missing", [1, 2, 3, 4], { k: "v" })).toBe( + false, + ); + expect(mockUpdate.mock.calls[0][0]).not.toHaveProperty("doc_as_upsert"); + expect(mockUpdate.mock.calls[0][0]).not.toHaveProperty("upsert"); + expect(mockIndex_).not.toHaveBeenCalled(); + }); + + it("sends only metadata on a payload-only update", async () => { + const store = new ElasticsearchDB({ + collectionName: "mem0", + embeddingModelDims: 4, + host: "localhost", + }); + + expect(await store.update("id-1", null, { key: "new" })).toBe(true); + expect(mockUpdate.mock.calls[0][0].doc).toEqual({ + metadata: { key: "new" }, + }); + }); }); describe("delete", () => { diff --git a/mem0-ts/src/oss/tests/memory.crud.test.ts b/mem0-ts/src/oss/tests/memory.crud.test.ts index 6e45eaa01..35f3a54f2 100644 --- a/mem0-ts/src/oss/tests/memory.crud.test.ts +++ b/mem0-ts/src/oss/tests/memory.crud.test.ts @@ -165,6 +165,30 @@ describe("Memory - update()", () => { expect(result.message).toBe("Memory updated successfully!"); }); + test("a delete that lands between get and update is not undone", async () => { + const addResult: SearchResult = await memory.add("Race me", { + userId, + infer: false, + }); + const id = addResult.results[0].id; + const store = (memory as any).vectorStore; + const realUpdate = store.update.bind(store); + const updateSpy = jest + .spyOn(store, "update") + .mockImplementationOnce(async (...args: any[]) => { + await memory.delete(id); + return realUpdate(...args); + }); + + await expect(memory.update(id, { text: "Resurrected" })).rejects.toThrow( + `Memory with ID ${id} not found`, + ); + updateSpy.mockRestore(); + expect(await memory.get(id)).toBeNull(); + const actions = (await memory.history(id)).map((h) => h.action); + expect(actions).toEqual(["DELETE", "ADD"]); + }); + test("persists the updated text", async () => { const addResult: SearchResult = await memory.add("Before update", { userId, diff --git a/mem0-ts/src/oss/tests/opensearch.unit.test.ts b/mem0-ts/src/oss/tests/opensearch.unit.test.ts index e53a1dbc0..145f5cc8b 100644 --- a/mem0-ts/src/oss/tests/opensearch.unit.test.ts +++ b/mem0-ts/src/oss/tests/opensearch.unit.test.ts @@ -154,6 +154,46 @@ describe("OpenSearchDB", () => { await expect(store.get("missing")).resolves.toBeNull(); }); + it("update returns false and inserts nothing when the document is missing (404)", async () => { + const client = createClient({ + update: jest.fn().mockRejectedValue({ meta: { statusCode: 404 } }), + }); + const store = await createStore(client); + + await expect( + store.update("missing", [0.1, 0.2, 0.3], { data: "x" }), + ).resolves.toBe(false); + expect(client.update.mock.calls[0][0].body).not.toHaveProperty( + "doc_as_upsert", + ); + expect(client.index).not.toHaveBeenCalled(); + expect(client.bulk).not.toHaveBeenCalled(); + }); + + it("update returns true and sends the same partial doc for an existing document", async () => { + const client = createClient(); + const store = await createStore(client); + + await expect( + store.update("mem-1", [0.1, 0.2, 0.3], { data: "new" }), + ).resolves.toBe(true); + expect(client.update.mock.calls[0][0].body).toEqual({ + doc: { + vector_field: [0.1, 0.2, 0.3], + payload: { data: "new" }, + id: "mem-1", + }, + }); + + await expect( + store.update("mem-1", null as any, { data: "only" }), + ).resolves.toBe(true); + expect(client.update.mock.calls[1][0].body.doc).toEqual({ + payload: { data: "only" }, + id: "mem-1", + }); + }); + it("keywordSearch queries lemmatized payload fields", async () => { const client = createClient(); const store = await createStore(client); diff --git a/mem0-ts/src/oss/tests/oracledb.unit.test.ts b/mem0-ts/src/oss/tests/oracledb.unit.test.ts index 3afdbac6e..90e8fee5b 100644 --- a/mem0-ts/src/oss/tests/oracledb.unit.test.ts +++ b/mem0-ts/src/oss/tests/oracledb.unit.test.ts @@ -411,6 +411,44 @@ describe("OracleAIVectorSearch SQL", () => { expect(results).toEqual([]); expect(count).toBe(0); }); + + function storeWithRowsAffected(calls: Call[], rowsAffected: number) { + const connection: any = fakeConnection(calls, []); + const execute = connection.execute; + connection.execute = async (sql: string, binds: any = {}) => ({ + ...(await execute(sql, binds)), + rowsAffected, + }); + return makeStore(calls, [], { client: connection }); + } + + it("returns false from update and inserts nothing when the id is missing", async () => { + const calls: Call[] = []; + const store = storeWithRowsAffected(calls, 0); + expect(await store.update("missing", [1, 2, 3], { a: 1 })).toBe(false); + expect(calls.some((c) => /^(INSERT|MERGE)/.test(c.sql))).toBe(false); + }); + + it("returns undefined from update when the driver gives no rowsAffected", async () => { + const store = storeWithRowsAffected([], undefined as any); + expect(await store.update("id-1", [1, 2, 3], { a: 1 })).toBeUndefined(); + }); + + it("returns true from update and binds the same values for an existing id", async () => { + const calls: Call[] = []; + const store = storeWithRowsAffected(calls, 1); + expect(await store.update("id-1", [1, 2, 3], { a: 1 })).toBe(true); + expect(await store.update("id-1", null as any, { b: 2 })).toBe(true); + const updates = calls.filter((c) => c.sql.startsWith("UPDATE")); + expect(updates[0].sql).toBe( + 'UPDATE "mem0" SET vector = :vector, payload = :payload WHERE id = :vector_id', + ); + expect(updates[0].binds.vector.val).toEqual(new Float32Array([1, 2, 3])); + expect(updates[0].binds.payload.val).toEqual({ a: 1 }); + expect(updates[1].sql).toBe( + 'UPDATE "mem0" SET payload = :payload WHERE id = :vector_id', + ); + }); }); describe("OracleAIVectorSearch initialization failure", () => { diff --git a/mem0-ts/src/oss/tests/pgvector.unit.test.ts b/mem0-ts/src/oss/tests/pgvector.unit.test.ts index f6f75701f..eb3035aee 100644 --- a/mem0-ts/src/oss/tests/pgvector.unit.test.ts +++ b/mem0-ts/src/oss/tests/pgvector.unit.test.ts @@ -241,4 +241,29 @@ describe("PGVector", () => { ["[1,0,0]", 4], ); }); + + test("update returns rowCount > 0 and only ever issues an UPDATE", async () => { + const store = new PGVector({ + collectionName: "memories", + connectionString: "postgresql://postgres:postgres@localhost:5432/db", + embeddingModelDims: 3, + dimension: 3, + } as any); + await store.initialize(); + const client = require("pg").__mock.clients[0]; + client.query.mockClear(); + + client.query.mockResolvedValueOnce({ rows: [], rowCount: 0 }); + expect(await store.update("missing", [1, 0, 0], { data: "x" })).toBe(false); + client.query.mockResolvedValueOnce({ rows: [], rowCount: 1 }); + expect(await store.update("a", [0, 1, 0], { data: "y" })).toBe(true); + + const queries = getClientQueries(client); + expect(queries).toHaveLength(2); + expect(queries.every((sql) => sql.trim().startsWith("UPDATE"))).toBe(true); + expect(client.query).toHaveBeenLastCalledWith( + expect.stringContaining("SET vector = $1::vector, payload = $2::jsonb"), + ["[0,1,0]", { data: "y" }, "a"], + ); + }); }); diff --git a/mem0-ts/src/oss/tests/qdrant-keyword-search.test.ts b/mem0-ts/src/oss/tests/qdrant-keyword-search.test.ts index 2746238cc..a8d1ccd31 100644 --- a/mem0-ts/src/oss/tests/qdrant-keyword-search.test.ts +++ b/mem0-ts/src/oss/tests/qdrant-keyword-search.test.ts @@ -283,6 +283,27 @@ describe("Qdrant BM25 keyword search — insert / update", () => { expect(point.vector.bm25).toBeUndefined(); }); + it("update writes vector and payload in one update_only upsert", async () => { + const { store, client } = await freshStore(); + client.retrieve.mockResolvedValueOnce([{ id: "mem-1" }]); + const payload = { data: "new", user_id: "u" }; + + await expect(store.update("mem-1", [0.4], payload)).resolves.toBe(true); + expect(client.upsert).toHaveBeenCalledTimes(1); + const body = client.upsert.mock.calls[0][1]; + expect(body.update_mode).toBe("update_only"); + expect(body.points[0]).toMatchObject({ id: "mem-1", payload }); + }); + + it("update returns false when the point is gone after the write", async () => { + const { store, client } = await freshStore(); + client.retrieve.mockResolvedValueOnce([]); + + await expect(store.update("gone", [0.1], { data: "x" })).resolves.toBe( + false, + ); + }); + it("inserts a plain dense vector (no named/sparse) on legacy collections", async () => { const client = buildMockClient( { createCollection: jest.fn().mockRejectedValue({ status: 409 }) }, @@ -485,6 +506,7 @@ describe("Qdrant BM25 keyword search — reactive downgrade on upsert failure", expect(upsert).toHaveBeenCalledTimes(2); const retryPoint = upsert.mock.calls[1][1].points[0]; expect(retryPoint.vector).toEqual([0.4, 0.5]); + expect(upsert.mock.calls[1][1].update_mode).toBe("update_only"); expect(warnSpy).toHaveBeenCalledTimes(1); expect(await store.keywordSearch("updat")).toBeNull(); }); diff --git a/mem0-ts/src/oss/tests/redis.unit.test.ts b/mem0-ts/src/oss/tests/redis.unit.test.ts index 03343b501..c3a458860 100644 --- a/mem0-ts/src/oss/tests/redis.unit.test.ts +++ b/mem0-ts/src/oss/tests/redis.unit.test.ts @@ -1,6 +1,7 @@ import { RedisDB } from "../src/vector_stores/redis"; jest.mock("redis", () => ({ + WatchError: class WatchError extends Error {}, createClient: jest.fn(() => ({ connect: jest.fn(), on: jest.fn(), @@ -12,6 +13,8 @@ jest.mock("redis", () => ({ _list: jest.fn().mockResolvedValue([]), }, hSet: jest.fn(), + sendCommand: jest.fn().mockResolvedValue(1), + executeIsolated: jest.fn(), hGetAll: jest.fn(), del: jest.fn(), exists: jest.fn(), @@ -19,6 +22,13 @@ jest.mock("redis", () => ({ })), })); +// update() sends EVAL

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%0AeiD_yrzcsU>#a$2{pb#%OqyESD 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