@agentmemory/agentmemory 0.7.0 → 0.7.2

package/AGENTS.md

@@ -110,4 +110,4 @@ Hook scripts in `src/hooks/` are standalone Node.js scripts (no iii-sdk import).
 - 6 MCP resources, 3 MCP prompts
 - 12 hooks, 4 skills
 - 50+ iii functions
-- 573 tests
+- 581 tests

package/README.md

@@ -26,14 +26,12 @@
 
 ---
 
-Every AI coding agent has the same blind spot. Session ends, memory vanishes. You re-explain architecture. You re-discover bugs. You re-teach preferences. Built-in memory files like CLAUDE.md and .cursorrules are 200-line sticky notes that overflow and go stale. agentmemory replaces that with a searchable, versioned, cross-agent database — 41 MCP tools, triple-stream retrieval (BM25 + vector + knowledge graph), 4-tier memory consolidation, provenance-tracked citations, and cascading staleness so retired facts never pollute your context again. One instance serves Claude Code, Cursor, Codex, Windsurf, and any MCP client simultaneously. 573 tests. Zero external DB dependencies.
+Every AI coding agent has the same blind spot. Session ends, memory vanishes. You re-explain architecture. You re-discover bugs. You re-teach preferences. Built-in memory files like CLAUDE.md and .cursorrules are 200-line sticky notes that overflow and go stale. agentmemory replaces that with a searchable, versioned, cross-agent database — 41 MCP tools, triple-stream retrieval (BM25 + vector + knowledge graph), 4-tier memory consolidation, provenance-tracked citations, and cascading staleness so retired facts never pollute your context again. One instance serves Claude Code, Cursor, Codex, Windsurf, and any MCP client simultaneously. 581 tests. Zero external DB dependencies.
 
 The result is measurable. On 240 real observations across 30 sessions, agentmemory hits 64% Recall@10 and perfect MRR while using 92% fewer tokens than dumping everything into context. When an agent searches "database performance optimization," it finds the N+1 fix you made three weeks ago — something keyword grep literally cannot do. Memories version automatically, supersede each other, propagate staleness to related graph nodes, and sync across agent instances via P2P mesh. Your agents stop repeating mistakes. Your context stays clean. Your sessions start fast.
 
 ```bash
-git clone https://github.com/rohitg00/agentmemory.git && cd agentmemory
-docker compose up -d && npm install && npm run build && npm start
-curl http://localhost:3111/agentmemory/health
+npx @agentmemory/agentmemory   # installs iii-engine if missing, starts everything
 ```
 
 ---
@@ -162,8 +160,8 @@ GET  /agentmemory/profile       # Get project intelligence
 |---|---|
 | Claude Code user | Plugin install (hooks + MCP + skills) |
 | Building a custom agent with Claude SDK | AgentSDKProvider (zero config) |
-| Using Cursor, Windsurf, or any MCP client | MCP server (38 tools + 6 resources + 3 prompts) |
-| Building your own agent framework | REST API (93 endpoints) |
+| Using Cursor, Windsurf, or any MCP client | MCP server (41 tools + 6 resources + 3 prompts) |
+| Building your own agent framework | REST API (100 endpoints) |
 | Sharing memory across multiple agents | All agents point to the same iii-engine instance |
 
 ## Quick Start
@@ -177,17 +175,22 @@ GET  /agentmemory/profile       # Get project intelligence
 
 All 12 hooks, 4 skills, and MCP server are registered automatically.
 
-### 2. Start the Worker
+### 2. Start agentmemory
 
 ```bash
-git clone https://github.com/rohitg00/agentmemory.git
-cd agentmemory
+npx @agentmemory/agentmemory
+```
+
+This auto-installs iii-engine if missing, starts it, and runs the worker. One command.
+
+Or from source:
 
-docker compose up -d       # Start iii-engine
+```bash
+git clone https://github.com/rohitg00/agentmemory.git && cd agentmemory
 npm install && npm run build && npm start
 ```
 
-### 3. Verify
+### 4. Verify
 
 ```bash
 curl http://localhost:3111/agentmemory/health
@@ -200,7 +203,7 @@ open http://localhost:3113
 {
   "status": "healthy",
   "service": "agentmemory",
-  "version": "0.6.1",
+  "version": "0.7.1",
   "health": {
     "memory": { "heapUsed": 42000000, "heapTotal": 67000000 },
     "cpu": { "percent": 2.1 },
@@ -604,9 +607,18 @@ ANTHROPIC_API_KEY=sk-ant-...
 # GRAPH_EXTRACTION_BATCH_SIZE=10
 
 # Consolidation Pipeline (v0.5.0)
-# CONSOLIDATION_ENABLED=false
+# CONSOLIDATION_ENABLED=true
 # CONSOLIDATION_DECAY_DAYS=30
 
+# Lesson Decay (v0.7.0)
+# LESSON_DECAY_ENABLED=true
+
+# Obsidian Export (v0.7.0)
+# OBSIDIAN_AUTO_EXPORT=false
+
+# MCP Tool Visibility (v0.7.0) — "core" (7 tools) or "all" (41 tools)
+# AGENTMEMORY_TOOLS=core
+
 # Team Memory (v0.5.0)
 # TEAM_ID=
 # USER_ID=
@@ -667,6 +679,11 @@ ANTHROPIC_API_KEY=sk-ant-...
 | `GET` | `/agentmemory/snapshots` | List git snapshots |
 | `POST` | `/agentmemory/snapshot/create` | Create git-versioned snapshot |
 | `POST` | `/agentmemory/snapshot/restore` | Restore from snapshot commit |
+| `POST` | `/agentmemory/lessons` | Save a lesson (returns 201 if created, 200 if strengthened) |
+| `GET` | `/agentmemory/lessons` | List lessons (`?project=X&minConfidence=0.5`) |
+| `POST` | `/agentmemory/lessons/search` | Search lessons by query |
+| `POST` | `/agentmemory/lessons/strengthen` | Reinforce a lesson's confidence |
+| `POST` | `/agentmemory/obsidian/export` | Export vault as Obsidian Markdown |
 | `GET` | `/agentmemory/mcp/tools` | List MCP tools |
 | `POST` | `/agentmemory/mcp/call` | Execute MCP tool |
 | `GET` | `/agentmemory/mcp/resources` | List MCP resources |
@@ -707,9 +724,9 @@ agentmemory is built on iii-engine's three primitives:
 | Prometheus / Grafana | iii OTEL + built-in health monitor |
 | Redis (circuit breaker) | In-process circuit breaker + fallback chain |
 
-**105+ source files. ~16,000 LOC. 573 tests. Zero external DB dependencies.**
+**113 source files. ~20,000 LOC. 581 tests. Zero external DB dependencies.**
 
-### Functions (52)
+### Functions (57)
 
 | Function | Purpose |
 |----------|---------|
@@ -734,7 +751,7 @@ agentmemory is built on iii-engine's three primitives:
 | `mem::profile` | Aggregate project profile |
 | `mem::auto-forget` | TTL expiry + contradiction detection |
 | `mem::enrich` | Unified enrichment (file context + observations + bug memories) |
-| `mem::export` / `mem::import` | Full JSON round-trip (v0.3.0 + v0.4.0 + v0.5.0 formats) |
+| `mem::export` / `mem::import` | Full JSON round-trip (v0.3.0 – v0.7.0 formats, includes lessons) |
 | `mem::claude-bridge-read` | Read Claude Code native MEMORY.md |
 | `mem::claude-bridge-sync` | Sync top memories back to MEMORY.md |
 | `mem::graph-extract` | LLM-powered entity extraction from observations |
@@ -770,8 +787,11 @@ agentmemory is built on iii-engine's three primitives:
 | `mem::graph-retrieval` | Entity search + chunk expansion + temporal queries via knowledge graph |
 | `mem::verify` | JIT verification — trace memory provenance back to source observations |
 | `mem::cascade-update` | Propagate staleness to graph nodes, edges, and sibling memories |
+| `mem::lesson-save` / `recall` / `list` | Confidence-scored lessons with dedup, reinforcement, and decay |
+| `mem::lesson-strengthen` / `decay-sweep` | Reinforce lessons on reuse, sweep for time-based decay |
+| `mem::obsidian-export` | Export vault as Obsidian-compatible Markdown with YAML frontmatter + wikilinks |
 
-### Data Model (33 KV scopes)
+### Data Model (34 KV scopes)
 
 | Scope | Stores |
 |-------|--------|
@@ -808,20 +828,21 @@ agentmemory is built on iii-engine's three primitives:
 | `mem:sketches` | Ephemeral action graphs |
 | `mem:crystals` | Compacted action chain digests |
 | `mem:facets` | Multi-dimensional tags |
+| `mem:lessons` | Confidence-scored lessons with decay |
 
 ## Development
 
 ```bash
 npm run dev               # Hot reload
-npm run build             # Production build (365KB)
-npm test                  # Unit tests (573 tests, ~1.5s)
+npm run build             # Production build (~425KB)
+npm test                  # Unit tests (581 tests, ~1.5s)
 npm run test:integration  # API tests (requires running services)
 ```
 
 ### Prerequisites
 
-- Node.js >= 18
-- Docker
+- Node.js >= 20
+- [iii-engine](https://iii.dev/docs) (`curl -fsSL https://install.iii.dev/iii/main/install.sh | sh`)
 
 ## License
 

package/dist/cli.mjs

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
-import { execFileSync, spawn } from "node:child_process";
+import { execFileSync, execSync, spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import * as p from "@clack/prompts";
 
 //#region src/cli.ts
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -20,14 +21,14 @@ Options:
   --port <N>         Override REST port (default: 3111)
 
 Environment:
-  AGENTMEMORY_TOOLS=all    Expose all 41 MCP tools
-  AGENTMEMORY_SECRET=xxx   Auth secret for REST/MCP
+  AGENTMEMORY_TOOLS=all        Expose all 41 MCP tools
+  AGENTMEMORY_SECRET=xxx       Auth secret for REST/MCP
   CONSOLIDATION_ENABLED=true   Enable auto-consolidation (off by default)
   OBSIDIAN_AUTO_EXPORT=true    Auto-export on consolidation
 
 Quick start:
-  npx agentmemory             # auto-starts iii-engine, runs worker
-  npx agentmemory-mcp         # standalone MCP server (no engine needed)
+  npx @agentmemory/agentmemory    # installs iii if missing, starts everything
+  npx agentmemory-mcp             # standalone MCP server (no engine needed)
 `);
 	process.exit(0);
 }
@@ -63,23 +64,74 @@ function whichBinary(name) {
 		return null;
 	}
 }
+async function installIii() {
+	if (process.platform === "win32") {
+		p.log.warn("Automatic iii-engine install is not supported on Windows.");
+		p.log.info("Install manually: https://iii.dev/docs");
+		return false;
+	}
+	if (!whichBinary("curl")) {
+		p.log.warn("curl not found — cannot auto-install iii-engine.");
+		return false;
+	}
+	const shouldInstall = await p.confirm({
+		message: "iii-engine is not installed. Install it now?",
+		initialValue: true
+	});
+	if (p.isCancel(shouldInstall) || !shouldInstall) return false;
+	const s = p.spinner();
+	s.start("Installing iii-engine...");
+	try {
+		execSync("curl -fsSL https://install.iii.dev/iii/main/install.sh | sh", {
+			stdio: [
+				"pipe",
+				"pipe",
+				"pipe"
+			],
+			timeout: 12e4
+		});
+		if (whichBinary("iii")) {
+			s.stop("iii-engine installed successfully");
+			return true;
+		}
+		s.stop("Installation completed but iii not found in PATH");
+		p.log.warn("You may need to restart your shell or add iii to your PATH.");
+		const iiiPaths = [join(process.env["HOME"] || "", ".local", "bin", "iii"), "/usr/local/bin/iii"];
+		for (const iiiPath of iiiPaths) if (existsSync(iiiPath)) {
+			p.log.info(`Found iii at: ${iiiPath}`);
+			process.env["PATH"] = `${dirname(iiiPath)}:${process.env["PATH"]}`;
+			return true;
+		}
+		return false;
+	} catch (err) {
+		s.stop("Failed to install iii-engine");
+		p.log.error(err instanceof Error ? err.message : String(err));
+		return false;
+	}
+}
 async function startEngine() {
 	const configPath = findIiiConfig();
-	const iiiBin = whichBinary("iii");
+	let iiiBin = whichBinary("iii");
+	if (!iiiBin) {
+		if (await installIii()) iiiBin = whichBinary("iii");
+	}
 	if (iiiBin && configPath) {
-		console.log(`[agentmemory] Starting iii-engine: ${iiiBin} --config ${configPath}`);
+		const s = p.spinner();
+		s.start(`Starting iii-engine: ${iiiBin}`);
 		spawn(iiiBin, ["--config", configPath], {
 			detached: true,
 			stdio: "ignore"
 		}).unref();
+		s.stop("iii-engine process started");
 		return true;
 	}
+	const dockerBin = whichBinary("docker");
 	const dockerCompose = join(__dirname, "..", "docker-compose.yml");
 	const dcExists = existsSync(dockerCompose) || existsSync(join(process.cwd(), "docker-compose.yml"));
-	const dockerBin = whichBinary("docker");
 	if (dockerBin && dcExists) {
 		const composeFile = existsSync(dockerCompose) ? dockerCompose : join(process.cwd(), "docker-compose.yml");
-		console.log(`[agentmemory] Starting iii-engine via Docker...`);
+		const s = p.spinner();
+		s.start("Starting iii-engine via Docker...");
 		spawn(dockerBin, [
 			"compose",
 			"-f",
@@ -90,6 +142,7 @@ async function startEngine() {
 			detached: true,
 			stdio: "ignore"
 		}).unref();
+		s.stop("Docker compose started");
 		return true;
 	}
 	return false;
@@ -103,32 +156,46 @@ async function waitForEngine(timeoutMs) {
 	return false;
 }
 async function main() {
-	if (!skipEngine && !await isEngineRunning()) {
-		if (!await startEngine()) {
-			console.error(`
-[agentmemory] iii-engine is not running and could not be auto-started.
-
-Install one of:
-  1. iii CLI:    npm install -g iii-engine
-  2. Docker:     docker compose up -d (with docker-compose.yml)
-
-Or run with --no-engine to connect to a remote engine.
-`);
-			process.exit(1);
-		}
-		console.log(`[agentmemory] Waiting for iii-engine to start...`);
-		if (!await waitForEngine(15e3)) {
-			const port = getRestPort();
-			console.error(`[agentmemory] iii-engine did not become ready within 15s.`);
-			console.error(`[agentmemory] Check that ports ${port}, ${port + 1}, 49134 are available.`);
-			process.exit(1);
-		}
-		console.log(`[agentmemory] iii-engine is ready.`);
+	p.intro("agentmemory");
+	if (skipEngine) {
+		p.log.info("Skipping engine check (--no-engine)");
+		await import("./src-1fTKFEtN.mjs");
+		return;
+	}
+	if (await isEngineRunning()) {
+		p.log.success("iii-engine is running");
+		await import("./src-1fTKFEtN.mjs");
+		return;
+	}
+	if (!await startEngine()) {
+		p.log.error("Could not start iii-engine.");
+		p.note([
+			"Install iii-engine (pick one):",
+			"  curl -fsSL https://install.iii.dev/iii/main/install.sh | sh",
+			"  cargo install iii-engine",
+			"",
+			"Or use Docker:",
+			"  docker pull iiidev/iii:latest",
+			"",
+			"Docs: https://iii.dev/docs",
+			"",
+			"Or skip with: agentmemory --no-engine"
+		].join("\n"), "Setup required");
+		process.exit(1);
+	}
+	const s = p.spinner();
+	s.start("Waiting for iii-engine to be ready...");
+	if (!await waitForEngine(15e3)) {
+		const port = getRestPort();
+		s.stop("iii-engine did not become ready within 15s");
+		p.log.error(`Check that ports ${port}, ${port + 1}, 49134 are available.`);
+		process.exit(1);
 	}
-	await import("./src-QxitMPfJ.mjs");
+	s.stop("iii-engine is ready");
+	await import("./src-1fTKFEtN.mjs");
 }
 main().catch((err) => {
-	console.error(`[agentmemory] Fatal:`, err);
+	p.log.error(err instanceof Error ? err.message : String(err));
 	process.exit(1);
 });
 

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { spawn, execFileSync } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n\nconst args = process.argv.slice(2);\n\nif (args.includes(\"--help\") || args.includes(\"-h\")) {\n  console.log(`\nagentmemory — persistent memory for AI coding agents\n\nUsage: agentmemory [options]\n\nOptions:\n  --help, -h         Show this help\n  --tools all|core   Tool visibility (default: core = 7 tools)\n  --no-engine        Skip auto-starting iii-engine\n  --port <N>         Override REST port (default: 3111)\n\nEnvironment:\n  AGENTMEMORY_TOOLS=all    Expose all 41 MCP tools\n  AGENTMEMORY_SECRET=xxx   Auth secret for REST/MCP\n  CONSOLIDATION_ENABLED=true   Enable auto-consolidation (off by default)\n  OBSIDIAN_AUTO_EXPORT=true    Auto-export on consolidation\n\nQuick start:\n  npx agentmemory             # auto-starts iii-engine, runs worker\n  npx agentmemory-mcp         # standalone MCP server (no engine needed)\n`);\n  process.exit(0);\n}\n\nconst toolsIdx = args.indexOf(\"--tools\");\nif (toolsIdx !== -1 && args[toolsIdx + 1]) {\n  process.env[\"AGENTMEMORY_TOOLS\"] = args[toolsIdx + 1];\n}\n\nconst portIdx = args.indexOf(\"--port\");\nif (portIdx !== -1 && args[portIdx + 1]) {\n  process.env[\"III_REST_PORT\"] = args[portIdx + 1];\n}\n\nconst skipEngine = args.includes(\"--no-engine\");\n\nfunction getRestPort(): number {\n  return parseInt(process.env[\"III_REST_PORT\"] || \"3111\", 10) || 3111;\n}\n\nasync function isEngineRunning(): Promise<boolean> {\n  try {\n    const res = await fetch(`http://localhost:${getRestPort()}/agentmemory/livez`, {\n      signal: AbortSignal.timeout(2000),\n    });\n    return res.ok;\n  } catch {\n    return false;\n  }\n}\n\nfunction findIiiConfig(): string {\n  const candidates = [\n    join(__dirname, \"iii-config.yaml\"),\n    join(__dirname, \"..\", \"iii-config.yaml\"),\n    join(process.cwd(), \"iii-config.yaml\"),\n  ];\n  for (const c of candidates) {\n    if (existsSync(c)) return c;\n  }\n  return \"\";\n}\n\nfunction whichBinary(name: string): string | null {\n  const cmd = process.platform === \"win32\" ? \"where\" : \"which\";\n  try {\n    return execFileSync(cmd, [name], { encoding: \"utf-8\" }).trim().split(\"\\n\")[0];\n  } catch {\n    return null;\n  }\n}\n\nasync function startEngine(): Promise<boolean> {\n  const configPath = findIiiConfig();\n\n  const iiiBin = whichBinary(\"iii\");\n  if (iiiBin && configPath) {\n    console.log(`[agentmemory] Starting iii-engine: ${iiiBin} --config ${configPath}`);\n    const child = spawn(iiiBin, [\"--config\", configPath], {\n      detached: true,\n      stdio: \"ignore\",\n    });\n    child.unref();\n    return true;\n  }\n\n  const dockerCompose = join(__dirname, \"..\", \"docker-compose.yml\");\n  const dcExists = existsSync(dockerCompose) || existsSync(join(process.cwd(), \"docker-compose.yml\"));\n  const dockerBin = whichBinary(\"docker\");\n\n  if (dockerBin && dcExists) {\n    const composeFile = existsSync(dockerCompose) ? dockerCompose : join(process.cwd(), \"docker-compose.yml\");\n    console.log(`[agentmemory] Starting iii-engine via Docker...`);\n    const child = spawn(dockerBin, [\"compose\", \"-f\", composeFile, \"up\", \"-d\"], {\n      detached: true,\n      stdio: \"ignore\",\n    });\n    child.unref();\n    return true;\n  }\n\n  return false;\n}\n\nasync function waitForEngine(timeoutMs: number): Promise<boolean> {\n  const start = Date.now();\n  while (Date.now() - start < timeoutMs) {\n    if (await isEngineRunning()) return true;\n    await new Promise((r) => setTimeout(r, 500));\n  }\n  return false;\n}\n\nasync function main() {\n  if (!skipEngine && !(await isEngineRunning())) {\n    const started = await startEngine();\n    if (!started) {\n      console.error(`\n[agentmemory] iii-engine is not running and could not be auto-started.\n\nInstall one of:\n  1. iii CLI:    npm install -g iii-engine\n  2. Docker:     docker compose up -d (with docker-compose.yml)\n\nOr run with --no-engine to connect to a remote engine.\n`);\n      process.exit(1);\n    }\n\n    console.log(`[agentmemory] Waiting for iii-engine to start...`);\n    const ready = await waitForEngine(15000);\n    if (!ready) {\n      const port = getRestPort();\n      console.error(`[agentmemory] iii-engine did not become ready within 15s.`);\n      console.error(`[agentmemory] Check that ports ${port}, ${port + 1}, 49134 are available.`);\n      process.exit(1);\n    }\n    console.log(`[agentmemory] iii-engine is ready.`);\n  }\n\n  await import(\"./index.js\");\n}\n\nmain().catch((err) => {\n  console.error(`[agentmemory] Fatal:`, err);\n  process.exit(1);\n});\n"],"mappings":"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"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { spawn, execFileSync, execSync } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport * as p from \"@clack/prompts\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\nconst args = process.argv.slice(2);\n\nif (args.includes(\"--help\") || args.includes(\"-h\")) {\n  console.log(`\nagentmemory — persistent memory for AI coding agents\n\nUsage: agentmemory [options]\n\nOptions:\n  --help, -h         Show this help\n  --tools all|core   Tool visibility (default: core = 7 tools)\n  --no-engine        Skip auto-starting iii-engine\n  --port <N>         Override REST port (default: 3111)\n\nEnvironment:\n  AGENTMEMORY_TOOLS=all        Expose all 41 MCP tools\n  AGENTMEMORY_SECRET=xxx       Auth secret for REST/MCP\n  CONSOLIDATION_ENABLED=true   Enable auto-consolidation (off by default)\n  OBSIDIAN_AUTO_EXPORT=true    Auto-export on consolidation\n\nQuick start:\n  npx @agentmemory/agentmemory    # installs iii if missing, starts everything\n  npx agentmemory-mcp             # standalone MCP server (no engine needed)\n`);\n  process.exit(0);\n}\n\nconst toolsIdx = args.indexOf(\"--tools\");\nif (toolsIdx !== -1 && args[toolsIdx + 1]) {\n  process.env[\"AGENTMEMORY_TOOLS\"] = args[toolsIdx + 1];\n}\n\nconst portIdx = args.indexOf(\"--port\");\nif (portIdx !== -1 && args[portIdx + 1]) {\n  process.env[\"III_REST_PORT\"] = args[portIdx + 1];\n}\n\nconst skipEngine = args.includes(\"--no-engine\");\n\nfunction getRestPort(): number {\n  return parseInt(process.env[\"III_REST_PORT\"] || \"3111\", 10) || 3111;\n}\n\nasync function isEngineRunning(): Promise<boolean> {\n  try {\n    const res = await fetch(`http://localhost:${getRestPort()}/agentmemory/livez`, {\n      signal: AbortSignal.timeout(2000),\n    });\n    return res.ok;\n  } catch {\n    return false;\n  }\n}\n\nfunction findIiiConfig(): string {\n  const candidates = [\n    join(__dirname, \"iii-config.yaml\"),\n    join(__dirname, \"..\", \"iii-config.yaml\"),\n    join(process.cwd(), \"iii-config.yaml\"),\n  ];\n  for (const c of candidates) {\n    if (existsSync(c)) return c;\n  }\n  return \"\";\n}\n\nfunction whichBinary(name: string): string | null {\n  const cmd = process.platform === \"win32\" ? \"where\" : \"which\";\n  try {\n    return execFileSync(cmd, [name], { encoding: \"utf-8\" }).trim().split(\"\\n\")[0];\n  } catch {\n    return null;\n  }\n}\n\nasync function installIii(): Promise<boolean> {\n  if (process.platform === \"win32\") {\n    p.log.warn(\"Automatic iii-engine install is not supported on Windows.\");\n    p.log.info(\"Install manually: https://iii.dev/docs\");\n    return false;\n  }\n\n  const curlBin = whichBinary(\"curl\");\n  if (!curlBin) {\n    p.log.warn(\"curl not found — cannot auto-install iii-engine.\");\n    return false;\n  }\n\n  const shouldInstall = await p.confirm({\n    message: \"iii-engine is not installed. Install it now?\",\n    initialValue: true,\n  });\n\n  if (p.isCancel(shouldInstall) || !shouldInstall) {\n    return false;\n  }\n\n  const s = p.spinner();\n  s.start(\"Installing iii-engine...\");\n\n  try {\n    execSync(\"curl -fsSL https://install.iii.dev/iii/main/install.sh | sh\", {\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n      timeout: 120000,\n    });\n\n    const installed = whichBinary(\"iii\");\n    if (installed) {\n      s.stop(\"iii-engine installed successfully\");\n      return true;\n    }\n\n    s.stop(\"Installation completed but iii not found in PATH\");\n    p.log.warn(\"You may need to restart your shell or add iii to your PATH.\");\n\n    const iiiPaths = [\n      join(process.env[\"HOME\"] || \"\", \".local\", \"bin\", \"iii\"),\n      \"/usr/local/bin/iii\",\n    ];\n    for (const iiiPath of iiiPaths) {\n      if (existsSync(iiiPath)) {\n        p.log.info(`Found iii at: ${iiiPath}`);\n        process.env[\"PATH\"] = `${dirname(iiiPath)}:${process.env[\"PATH\"]}`;\n        return true;\n      }\n    }\n\n    return false;\n  } catch (err) {\n    s.stop(\"Failed to install iii-engine\");\n    p.log.error(err instanceof Error ? err.message : String(err));\n    return false;\n  }\n}\n\nasync function startEngine(): Promise<boolean> {\n  const configPath = findIiiConfig();\n  let iiiBin = whichBinary(\"iii\");\n\n  if (!iiiBin) {\n    const installed = await installIii();\n    if (installed) {\n      iiiBin = whichBinary(\"iii\");\n    }\n  }\n\n  if (iiiBin && configPath) {\n    const s = p.spinner();\n    s.start(`Starting iii-engine: ${iiiBin}`);\n    const child = spawn(iiiBin, [\"--config\", configPath], {\n      detached: true,\n      stdio: \"ignore\",\n    });\n    child.unref();\n    s.stop(\"iii-engine process started\");\n    return true;\n  }\n\n  const dockerBin = whichBinary(\"docker\");\n  const dockerCompose = join(__dirname, \"..\", \"docker-compose.yml\");\n  const dcExists = existsSync(dockerCompose) || existsSync(join(process.cwd(), \"docker-compose.yml\"));\n\n  if (dockerBin && dcExists) {\n    const composeFile = existsSync(dockerCompose) ? dockerCompose : join(process.cwd(), \"docker-compose.yml\");\n    const s = p.spinner();\n    s.start(\"Starting iii-engine via Docker...\");\n    const child = spawn(dockerBin, [\"compose\", \"-f\", composeFile, \"up\", \"-d\"], {\n      detached: true,\n      stdio: \"ignore\",\n    });\n    child.unref();\n    s.stop(\"Docker compose started\");\n    return true;\n  }\n\n  return false;\n}\n\nasync function waitForEngine(timeoutMs: number): Promise<boolean> {\n  const start = Date.now();\n  while (Date.now() - start < timeoutMs) {\n    if (await isEngineRunning()) return true;\n    await new Promise((r) => setTimeout(r, 500));\n  }\n  return false;\n}\n\nasync function main() {\n  p.intro(\"agentmemory\");\n\n  if (skipEngine) {\n    p.log.info(\"Skipping engine check (--no-engine)\");\n    await import(\"./index.js\");\n    return;\n  }\n\n  if (await isEngineRunning()) {\n    p.log.success(\"iii-engine is running\");\n    await import(\"./index.js\");\n    return;\n  }\n\n  const started = await startEngine();\n  if (!started) {\n    p.log.error(\"Could not start iii-engine.\");\n    p.note(\n      [\n        \"Install iii-engine (pick one):\",\n        \"  curl -fsSL https://install.iii.dev/iii/main/install.sh | sh\",\n        \"  cargo install iii-engine\",\n        \"\",\n        \"Or use Docker:\",\n        \"  docker pull iiidev/iii:latest\",\n        \"\",\n        \"Docs: https://iii.dev/docs\",\n        \"\",\n        \"Or skip with: agentmemory --no-engine\",\n      ].join(\"\\n\"),\n      \"Setup required\",\n    );\n    process.exit(1);\n  }\n\n  const s = p.spinner();\n  s.start(\"Waiting for iii-engine to be ready...\");\n\n  const ready = await waitForEngine(15000);\n  if (!ready) {\n    const port = getRestPort();\n    s.stop(\"iii-engine did not become ready within 15s\");\n    p.log.error(`Check that ports ${port}, ${port + 1}, 49134 are available.`);\n    process.exit(1);\n  }\n\n  s.stop(\"iii-engine is ready\");\n  await import(\"./index.js\");\n}\n\nmain().catch((err) => {\n  p.log.error(err instanceof Error ? err.message : String(err));\n  process.exit(1);\n});\n"],"mappings":"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"}

package/dist/index.mjs

@@ -3739,7 +3739,7 @@ function registerAutoForgetFunction(sdk, kv) {
 
 //#endregion
 //#region src/version.ts
-const VERSION = "0.7.0";
+const VERSION = "0.7.2";
 
 //#endregion
 //#region src/functions/export-import.ts
@@ -3835,7 +3835,8 @@ function registerExportImportFunction(sdk, kv) {
 			"0.5.0",
 			"0.6.0",
 			"0.6.1",
-			"0.7.0"
+			"0.7.0",
+			"0.7.2"
 		]).has(importData.version)) return {
 			success: false,
 			error: `Unsupported export version: ${importData.version}`