@agentmemory/agentmemory 0.9.25 → 0.9.27

package/AGENTS.md

@@ -117,7 +117,7 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import).
 ## Current Stats (v0.9.16)
 
 - 53 MCP tools (8 visible by default, `AGENTMEMORY_TOOLS=all` for all)
-- 126 REST endpoints
+- 128 REST endpoints
 - 6 MCP resources, 3 MCP prompts
 - 12 hooks, 4 skills
 - 50+ iii functions

package/README.md

@@ -61,7 +61,7 @@
   <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tools.svg"><img src="assets/tags/stat-tools.svg" alt="53 MCP tools" height="38" /></picture>
   <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-hooks.svg"><img src="assets/tags/stat-hooks.svg" alt="12 auto hooks" height="38" /></picture>
   <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-deps.svg"><img src="assets/tags/stat-deps.svg" alt="0 external DBs" height="38" /></picture>
-  <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tests.svg"><img src="assets/tags/stat-tests.svg" alt="950+ tests passing" height="38" /></picture>
+  <picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/stat-tests.svg"><img src="assets/tags/stat-tests.svg" alt="1,390+ tests passing" height="38" /></picture>
 </p>
 
 <p align="center">
@@ -226,7 +226,7 @@ You explain the same architecture every session. You re-discover the same bugs.
 npx @agentmemory/agentmemory
 ```
 
-> **New in v0.9.22** — Three new connect adapters (Qwen Code, Antigravity, Kiro), `AGENT_ID` multi-agent isolation with opt-in `AGENTMEMORY_AGENT_SCOPE=isolated` filtering, install ERESOLVE fixed, OpenAI thinking-model output handled, OpenCode auto-context + session creation, viewer graph settles on 1000+ nodes, 22 fixes total. Full notes in [CHANGELOG.md](CHANGELOG.md).
+Latest release notes: [CHANGELOG.md](CHANGELOG.md).
 
 ---
 
@@ -242,10 +242,10 @@ npx @agentmemory/agentmemory
 
 | Adapter | P@5 | R@5 | Top-5 hit rate | p50 latency |
 |---|---|---|---|---|
-| **agentmemory hybrid** | **0.578** | **0.967** | **15 / 15** | 14 ms |
-| grep baseline | 0.267 | 0.967 | 15 / 15 | 0 ms |
+| **agentmemory hybrid** | **0.240** | **1.000** | **15 / 15** | 14 ms |
+| grep baseline | 0.227 | 0.967 | 15 / 15 | 0 ms |
 
-100% top-5 hit rate. **2.2×** better precision than the grep baseline on identical input. Full per-type breakdown: [`docs/benchmarks/2026-05-20-coding-agent-life-v1.md`](docs/benchmarks/2026-05-20-coding-agent-life-v1.md).
+100% top-5 hit rate at the **P@5 math ceiling** for this corpus (0.240, see scorecard). Hybrid retrieves every gold session; grep misses 1 of 2 gold on the multi-session temporal query. Lift is **recall + temporal**, not aggregate precision — this benchmark is small + gold-sparse, the larger LongMemEval-S below differentiates better. Full per-type breakdown + correction note: [`docs/benchmarks/2026-05-20-coding-agent-life-v1.md`](docs/benchmarks/2026-05-20-coding-agent-life-v1.md).
 
 **LongMemEval-S** (ICLR 2025, 500 questions)
 
@@ -427,6 +427,8 @@ npx @agentmemory/agentmemory import-jsonl ~/.claude/projects/-my-project/abc123.
 
 Imported sessions show up in the Replay picker alongside native ones. Under the hood each entry routes through the `mem::replay::load`, `mem::replay::sessions`, and `mem::replay::import-jsonl` iii functions — no side-channel servers.
 
+> **Heads-up if you rely on `import-jsonl` as your primary capture path:** Claude Code's `cleanupPeriodDays` (in `~/.claude/settings.json`, default **30**) auto-deletes JSONL transcripts older than that window from `~/.claude/projects/`. If you install agentmemory fresh on a months-old Claude Code history, anything older than 30 days is already gone before the first import. Either run `import-jsonl` on a cron, raise `cleanupPeriodDays` to something higher, or wire the auto-capture hooks (the default plugin install path) so each turn lands in agentmemory while the session is live and the JSONL cleanup stops mattering.
+
 ### Upgrade / Maintenance
 
 Use the maintenance command when you intentionally want to update your local runtime:
@@ -1139,7 +1141,7 @@ Full registry: [workers.iii.dev](https://workers.iii.dev). Every worker there co
 | Prometheus / Grafana | iii OTEL + health monitor |
 | Custom plugin systems | `iii worker add <name>` |
 
-**118 source files · ~21,800 LOC · 950+ tests · 123 functions · 34 KV scopes** — all on three primitives. No `agentmemory plugin install`. The plugin system is iii itself.
+**174 source files · ~37,800 LOC · 1,390+ tests · 258 functions · 44 KV scopes** — all on three primitives. No `agentmemory plugin install`. The plugin system is iii itself.
 
 ---
 
@@ -1429,7 +1431,7 @@ Create `~/.agentmemory/.env`:
 
 <h2 id="api"><picture><source media="(prefers-color-scheme: dark)" srcset="assets/tags/light/section-api.svg"><img src="assets/tags/section-api.svg" alt="API" height="32" /></picture></h2>
 
-126 endpoints on port `3111`. The REST API binds to `127.0.0.1` by default. Protected endpoints require `Authorization: Bearer <secret>` when `AGENTMEMORY_SECRET` is set, and mesh sync endpoints require `AGENTMEMORY_SECRET` on both peers.
+128 endpoints on port `3111`. The REST API binds to `127.0.0.1` by default. Protected endpoints require `Authorization: Bearer <secret>` when `AGENTMEMORY_SECRET` is set, and mesh sync endpoints require `AGENTMEMORY_SECRET` on both peers.
 
 <details>
 <summary>Key endpoints</summary>
@@ -1463,7 +1465,7 @@ Full endpoint list: [`src/triggers/api.ts`](src/triggers/api.ts)
 ```bash
 npm run dev               # Hot reload
 npm run build             # Production build
-npm test                  # 950+ tests
+npm test                  # 1,390+ tests
 npm run test:integration  # API tests (requires running services)
 ```
 

package/dist/cli.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";iBAmNsB,kBAAA,CAAA,GAAsB,OAAA"}
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";iBAyOsB,kBAAA,CAAA,GAAsB,OAAA"}

package/dist/cli.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import { i as generateId } from "./schema-Dsr_V2Wp.mjs";
+import { i as generateId } from "./schema-CNiCWzV9.mjs";
 import { n as resolveAdapter, r as runAdapter } from "./connect-bmZ5eqYN.mjs";
 import { r as setBootVerbose } from "./logger-yHTcEBAI.mjs";
-import { t as VERSION } from "./version-C3hZKw8n.mjs";
+import { t as VERSION } from "./version-9DNrRyph.mjs";
 import { execFileSync, spawn, spawnSync } from "node:child_process";
 import { closeSync, constants, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
 import { delimiter, dirname, join } from "node:path";
@@ -878,7 +878,12 @@ Options:
   --reset            Wipe ~/.agentmemory/preferences.json and re-run onboarding
   --tools all|core   Tool visibility (default: all = 51 tools; core = 8 essentials)
   --no-engine        Skip auto-starting iii-engine
-  --port <N>         Override REST port (default: 3111)
+  --port <N>         Override REST port (default: 3111). Streams (N+1), viewer
+                     (N+2), and iii engine (N+46023) auto-derive from N so a
+                     single flag relocates the whole quartet.
+  --instance <N>     Shortcut for --port (3111 + N*100) to run multiple
+                     daemons side-by-side without env gymnastics.
+                     --instance 1 -> 3211/3212/3213/49234, etc. (max N=50)
 
 Environment:
   AGENTMEMORY_URL              Full REST base URL (e.g. http://localhost:3111).
@@ -905,6 +910,14 @@ const toolsIdx = args.indexOf("--tools");
 if (toolsIdx !== -1 && args[toolsIdx + 1]) process.env["AGENTMEMORY_TOOLS"] = args[toolsIdx + 1];
 const portIdx = args.indexOf("--port");
 if (portIdx !== -1 && args[portIdx + 1]) process.env["III_REST_PORT"] = args[portIdx + 1];
+const instanceIdx = args.indexOf("--instance");
+if (instanceIdx !== -1 && args[instanceIdx + 1]) {
+	const n = parseInt(args[instanceIdx + 1] || "", 10);
+	if (Number.isFinite(n) && n >= 0 && n <= 50) {
+		const base = 3111 + n * 100;
+		if (!process.env["III_REST_PORT"]) process.env["III_REST_PORT"] = String(base);
+	}
+}
 const skipEngine = args.includes("--no-engine");
 function getRestPort() {
 	const url = process.env["AGENTMEMORY_URL"];
@@ -948,7 +961,7 @@ function getViewerUrl() {
 	}
 }
 function getStreamPort() {
-	return parseInt(process.env["III_STREAM_PORT"] || "", 10) || parseInt(process.env["III_STREAMS_PORT"] || "", 10) || 3112;
+	return parseInt(process.env["III_STREAM_PORT"] || "", 10) || parseInt(process.env["III_STREAMS_PORT"] || "", 10) || getRestPort() + 1;
 }
 function getEnginePort() {
 	const explicit = parseInt(process.env["III_ENGINE_PORT"] || "", 10);
@@ -958,7 +971,7 @@ function getEnginePort() {
 		const parsed = new URL(url).port;
 		if (parsed) return parseInt(parsed, 10);
 	} catch {}
-	return 49134;
+	return getRestPort() + 46023;
 }
 async function isEngineRunning() {
 	try {
@@ -1175,8 +1188,8 @@ async function maybeOfferGlobalInstall() {
 	if (runCommand(npmBin, [
 		"install",
 		"-g",
-		`@agentmemory/agentmemory@0.9.25`
-	], { label: `Installing @agentmemory/agentmemory@0.9.25 globally` })) {
+		`@agentmemory/agentmemory@0.9.27`
+	], { label: `Installing @agentmemory/agentmemory@0.9.27 globally` })) {
 		p.log.success("Installed globally. `agentmemory stop` etc. will now work in new shells.");
 		writePrefs({ skipGlobalInstall: true });
 	} else p.log.warn("Global install failed. Try manually: npm install -g @agentmemory/agentmemory");
@@ -1194,7 +1207,11 @@ function detectIiiConsole() {
 	};
 	return { kind: "missing" };
 }
-const III_CONSOLE_INSTALL_CMD = "curl -fsSL https://install.iii.dev/iii/main/install.sh | sh";
+const III_CONSOLE_INSTALL_CMD = `curl -fsSL https://install.iii.dev/iii/main/install.sh | VERSION=${IIPINNED_VERSION} sh`;
+function iiiConsoleInstallHint() {
+	if (!IS_WINDOWS) return III_CONSOLE_INSTALL_CMD;
+	return `# PowerShell:\n  $env:VERSION = "${IIPINNED_VERSION}"\n  iwr -useb https://install.iii.dev/iii/main/install.sh -OutFile install.sh\n  bash install.sh   # WSL or Git Bash required\n# Or grab the pinned release directly:\n  https://github.com/iii-hq/iii/releases/tag/iii%2Fv${IIPINNED_VERSION}`;
+}
 async function ensureIiiConsole() {
 	const state = detectIiiConsole();
 	if (state.kind === "installed") return state;
@@ -1212,11 +1229,11 @@ async function ensureIiiConsole() {
 	const shBin = whichBinary("sh");
 	const curlBin = whichBinary("curl");
 	if (!shBin || !curlBin) {
-		p.log.warn(`curl or sh not found. Install manually:\n  ${III_CONSOLE_INSTALL_CMD}`);
+		p.log.warn(`curl or sh not found. Install manually:\n  ${iiiConsoleInstallHint()}`);
 		return state;
 	}
 	if (!runCommand(shBin, ["-c", III_CONSOLE_INSTALL_CMD], { label: "Installing iii console" })) {
-		p.log.warn(`iii console install failed. Re-run manually:\n  ${III_CONSOLE_INSTALL_CMD}`);
+		p.log.warn(`iii console install failed. Re-run manually:\n  ${iiiConsoleInstallHint()}`);
 		return state;
 	}
 	return detectIiiConsole();
@@ -1528,7 +1545,7 @@ function printReadyHint(consoleState) {
 	const engineHost = getEngineHost();
 	const streamUrl = `ws://${engineHost}:${getStreamPort()}`;
 	const engineUrl = `ws://${engineHost}:${getEnginePort()}`;
-	const consoleLine = consoleState.kind === "installed" ? `iii console  ${consoleState.binPath}  (run: ${consoleState.binPath} -p <port>)` : `iii console  (install: ${III_CONSOLE_INSTALL_CMD})`;
+	const consoleLine = consoleState.kind === "installed" ? `iii console  ${consoleState.binPath}  (run: ${consoleState.binPath} -p <port>)` : `iii console  (install: ${iiiConsoleInstallHint()})`;
 	const lines = [
 		`REST API     ${restUrl}`,
 		`Viewer       ${viewerUrl}`,
@@ -1548,7 +1565,7 @@ async function main() {
 	if (firstRun || IS_RESET) await runOnboarding();
 	if (skipEngine) {
 		if (IS_VERBOSE) p.log.info("Skipping engine check (--no-engine)");
-		await import("./src-fQOMXeCp.mjs");
+		await import("./src-MOg2zKJs.mjs");
 		if (await waitForAgentmemoryReady(15e3)) {
 			const consoleState = await ensureIiiConsole();
 			await maybeOfferGlobalInstall();
@@ -1568,7 +1585,7 @@ async function main() {
 			}
 		}
 		adoptRunningEngine();
-		await import("./src-fQOMXeCp.mjs");
+		await import("./src-MOg2zKJs.mjs");
 		if (await waitForAgentmemoryReady(15e3)) {
 			const consoleState = await ensureIiiConsole();
 			await maybeOfferGlobalInstall();
@@ -1595,7 +1612,7 @@ async function main() {
 			else p.log.info("No stderr was captured. Re-run with --verbose for more detail.");
 			p.note([
 				"Common causes:",
-				"  - iii-engine version mismatch — reinstall the latest binary",
+				`  - iii-engine version mismatch — reinstall the pinned v${IIPINNED_VERSION} binary`,
 				"    (sh script on macOS/Linux, GitHub release zip on Windows)",
 				"  - Docker Desktop not running (if you're using the Docker path)",
 				"  - Port already in use (see below)",
@@ -1617,7 +1634,7 @@ async function main() {
 		process.exit(1);
 	}
 	s.stop("iii-engine is ready");
-	await import("./src-fQOMXeCp.mjs");
+	await import("./src-MOg2zKJs.mjs");
 	if (await waitForAgentmemoryReady(15e3)) {
 		const consoleState = await ensureIiiConsole();
 		await maybeOfferGlobalInstall();
@@ -2525,19 +2542,19 @@ async function runStop() {
 		process.exit(1);
 	}
 	let allStopped = true;
-	for (const pid of candidates) {
+	for (const pid of workerCandidates) {
 		const s = p.spinner();
-		s.start(`Stopping iii-engine (pid ${pid})...`);
-		const ok = await signalAndWait(pid, "SIGTERM", 3e3);
-		s.stop(ok ? `Stopped pid ${pid}` : `Failed to stop pid ${pid}`);
+		s.start(`Stopping agentmemory worker (pid ${pid})... [flushing state]`);
+		const ok = await signalAndWait(pid, "SIGTERM", 5e3);
+		s.stop(ok ? `Stopped worker pid ${pid}` : `Failed to stop worker pid ${pid}`);
 		if (!ok) allStopped = false;
 	}
-	for (const pid of workerCandidates) {
-		if (candidates.has(pid)) continue;
+	for (const pid of candidates) {
+		if (workerCandidates.has(pid)) continue;
 		const s = p.spinner();
-		s.start(`Stopping agentmemory worker (pid ${pid})...`);
+		s.start(`Stopping iii-engine (pid ${pid})...`);
 		const ok = await signalAndWait(pid, "SIGTERM", 3e3);
-		s.stop(ok ? `Stopped worker pid ${pid}` : `Failed to stop worker pid ${pid}`);
+		s.stop(ok ? `Stopped pid ${pid}` : `Failed to stop pid ${pid}`);
 		if (!ok) allStopped = false;
 	}
 	clearEnginePidfile();
@@ -2550,7 +2567,7 @@ async function runStop() {
 	p.outro("Stopped. Memories persisted to disk; restart anytime with: npx @agentmemory/agentmemory");
 }
 async function runMcp() {
-	await import("./standalone-BzfA1zu8.mjs");
+	await import("./standalone-BORXC71-.mjs");
 }
 async function runConnectCmd() {
 	const { runConnect } = await import("./connect-bmZ5eqYN.mjs").then((n) => n.t);