@agentmemory/agentmemory 0.9.30 → 0.9.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentmemory/agentmemory",
-  "version": "0.9.30",
+  "version": "0.9.32",
   "description": "Persistent memory for AI coding agents, powered by iii-engine's three primitives",
   "type": "module",
   "main": "dist/index.mjs",
@@ -17,27 +17,43 @@
     "agentmemory": "dist/cli.mjs"
   },
   "scripts": {
-    "build": "tsdown && (cp iii-config.yaml dist/ 2>/dev/null || true) && (cp iii-config.docker.yaml dist/ 2>/dev/null || true) && (cp docker-compose.yml dist/ 2>/dev/null || true) && (cp .env.example dist/ 2>/dev/null || true) && mkdir -p dist/viewer && cp src/viewer/index.html dist/viewer/ && cp src/viewer/favicon.svg dist/viewer/",
+    "build": "tsdown && node scripts/copy-assets.mjs",
     "dev": "tsx src/index.ts",
     "start": "node dist/cli.mjs",
     "migrate": "node dist/functions/migrate.js",
+    "pretest": "npm run build",
     "test": "vitest run --exclude test/integration.test.ts",
     "test:watch": "vitest --exclude test/integration.test.ts",
     "test:integration": "vitest run test/integration.test.ts",
     "test:all": "vitest run",
+    "test:vector-recovery:packaged": "node scripts/release-gate/vector-recovery.mjs",
+    "test:startup:packaged": "node scripts/release-gate/startup.mjs",
+    "test:summary-recovery:packaged": "node scripts/release-gate/summary-recovery.mjs",
+    "test:cli-diagnostics:packaged": "node scripts/release-gate/cli-diagnostics.mjs",
+    "test:graph-index:packaged": "node scripts/release-gate/graph-index.mjs",
+    "test:skills:packaged": "node scripts/release-gate/skills.mjs",
+    "test:openclaw:packaged": "node scripts/release-gate/openclaw.mjs",
     "release:gate": "node scripts/release-gate/run.mjs",
+    "release:prepare": "node scripts/release/publish.mjs prepare",
+    "release:publish": "node scripts/release/publish.mjs publish",
     "skills:gen": "tsx scripts/skills/generate.ts",
     "engine:hashes": "node scripts/engine-hashes.mjs",
     "skills:check": "tsx scripts/skills/generate.ts --check && tsx scripts/skills/check.ts",
     "docs:sync": "tsx scripts/docs-sync.ts",
     "docs:check": "tsx scripts/docs-sync.ts --check",
     "plugin:pack:codex": "npm run build && node scripts/plugins/package-codex.mjs",
+    "plugin:pack:pi": "tsdown --filter pi-extension && node scripts/plugins/prepare-native.mjs && node -e \"require('node:fs').mkdirSync('dist/plugins', { recursive: true })\" && npm pack ./integrations/pi --pack-destination dist/plugins",
     "plugin:verify:published": "node scripts/plugins/verify-published.mjs",
     "test:plugin:live": "node scripts/plugins/test-live.mjs",
     "bench:load": "node --import tsx benchmark/load-100k.ts",
     "bench:capture-costs": "node --import tsx benchmark/capture-costs.ts",
-    "eval:longmemeval": "tsx eval/runner/longmemeval.ts",
-    "eval:coding-life": "tsx eval/runner/coding-life.ts"
+    "eval:longmemeval": "node --import tsx eval/runner/longmemeval.ts",
+    "eval:coding-life": "node --import tsx eval/runner/coding-life.ts",
+    "eval:lifecycle": "node --import tsx eval/runner/lifecycle.ts",
+    "eval:recall": "node --import tsx eval/runner/recall-quality.ts",
+    "eval:check": "tsc --noEmit --project tsconfig.eval.json && vitest run test/eval-adapters.test.ts test/eval-integrity.test.ts",
+    "prepack": "node scripts/plugins/prepare-native.mjs",
+    "plugin:pack:openclaw": "node scripts/plugins/prepare-native.mjs && node -e \"require('node:fs').mkdirSync('dist/plugins', { recursive: true })\" && npm pack ./integrations/openclaw --pack-destination dist/plugins"
   },
   "keywords": [
     "ai",
@@ -52,11 +68,12 @@
   ],
   "files": [
     "dist/",
+    "!dist/plugins/**",
     "plugin/",
     "integrations/pi/",
-    "iii-config.yaml",
-    "iii-config.docker.yaml",
-    "docker-compose.yml",
+    "integrations/omp/",
+    "integrations/hermes/",
+    "integrations/openclaw/",
     ".env.example",
     "LICENSE",
     "README.md",
@@ -73,10 +90,12 @@
     "@anthropic-ai/sdk": "^0.100.1",
     "@clack/prompts": "^1.2.0",
     "dotenv": "^18.0.3",
-    "@iii-dev/helpers": "0.22.1",
-    "iii-sdk": "0.22.1",
+    "@iii-dev/helpers": "0.25.0",
+    "iii-sdk": "0.25.0",
     "picocolors": "^1.1.1",
-    "zod": "^4.0.0"
+    "zod": "^4.0.0",
+    "yaml": "^2.8.1",
+    "json5": "^2.2.3"
   },
   "optionalDependencies": {
     "@huggingface/transformers": "^4.2.0",
@@ -85,10 +104,13 @@
   },
   "devDependencies": {
     "@types/node": "^26.6.2",
+    "sigstore": "4.1.1",
     "tsdown": "^0.21.10",
     "tsx": "^4.19.0",
+    "typebox": "^1.4.3",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6"
+    "vitest": "^4.1.6",
+    "ws": "^8.21.0"
   },
   "overrides": {
     "qs": "^6.15.2",

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "agentmemory",
-  "version": "0.9.30",
-  "description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 54 MCP tools, 17 skills, real-time viewer.",
+  "version": "0.9.32",
+  "description": "Persistent local memory for Claude. Hooks record prompts, tool calls and replies to a separately installed agentmemory server on your machine; skills and 54 MCP tools search and manage that memory. No outside AI provider is used unless you enable one.",
   "author": {
     "name": "Rohit Ghumare",
     "url": "https://github.com/rohitg00"
@@ -9,5 +9,18 @@
   "license": "Apache-2.0",
   "homepage": "https://github.com/rohitg00/agentmemory",
   "repository": "https://github.com/rohitg00/agentmemory",
-  "skills": ["./skills/"]
+  "skills": ["./skills/"],
+  "userConfig": {
+    "agentmemory_url": {
+      "type": "string",
+      "title": "agentmemory server URL",
+      "description": "Where the hooks and MCP server reach your agentmemory server. Leave empty to use AGENTMEMORY_URL from your environment when it is set, otherwise http://localhost:3111. A remote server must use https."
+    },
+    "agentmemory_secret": {
+      "type": "string",
+      "title": "agentmemory server secret",
+      "description": "Only needed for a remote agentmemory server. Leave empty for a server on this machine; the plugin then reads the local server's own secret and never sends it off this machine.",
+      "sensitive": true
+    }
+  }
 }

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentmemory",
-  "version": "0.9.30",
+  "version": "0.9.32",
   "description": "Local persistent memory for coding agents. Recall decisions, resume sessions, learn from corrections, and manage memory through 54 MCP tools and 17 skills. Optional capture through 6 Codex hooks.",
   "author": {
     "name": "Rohit Ghumare",
@@ -15,9 +15,10 @@
   "interface": {
     "displayName": "Agent Memory",
     "shortDescription": "Memory across coding sessions",
-    "longDescription": "Recall past decisions, resume work, save useful context, and learn from corrections across Codex and Claude Code using one local Agent Memory daemon. Includes search, session history, lessons, graph queries, memory maintenance, export, and deletion workflows. Requires Node.js 20+ and a running Agent Memory daemon. Basic keyword recall needs no model key. Embeddings and model-based features require configuration; external providers may receive selected data when enabled. Automatic capture requires trusted, supported hooks. Designed for local Codex sessions.",
+    "longDescription": "Recall past decisions, resume work, save useful context, and learn from corrections across your coding sessions using one local Agent Memory daemon. Includes search, session history, lessons, graph queries, memory maintenance, export, and deletion workflows. Requires Node.js 20+ and a running Agent Memory daemon. Basic keyword recall needs no model key. Embeddings and model-based features require configuration; external providers may receive selected data when enabled. Automatic capture requires trusted, supported hooks. Designed for local Codex sessions.",
     "developerName": "Rohit Ghumare",
-    "websiteURL": "https://github.com/rohitg00/agentmemory",
+    "websiteURL": "https://www.agent-memory.dev",
+    "privacyPolicyURL": "https://www.agent-memory.dev/privacy",
     "supportURL": "https://github.com/rohitg00/agentmemory/issues",
     "category": "Developer Tools",
     "capabilities": ["Local persistent memory", "Session handoff", "Lessons and recall", "Memory management"],

package/plugin/.devin-plugin/plugin.json

@@ -1,7 +1,9 @@
 {
   "name": "agentmemory",
-  "version": "0.9.30",
-  "description": "Persistent memory for AI coding agents. Captures sessions, recalls with hybrid BM25 + vector + graph search, and exposes 54 memory tools over MCP. Keyless by default, runs on your machine.",
+  "displayName": "agentmemory",
+  "version": "0.9.32",
+  "description": "Persistent memory for Devin CLI and Devin Desktop. Captures every session automatically, recalls with hybrid BM25 + vector + graph search, and exposes 54 memory tools over MCP. Keyless by default, runs on your machine. Not supported in cloud sessions.",
+  "logo": "assets/icon.svg",
   "author": {
     "name": "Rohit Ghumare",
     "email": "ghumare64@gmail.com"
@@ -21,11 +23,10 @@
       "command": "npx",
       "args": [
         "-y",
-        "@agentmemory/mcp"
+        "@agentmemory/mcp@0.9.32"
       ],
       "env": {
-        "AGENTMEMORY_URL": "${AGENTMEMORY_URL:-http://localhost:3111}",
-        "AGENTMEMORY_SECRET": "${AGENTMEMORY_SECRET:-}"
+        "AGENTMEMORY_URL": "${AGENTMEMORY_URL:-http://localhost:3111}"
       }
     }
   }

package/plugin/.mcp.json

@@ -2,7 +2,11 @@
   "mcpServers": {
     "agentmemory": {
       "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/plugin-bridge.mjs"]
+      "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/plugin-bridge.mjs"],
+      "env": {
+        "CLAUDE_PLUGIN_OPTION_AGENTMEMORY_URL": "${user_config.agentmemory_url}",
+        "CLAUDE_PLUGIN_OPTION_AGENTMEMORY_SECRET": "${user_config.agentmemory_secret}"
+      }
     }
   }
 }

package/plugin/README.md

@@ -0,0 +1,71 @@
+# agentmemory
+
+agentmemory gives Claude persistent memory across sessions. Its hooks record what happens in each session, and its skills and MCP tools let Claude search that history, save decisions and lessons, and pick up earlier work. Everything is stored on your own machine by default.
+
+## Install
+
+```
+/plugin install agentmemory --marketplace rohitg00/agentmemory
+```
+
+## Requirements
+
+This plugin is a client for the agentmemory server, a separate program that you install and run yourself. The 54 MCP tools, the search index and the viewer all come from that server. Without it the hooks have nowhere to send events and the tools return errors.
+
+Start the server in its own terminal with Node.js 20 or newer:
+
+```bash
+npx -y @agentmemory/agentmemory@latest
+```
+
+Keep it running while you use the plugin. Check it with `npx -y @agentmemory/agentmemory@latest status`. The server listens on `http://localhost:3111` and the viewer on `http://localhost:3113`.
+
+When you enable the plugin, Claude Code asks for two optional settings: the server URL and the server secret. Leave both empty for a local server. If the URL is empty, the plugin uses `AGENTMEMORY_URL` from your environment when it is set. Claude Code keeps the secret in your system keychain; on systems without a keychain it keeps it in `~/.claude/.credentials.json`, a file readable only by your user. The plugin sends events and the secret only to a loopback address or an `https://` URL; for a remote `http://` URL it sends nothing.
+
+## What the hooks record
+
+The plugin registers 12 Claude Code hooks. They record:
+
+- every prompt you submit, including prompts recovered from the session transcript when the session ends
+- the name, input and output of each tool call, and the error when a call fails. This includes results returned by other connectors and MCP servers
+- the final reply of the assistant and of each subagent, up to 4,000 characters
+- session start and end, subagent start, notifications and completed tasks, with the working directory
+
+Before storage, `<private>...</private>` blocks and common secret formats such as API keys and private keys are replaced with redaction markers. Long tool output is truncated.
+
+## Where it is kept and for how long
+
+The server stores everything in a local data folder:
+
+- macOS: `~/Library/Application Support/agentmemory`
+- Linux: `~/.local/share/agentmemory`
+- Windows: `%APPDATA%\agentmemory`
+
+If the server is down, hook events wait in a `capture-spool` folder inside the same data folder. The spool holds at most 5 MiB and drops events older than 7 days.
+
+Data is kept until you delete it. Each session keeps at most 500 observations by default. Memories that carry an expiry date are removed automatically after that date.
+
+## What can leave your machine
+
+By default, nothing. Search uses local keyword matching, and no LLM is called. Content leaves your machine only when you turn on one of these options on the server:
+
+- `AGENTMEMORY_LLM_PROVIDER` selects an LLM provider (Anthropic, OpenAI, Gemini, OpenRouter or MiniMax). Session summaries, consolidation and reflection then send excerpts of recorded content to it. A provider key that is already in your environment does nothing until you set this option. LLM compression of each observation stays off unless you also set `AGENTMEMORY_AUTO_COMPRESS=true`.
+- `AGENTMEMORY_ALLOW_AGENT_SDK=true`, with no provider selected, sends the same excerpts to Claude through the Claude Agent SDK.
+- `EMBEDDING_PROVIDER` set to `gemini`, `openai`, `voyage`, `cohere` or `openrouter` sends text to that service to build search vectors. `EMBEDDING_PROVIDER=local` runs on your machine after a one-time model download.
+- A Redis state backend stores records on the Redis server you configure.
+- Mesh sync sends memories to peer agentmemory servers that you register.
+
+Context injection is also off by default. The plugin prints stored memory into the conversation only when you set `AGENTMEMORY_INJECT_CONTEXT=true`.
+
+## View and delete your data
+
+- Open the viewer at `http://localhost:3113`, or run `npx -y @agentmemory/agentmemory@latest status`.
+- Export everything with the `memory_export` tool.
+- Delete single memories with the `forget` skill or the `memory_governance_delete` tool.
+- Delete everything: stop the server with `npx -y @agentmemory/agentmemory@latest stop`, then delete the data folder listed above. With a Redis state backend, also delete agentmemory's records from that Redis server, for example by flushing the Redis database you gave agentmemory.
+
+Recalled memories are evidence from past sessions, not instructions. Claude should check them before acting on them.
+
+Privacy policy: https://agent-memory.dev/privacy
+
+Source and issues: https://github.com/rohitg00/agentmemory

package/plugin/cursor/hooks.json

@@ -3,38 +3,53 @@
   "hooks": {
     "sessionStart": [
       {
-        "command": "node ${CURSOR_PLUGIN_ROOT}/plugin/scripts/session-start.mjs"
+        "command": "node \"${CURSOR_PLUGIN_ROOT}/plugin/scripts/cursor/run-hook.mjs\" sessionStart"
       }
     ],
     "beforeSubmitPrompt": [
       {
-        "command": "node ${CURSOR_PLUGIN_ROOT}/plugin/scripts/prompt-submit.mjs"
+        "command": "node \"${CURSOR_PLUGIN_ROOT}/plugin/scripts/cursor/run-hook.mjs\" beforeSubmitPrompt"
       }
     ],
     "preToolUse": [
       {
-        "command": "node ${CURSOR_PLUGIN_ROOT}/plugin/scripts/pre-tool-use.mjs",
-        "matcher": "Shell|Read|Write|Grep"
+        "matcher": "Edit|Write|Read|Glob|Grep|Shell",
+        "command": "node \"${CURSOR_PLUGIN_ROOT}/plugin/scripts/cursor/run-hook.mjs\" preToolUse"
       }
     ],
     "postToolUse": [
       {
-        "command": "node ${CURSOR_PLUGIN_ROOT}/plugin/scripts/post-tool-use.mjs"
+        "command": "node \"${CURSOR_PLUGIN_ROOT}/plugin/scripts/cursor/run-hook.mjs\" postToolUse"
       }
     ],
     "postToolUseFailure": [
       {
-        "command": "node ${CURSOR_PLUGIN_ROOT}/plugin/scripts/post-tool-failure.mjs"
+        "command": "node \"${CURSOR_PLUGIN_ROOT}/plugin/scripts/cursor/run-hook.mjs\" postToolUseFailure"
+      }
+    ],
+    "preCompact": [
+      {
+        "command": "node \"${CURSOR_PLUGIN_ROOT}/plugin/scripts/cursor/run-hook.mjs\" preCompact"
+      }
+    ],
+    "subagentStart": [
+      {
+        "command": "node \"${CURSOR_PLUGIN_ROOT}/plugin/scripts/cursor/run-hook.mjs\" subagentStart"
+      }
+    ],
+    "subagentStop": [
+      {
+        "command": "node \"${CURSOR_PLUGIN_ROOT}/plugin/scripts/cursor/run-hook.mjs\" subagentStop"
       }
     ],
     "stop": [
       {
-        "command": "node ${CURSOR_PLUGIN_ROOT}/plugin/scripts/stop.mjs"
+        "command": "node \"${CURSOR_PLUGIN_ROOT}/plugin/scripts/cursor/run-detached.mjs\" stop"
       }
     ],
     "sessionEnd": [
       {
-        "command": "node ${CURSOR_PLUGIN_ROOT}/plugin/scripts/session-end.mjs"
+        "command": "node \"${CURSOR_PLUGIN_ROOT}/plugin/scripts/cursor/run-detached.mjs\" sessionEnd"
       }
     ]
   }

package/plugin/hooks/hooks.json

@@ -5,7 +5,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/session-start.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/session-start.mjs"]
           }
         ]
       }
@@ -15,7 +16,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/prompt-submit.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/prompt-submit.mjs"]
           }
         ]
       }
@@ -26,7 +28,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-tool-use.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/pre-tool-use.mjs"]
           }
         ]
       }
@@ -36,7 +39,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/post-tool-use.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/post-tool-use.mjs"]
           }
         ]
       }
@@ -46,7 +50,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/post-tool-failure.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/post-tool-failure.mjs"]
           }
         ]
       }
@@ -56,7 +61,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-compact.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/pre-compact.mjs"]
           }
         ]
       }
@@ -66,7 +72,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/subagent-start.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/subagent-start.mjs"]
           }
         ]
       }
@@ -76,7 +83,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/subagent-stop.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/subagent-stop.mjs"]
           }
         ]
       }
@@ -86,7 +94,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/notification.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/notification.mjs"]
           }
         ]
       }
@@ -96,7 +105,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/task-completed.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/task-completed.mjs"]
           }
         ]
       }
@@ -106,7 +116,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/stop.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/stop.mjs"]
           }
         ]
       }
@@ -116,7 +127,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/session-end.mjs\""
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/session-end.mjs"]
           }
         ]
       }

package/plugin/hooks.json

@@ -0,0 +1,67 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/session-start.mjs\""
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/prompt-submit.mjs\""
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "^(exec|edit|write|read|apply_patch|grep|glob)$",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-tool-use.mjs\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/post-tool-use.mjs\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/stop.mjs\""
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/session-end.mjs\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugin/opencode/README.md

@@ -440,7 +440,7 @@ agentmemory  ──push──▶  OpenCode system prompt
 
 ### Why OpenCode goes direct
 
-agentmemory already persists everything in SQLite (`data/state_store.db`). Adding an intermediate MEMORY.md file would duplicate data, introduce sync lag, and require the model to re-parse structured context from markdown. Direct injection delivers the same data with lower latency and zero staleness — the agent always sees what agentmemory knows right now.
+agentmemory persists state through the iii state worker, using file-backed KV (`data/state_store.db`) by default or Redis when configured. Adding an intermediate MEMORY.md file would duplicate data, introduce sync lag, and require the model to re-parse structured context from markdown. Direct injection delivers the same data with lower latency and zero staleness — the agent always sees what agentmemory knows right now.
 
 ## Slash commands
 

package/plugin/opencode/agentmemory-capture.ts

@@ -1,8 +1,8 @@
 import type { Plugin } from "@opencode-ai/plugin";
 import { execFileSync } from "node:child_process";
-import { readFileSync } from "node:fs";
+import { readFileSync, realpathSync } from "node:fs";
 import { homedir } from "node:os";
-import { basename, join } from "node:path";
+import { basename, dirname, join, resolve } from "node:path";
 
 const API = process.env.AGENTMEMORY_URL || "http://localhost:3111";
 // OpenCode reports tool names in lowercase ("read", "edit", ...); matching is
@@ -116,7 +116,7 @@ async function observe(
 let activeSessionId: string | null = null;
 let pendingConfig: Record<string, unknown> | null = null;
 // Default scope resolved at plugin init (same resolution order as the hooks'
-// resolveProject: env override, git toplevel basename, cwd basename). In a
+// resolveProject: env override, git repository basename, cwd basename). In a
 // long-lived OpenCode process serving multiple directories these defaults are
 // only a fallback — attribution is per-session via sessionProjects, resolved
 // from each session's own directory at session.created. Module-level-only
@@ -138,13 +138,19 @@ function resolveProjectName(dir: string): string {
   const cached = projectNameCache.get(dir);
   if (cached !== undefined) return cached;
   try {
-    const top = execFileSync("git", ["rev-parse", "--show-toplevel"], {
-      cwd: dir,
-      stdio: ["ignore", "pipe", "ignore"],
-      encoding: "utf8",
-    }).trim();
+    const [top, gitDir, commonDir] = execFileSync(
+      "git",
+      ["rev-parse", "--show-toplevel", "--git-dir", "--git-common-dir"],
+      {
+        cwd: dir,
+        stdio: ["ignore", "pipe", "ignore"],
+        encoding: "utf8",
+      },
+    )
+      .trim()
+      .split(/\r?\n/);
     if (top) {
-      const name = basename(top);
+      const name = basename(repositoryRoot(dir, top, gitDir, commonDir));
       projectNameCache.set(dir, name);
       return name;
     }
@@ -155,6 +161,14 @@ function resolveProjectName(dir: string): string {
   projectNameCache.set(dir, fallback);
   return fallback;
 }
+
+function repositoryRoot(dir: string, top: string, gitDir?: string, commonDir?: string): string {
+  if (!gitDir || !commonDir) return top;
+  const physical = realpathSync(dir);
+  const common = resolve(physical, commonDir);
+  if (resolve(physical, gitDir) === common || basename(common) !== ".git") return top;
+  return dirname(common);
+}
 const stashedFiles = new Map<string, Set<string>>();
 const seenSubtaskIds = new Map<string, Set<string>>();
 const seenToolCallIds = new Map<string, Set<string>>();
@@ -380,7 +394,7 @@ const v1Hooks: Plugin = async (ctx) => {
           if (DEBUG) console.error("[agentmemory] session.deleted with no session ID");
           return;
         }
-        await post("/session/end", { sessionId: sid });
+        await post("/session/end", { sessionId: sid, final: true });
         post("/crystals/auto", { olderThanDays: 7 }, 30000);
         post("/consolidate-pipeline", { tier: "all", force: true }, 30000);
         if (sid === activeSessionId) activeSessionId = null;
@@ -1260,7 +1274,7 @@ async function v2Setup(ctx: any) {
       case "session.deleted": {
         const sid = (data.sessionID as string) || activeSessionId;
         if (!sid) return;
-        await post("/session/end", { sessionId: sid });
+        await post("/session/end", { sessionId: sid, final: true });
         void post("/crystals/auto", { olderThanDays: 7 }, 30000);
         void post("/consolidate-pipeline", { tier: "all", force: true }, 30000);
         if (sid === activeSessionId) activeSessionId = null;

package/plugin/opencode/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentmemory-capture",
-  "version": "0.9.30",
+  "version": "0.9.32",
   "description": "OpenCode plugin for agentmemory — full Claude Code hook parity: session lifecycle (create/idle/status/compacted/update/diff/delete/error), messages & prompts (chat.message, message.updated user+assistant, message.removed), tool lifecycle (ToolPart states with timing), part tracking (subtask, step-finish, reasoning, file, patch, compaction, agent, retry), file enrichment pipeline, permissions, task tracking (w/ priority), commands, config & model tracking. 22 hooks, 2 slash commands.",
   "author": {
     "name": "Rohit Ghumare",

package/plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentmemory",
-  "version": "0.9.30",
+  "version": "0.9.32",
   "description": "Persistent memory for AI coding agents -- captures tool usage, compresses via LLM, injects context into future sessions. 12 hooks, 54 MCP tools, 17 skills, real-time viewer.",
   "author": {
     "name": "Rohit Ghumare",

package/plugin/scripts/_capture.d.mts

@@ -1,3 +1,6 @@
+//#region src/functions/privacy.d.ts
+declare function stripPrivateData(input: string): string;
+//#endregion
 //#region src/hooks/_capture.d.ts
 declare const REST_URL: string;
 type CaptureOutcome = "delivered" | "duplicate" | "rejected" | "spooled" | "dropped";
@@ -11,6 +14,7 @@ interface ObserveBody {
   eventId?: string;
 }
 declare function authHeaders(): Record<string, string>;
+declare function transportBlocked(): boolean;
 declare function withEventId(body: ObserveBody, host: Record<string, unknown>, content?: unknown, options?: {
   stable?: boolean;
 }): ObserveBody;
@@ -18,5 +22,5 @@ declare function captureObservation(body: ObserveBody, timeoutMs: number): Promi
 declare function isDrainChild(): boolean;
 declare function runDrainChild(): Promise<void>;
 //#endregion
-export { CaptureOutcome, ObserveBody, REST_URL, authHeaders, captureObservation, isDrainChild, runDrainChild, withEventId };
+export { CaptureOutcome, ObserveBody, REST_URL, authHeaders, captureObservation, isDrainChild, runDrainChild, stripPrivateData, transportBlocked, withEventId };
 //# sourceMappingURL=_capture.d.mts.map