@agentmemory/agentmemory 0.9.10 → 0.9.12

package/README.md

@@ -107,7 +107,7 @@ agentmemory works with any agent that supports hooks, MCP, or REST API. All agen
 <td align="center" width="12.5%">
 <a href="https://github.com/openai/codex"><img src="https://github.com/openai.png?size=120" alt="Codex CLI" width="48" height="48" /></a><br/>
 <strong>Codex CLI</strong><br/>
-<sub>MCP server</sub>
+<sub>6 hooks + MCP + skills</sub>
 </td>
 <td align="center" width="12.5%">
 <a href="https://github.com/cline/cline"><img src="https://github.com/cline.png?size=120" alt="Cline" width="48" height="48" /></a><br/>
@@ -355,6 +355,25 @@ Implementation details live in `src/cli.ts` (see `runUpgrade` around the `src/cl
 Install agentmemory: run `npx @agentmemory/agentmemory` in a separate terminal to start the memory server. Then run `/plugin marketplace add rohitg00/agentmemory` and `/plugin install agentmemory` — the plugin registers all 12 hooks, 4 skills, AND auto-wires the `@agentmemory/mcp` stdio server via its `.mcp.json`, so you get 51 MCP tools (memory_smart_search, memory_save, memory_sessions, memory_governance_delete, etc.) without any extra config step. Verify with `curl http://localhost:3111/agentmemory/health`. The real-time viewer is at http://localhost:3113.
 ```
 
+### Codex CLI (Codex plugin platform)
+
+```bash
+# 1. start the memory server in a separate terminal
+npx @agentmemory/agentmemory
+
+# 2. register the agentmemory marketplace and install the plugin
+codex plugin marketplace add rohitg00/agentmemory
+codex plugin install agentmemory
+```
+
+The Codex plugin ships from the same `plugin/` directory as the Claude Code plugin. It registers:
+
+- `@agentmemory/mcp` as an MCP server (all 51 tools when `AGENTMEMORY_TOOLS=all`)
+- 6 lifecycle hooks: `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `PreCompact`, `Stop`
+- 4 skills: `/recall`, `/remember`, `/session-history`, `/forget`
+
+Codex's hook engine injects `CLAUDE_PLUGIN_ROOT` into hook subprocesses (per [`codex-rs/hooks/src/engine/discovery.rs`](https://github.com/openai/codex/blob/main/codex-rs/hooks/src/engine/discovery.rs)), so the same hook scripts work across both hosts without duplication. Subagent / SessionEnd / Notification / TaskCompleted / PostToolUseFailure events are Claude-Code-only and are not registered for Codex.
+
 <details>
 <summary><b>OpenClaw (paste this prompt)</b></summary>
 
@@ -427,7 +446,8 @@ The agentmemory entry is the **same MCP server block** across every host that us
 | **Windsurf** | `~/.codeium/windsurf/mcp_config.json` | Same `mcpServers` block. |
 | **Gemini CLI** | `~/.gemini/settings.json` | `gemini mcp add agentmemory npx -y @agentmemory/mcp --scope user` (auto-merges). |
 | **OpenClaw** | OpenClaw MCP config | Same `mcpServers` block, or use the deeper [memory plugin](integrations/openclaw/). |
-| **Codex CLI** | `.codex/config.toml` | TOML shape: `codex mcp add agentmemory -- npx -y @agentmemory/mcp`, or add `[mcp_servers.agentmemory]` manually. |
+| **Codex CLI (MCP only)** | `.codex/config.toml` | TOML shape: `codex mcp add agentmemory -- npx -y @agentmemory/mcp`, or add `[mcp_servers.agentmemory]` manually. |
+| **Codex CLI (full plugin)** | Codex plugin marketplace | `codex plugin marketplace add rohitg00/agentmemory` then `codex plugin install agentmemory`. Registers MCP + 6 lifecycle hooks (SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, PreCompact, Stop) + 4 skills. |
 | **OpenCode** | `opencode.json` | Different shape — top-level `mcp` key, command as array: `{"mcp": {"agentmemory": {"type": "local", "command": ["npx", "-y", "@agentmemory/mcp"], "enabled": true}}}`. |
 | **pi** | `~/.pi/agent/extensions/agentmemory` | Copy [`integrations/pi`](integrations/pi/) and restart pi. |
 | **Hermes Agent** | `~/.hermes/config.yaml` | Use the deeper [memory provider plugin](integrations/hermes/) with `memory.provider: agentmemory`. |

package/dist/cli.mjs

@@ -361,12 +361,12 @@ async function main() {
 	p.intro("agentmemory");
 	if (skipEngine) {
 		p.log.info("Skipping engine check (--no-engine)");
-		await import("./src-d1vwmuPU.mjs");
+		await import("./src-Cqsy23f_.mjs");
 		return;
 	}
 	if (await isEngineRunning()) {
 		p.log.success("iii-engine is running");
-		await import("./src-d1vwmuPU.mjs");
+		await import("./src-Cqsy23f_.mjs");
 		return;
 	}
 	if (!await startEngine()) {
@@ -410,7 +410,7 @@ async function main() {
 		process.exit(1);
 	}
 	s.stop("iii-engine is ready");
-	await import("./src-d1vwmuPU.mjs");
+	await import("./src-Cqsy23f_.mjs");
 }
 async function apiFetch(base, path, timeoutMs = 5e3) {
 	try {
@@ -872,7 +872,7 @@ async function runUpgrade() {
 	].join("\n"), "agentmemory upgrade");
 }
 async function runMcp() {
-	await import("./standalone-DQrqCL0s.mjs");
+	await import("./standalone-DNt6O3zG.mjs");
 }
 async function runImportJsonl() {
 	const VALUE_FLAGS = new Set(["--port", "--tools"]);

package/dist/image-refs-BkMGNmEs.mjs

@@ -0,0 +1,3 @@
+import { n as getImageRefCount, r as incrementImageRef, t as decrementImageRef } from "./src-Cqsy23f_.mjs";
+
+export { decrementImageRef, incrementImageRef };

package/dist/{image-store-BmdmQ4tI.mjs → image-store-RY_BkYWK.mjs}

@@ -1,3 +1,3 @@
-import { a as deleteImage, c as saveImageToDisk, i as IMAGES_DIR, l as touchImage, o as getMaxBytes, s as isManagedImagePath } from "./src-d1vwmuPU.mjs";
+import { a as deleteImage, c as saveImageToDisk, i as IMAGES_DIR, l as touchImage, o as getMaxBytes, s as isManagedImagePath } from "./src-Cqsy23f_.mjs";
 
 export { deleteImage, saveImageToDisk };

package/dist/index.mjs

@@ -2231,7 +2231,7 @@ var SearchIndex = class SearchIndex {
 		return this.tokenize(parts.join(" ").toLowerCase());
 	}
 	tokenize(text) {
-		return text.replace(/[^\w\s/.\-_]/g, " ").split(/\s+/).filter((t) => t.length > 1).map((t) => stem(t));
+		return text.replace(/[^\p{L}\p{N}\s/.\\-_]/gu, " ").split(/\s+/).filter((t) => t.length > 1).map((t) => stem(t));
 	}
 	getSortedTerms() {
 		if (!this.sortedTerms) this.sortedTerms = Array.from(this.invertedIndex.keys()).sort();
@@ -2530,13 +2530,55 @@ async function deleteAccessLog(kv, memoryId) {
 //#endregion
 //#region src/functions/search.ts
 let index = null;
+let vectorIndex = null;
+let currentEmbeddingProvider = null;
 function getSearchIndex() {
 	if (!index) index = new SearchIndex();
 	return index;
 }
+function setVectorIndex(idx) {
+	vectorIndex = idx;
+}
+function setEmbeddingProvider(provider) {
+	currentEmbeddingProvider = provider;
+}
+const EMBED_MAX_CHARS = 16e3;
+function clipEmbedInput(text) {
+	if (text.length <= EMBED_MAX_CHARS) return text;
+	return text.slice(0, EMBED_MAX_CHARS);
+}
+async function vectorIndexAddGuarded(id, sessionId, text, context) {
+	const vi = vectorIndex;
+	const ep = currentEmbeddingProvider;
+	if (!vi || !ep) return false;
+	try {
+		const embedding = await ep.embed(clipEmbedInput(text));
+		if (embedding.length !== ep.dimensions) {
+			logger.warn("vector-index add: dimension mismatch — skipping", {
+				kind: context.kind,
+				id: context.logId,
+				provider: ep.name,
+				expected: ep.dimensions,
+				received: embedding.length
+			});
+			return false;
+		}
+		vi.add(id, sessionId, embedding);
+		return true;
+	} catch (err) {
+		logger.warn("vector-index add: embed failed — skipping", {
+			kind: context.kind,
+			id: context.logId,
+			provider: ep.name,
+			error: err instanceof Error ? err.message : String(err)
+		});
+		return false;
+	}
+}
 async function rebuildIndex(kv) {
 	const idx = getSearchIndex();
 	idx.clear();
+	vectorIndex?.clear();
 	let count = 0;
 	try {
 		const memories = await kv.list(KV.memories);
@@ -2544,6 +2586,10 @@ async function rebuildIndex(kv) {
 			if (memory.isLatest === false) continue;
 			if (!memory.title || !memory.content) continue;
 			idx.add(memoryToObservation(memory));
+			await vectorIndexAddGuarded(memory.id, memory.sessionIds[0] ?? "memory", memory.title + " " + memory.content, {
+				kind: "memory",
+				logId: memory.id
+			});
 			count++;
 		}
 	} catch (err) {
@@ -2568,6 +2614,10 @@ async function rebuildIndex(kv) {
 	if (failedSessions.length > 0) logger.warn("rebuildIndex: failed to load observations for sessions", { failedSessions });
 	for (const observations of obsPerSession) for (const obs of observations) if (obs.title && obs.narrative) {
 		idx.add(obs);
+		await vectorIndexAddGuarded(obs.id, obs.sessionId, obs.title + " " + obs.narrative, {
+			kind: "observation",
+			logId: obs.id
+		});
 		count++;
 	}
 	return count;
@@ -2874,6 +2924,10 @@ function registerObserveFunction(sdk, kv, dedupMap, maxObservationsPerSession) {
 				const synthetic = buildSyntheticCompression(raw);
 				await kv.set(KV.observations(payload.sessionId), obsId, synthetic);
 				getSearchIndex().add(synthetic);
+				await vectorIndexAddGuarded(synthetic.id, synthetic.sessionId, synthetic.title + " " + (synthetic.narrative || ""), {
+					kind: "synthetic",
+					logId: synthetic.id
+				});
 				await sdk.trigger({
 					function_id: "stream::set",
 					payload: {
@@ -4118,7 +4172,20 @@ function registerCompressFunction(sdk, kv, provider, metricsStore) {
 				...data.raw.imageData ? { imageRef: data.raw.imageData } : {}
 			};
 			await kv.set(KV.observations(data.sessionId), data.observationId, compressed);
-			getSearchIndex().add(compressed);
+			try {
+				getSearchIndex().add(compressed);
+			} catch (err) {
+				logger.warn("Failed to index compressed observation into BM25", {
+					obsId: compressed.id,
+					sessionId: compressed.sessionId,
+					title: compressed.title,
+					error: err instanceof Error ? err.message : String(err)
+				});
+			}
+			await vectorIndexAddGuarded(compressed.id, compressed.sessionId, compressed.title + " " + (compressed.narrative || ""), {
+				kind: "observation",
+				logId: compressed.id
+			});
 			const streamResults = await Promise.allSettled([sdk.trigger({
 				function_id: "stream::set",
 				payload: {
@@ -4958,6 +5025,10 @@ function registerRememberFunction(sdk, kv) {
 					error: err instanceof Error ? err.message : String(err)
 				});
 			}
+			await vectorIndexAddGuarded(memory.id, memory.sessionIds[0] ?? "memory", memory.title + " " + memory.content, {
+				kind: "memory",
+				logId: memory.id
+			});
 			if (supersededId) await sdk.trigger({
 				function_id: "mem::cascade-update",
 				payload: { supersededMemoryId: supersededId },
@@ -5755,7 +5826,7 @@ function registerAutoForgetFunction(sdk, kv) {
 
 //#endregion
 //#region src/version.ts
-const VERSION = "0.9.10";
+const VERSION = "0.9.12";
 
 //#endregion
 //#region src/functions/export-import.ts
@@ -5883,7 +5954,9 @@ function registerExportImportFunction(sdk, kv) {
 			"0.9.7",
 			"0.9.8",
 			"0.9.9",
-			"0.9.10"
+			"0.9.10",
+			"0.9.11",
+			"0.9.12"
 		]).has(importData.version)) return {
 			success: false,
 			error: `Unsupported export version: ${importData.version}`
@@ -19450,6 +19523,8 @@ async function main() {
 	const metricsStore = new MetricsStore(kv);
 	const dedupMap = new DedupMap();
 	const vectorIndex = embeddingProvider ? new VectorIndex() : null;
+	setVectorIndex(vectorIndex);
+	setEmbeddingProvider(embeddingProvider);
 	initMetrics(hasGetMeter(sdk) ? sdk.getMeter.bind(sdk) : void 0);
 	registerPrivacyFunction(sdk);
 	registerObserveFunction(sdk, kv, dedupMap, config.maxObservationsPerSession);