@agentmemory/agentmemory 0.8.1 → 0.8.5

package/dist/cli.mjs

@@ -1,13 +1,84 @@
 #!/usr/bin/env node
-import { execFileSync, execSync, spawn } from "node:child_process";
+import { execFileSync, spawn } from "node:child_process";
 import { existsSync } from "node:fs";
-import { dirname, join } from "node:path";
+import { delimiter, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { platform } from "node:os";
 import * as p from "@clack/prompts";
+import { createHash } from "node:crypto";
 
+//#region src/state/schema.ts
+const KV = {
+	sessions: "mem:sessions",
+	observations: (sessionId) => `mem:obs:${sessionId}`,
+	memories: "mem:memories",
+	summaries: "mem:summaries",
+	config: "mem:config",
+	metrics: "mem:metrics",
+	health: "mem:health",
+	embeddings: (obsId) => `mem:emb:${obsId}`,
+	bm25Index: "mem:index:bm25",
+	relations: "mem:relations",
+	profiles: "mem:profiles",
+	claudeBridge: "mem:claude-bridge",
+	graphNodes: "mem:graph:nodes",
+	graphEdges: "mem:graph:edges",
+	semantic: "mem:semantic",
+	procedural: "mem:procedural",
+	teamShared: (teamId) => `mem:team:${teamId}:shared`,
+	teamUsers: (teamId, userId) => `mem:team:${teamId}:users:${userId}`,
+	teamProfile: (teamId) => `mem:team:${teamId}:profile`,
+	audit: "mem:audit",
+	actions: "mem:actions",
+	actionEdges: "mem:action-edges",
+	leases: "mem:leases",
+	routines: "mem:routines",
+	routineRuns: "mem:routine-runs",
+	signals: "mem:signals",
+	checkpoints: "mem:checkpoints",
+	mesh: "mem:mesh",
+	sketches: "mem:sketches",
+	facets: "mem:facets",
+	sentinels: "mem:sentinels",
+	crystals: "mem:crystals",
+	lessons: "mem:lessons",
+	insights: "mem:insights",
+	graphEdgeHistory: "mem:graph:edge-history",
+	enrichedChunks: (sessionId) => `mem:enriched:${sessionId}`,
+	latentEmbeddings: (obsId) => `mem:latent:${obsId}`,
+	retentionScores: "mem:retention",
+	accessLog: "mem:access"
+};
+const STREAM = {
+	name: "mem-live",
+	group: (sessionId) => sessionId,
+	viewerGroup: "viewer"
+};
+function generateId(prefix) {
+	return `${prefix}_${Date.now().toString(36)}_${crypto.randomUUID().replace(/-/g, "").slice(0, 12)}`;
+}
+function fingerprintId(prefix, content) {
+	return `${prefix}_${createHash("sha256").update(content).digest("hex").slice(0, 16)}`;
+}
+function jaccardSimilarity(a, b) {
+	const setA = new Set(a.split(/\s+/).filter((t) => t.length > 2));
+	const setB = new Set(b.split(/\s+/).filter((t) => t.length > 2));
+	if (setA.size === 0 && setB.size === 0) return 1;
+	if (setA.size === 0 || setB.size === 0) return 0;
+	let intersection = 0;
+	for (const word of setA) if (setB.has(word)) intersection++;
+	return intersection / (setA.size + setB.size - intersection);
+}
+
+//#endregion
 //#region src/cli.ts
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const args = process.argv.slice(2);
+const IS_WINDOWS = platform() === "win32";
+const IS_VERBOSE = args.includes("--verbose") || args.includes("-v");
+function vlog(msg) {
+	if (IS_VERBOSE) p.log.info(`[verbose] ${msg}`);
+}
 if (args.includes("--help") || args.includes("-h")) {
 	console.log(`
 agentmemory — persistent memory for AI coding agents
@@ -17,17 +88,22 @@ Usage: agentmemory [command] [options]
 Commands:
   (default)          Start agentmemory worker
   status             Show connection status, memory count, and health
+  demo               Seed sample sessions and show recall in action
+  mcp                Start standalone MCP server (no engine required)
 
 Options:
   --help, -h         Show this help
+  --verbose, -v      Show engine stderr and diagnostic info on startup
   --tools all|core   Tool visibility (default: core = 7 tools)
   --no-engine        Skip auto-starting iii-engine
   --port <N>         Override REST port (default: 3111)
 
 Quick start:
-  npx @agentmemory/agentmemory          # start everything
+  npx @agentmemory/agentmemory          # start with local iii-engine or Docker
   npx @agentmemory/agentmemory status   # check health
-  npx agentmemory-mcp                   # standalone MCP (no engine)
+  npx @agentmemory/agentmemory demo     # try it in 30 seconds (needs server running)
+  npx @agentmemory/agentmemory mcp      # standalone MCP server (no engine)
+  npx agentmemory-mcp                   # same as above (shim package)
 `);
 	process.exit(0);
 }
@@ -57,94 +133,106 @@ function findIiiConfig() {
 	return "";
 }
 function whichBinary(name) {
-	const cmd = process.platform === "win32" ? "where" : "which";
+	const cmd = IS_WINDOWS ? "where" : "which";
 	try {
-		return execFileSync(cmd, [name], { encoding: "utf-8" }).trim().split("\n")[0];
+		return execFileSync(cmd, [name], { encoding: "utf-8" }).split(/\r?\n/).map((line) => line.trim()).find((line) => line.length > 0) ?? null;
 	} catch {
 		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;
+function fallbackIiiPaths() {
+	if (IS_WINDOWS) {
+		const userProfile = process.env["USERPROFILE"];
+		if (!userProfile) return [];
+		return [join(userProfile, ".local", "bin", "iii.exe"), join(userProfile, "bin", "iii.exe")];
 	}
-	const shouldInstall = await p.confirm({
-		message: "iii-engine is not installed. Install it now?",
-		initialValue: true
+	const home = process.env["HOME"];
+	if (!home) return ["/usr/local/bin/iii"];
+	return [join(home, ".local", "bin", "iii"), "/usr/local/bin/iii"];
+}
+let startupFailure = null;
+function spawnEngineBackground(bin, spawnArgs, label) {
+	vlog(`spawn: ${bin} ${spawnArgs.join(" ")}`);
+	const child = spawn(bin, spawnArgs, {
+		detached: true,
+		stdio: [
+			"ignore",
+			"ignore",
+			"pipe"
+		],
+		windowsHide: 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;
+	const stderrChunks = [];
+	let stderrBytes = 0;
+	const MAX_STDERR_CAPTURE = 16 * 1024;
+	child.stderr?.on("data", (chunk) => {
+		if (stderrBytes >= MAX_STDERR_CAPTURE) return;
+		const slice = chunk.subarray(0, MAX_STDERR_CAPTURE - stderrBytes);
+		stderrChunks.push(slice);
+		stderrBytes += slice.length;
+	});
+	child.on("exit", (code, signal) => {
+		if (code !== null && code !== 0 || code === null && signal !== null) {
+			const stderr = Buffer.concat(stderrChunks).toString("utf-8");
+			startupFailure = {
+				kind: label.includes("Docker") ? "docker-crashed" : "engine-crashed",
+				stderr: stderr.trim() || (signal ? `process killed by signal ${signal}` : `process exited with code ${code}`),
+				binary: bin
+			};
+			vlog(`engine exited early: code=${code} signal=${signal}`);
+			if (IS_VERBOSE && stderr.trim()) p.log.error(`engine stderr:\n${stderr}`);
 		}
-		return false;
-	} catch (err) {
-		s.stop("Failed to install iii-engine");
-		p.log.error(err instanceof Error ? err.message : String(err));
-		return false;
-	}
+	});
+	child.unref();
+	return child;
 }
 async function startEngine() {
 	const configPath = findIiiConfig();
 	let iiiBin = whichBinary("iii");
-	if (!iiiBin) {
-		if (await installIii()) iiiBin = whichBinary("iii");
-	}
+	vlog(`iii binary: ${iiiBin ?? "(not on PATH)"}, config: ${configPath || "(not found)"}`);
 	if (iiiBin && configPath) {
 		const s = p.spinner();
 		s.start(`Starting iii-engine: ${iiiBin}`);
-		spawn(iiiBin, ["--config", configPath], {
-			detached: true,
-			stdio: "ignore"
-		}).unref();
+		spawnEngineBackground(iiiBin, ["--config", configPath], "iii-engine");
 		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"));
-	if (dockerBin && dcExists) {
-		const composeFile = existsSync(dockerCompose) ? dockerCompose : join(process.cwd(), "docker-compose.yml");
+	vlog(`docker binary: ${dockerBin ?? "(not on PATH)"}`);
+	const composeFile = [
+		join(__dirname, "..", "docker-compose.yml"),
+		join(__dirname, "docker-compose.yml"),
+		join(process.cwd(), "docker-compose.yml")
+	].find((c) => existsSync(c));
+	vlog(`docker-compose.yml: ${composeFile ?? "(not found)"}`);
+	if (dockerBin && composeFile) {
 		const s = p.spinner();
 		s.start("Starting iii-engine via Docker...");
-		spawn(dockerBin, [
+		spawnEngineBackground(dockerBin, [
 			"compose",
 			"-f",
 			composeFile,
 			"up",
 			"-d"
-		], {
-			detached: true,
-			stdio: "ignore"
-		}).unref();
+		], "iii-engine via Docker");
 		s.stop("Docker compose started");
 		return true;
 	}
+	for (const iiiPath of fallbackIiiPaths()) if (existsSync(iiiPath)) {
+		p.log.info(`Found iii at: ${iiiPath}`);
+		process.env["PATH"] = `${dirname(iiiPath)}${delimiter}${process.env["PATH"] ?? ""}`;
+		iiiBin = iiiPath;
+		break;
+	}
+	if (iiiBin && configPath) {
+		const s = p.spinner();
+		s.start(`Starting iii-engine: ${iiiBin}`);
+		spawnEngineBackground(iiiBin, ["--config", configPath], "iii-engine");
+		s.stop("iii-engine process started");
+		return true;
+	}
+	if (!iiiBin && (!dockerBin || !composeFile)) startupFailure = { kind: "no-engine" };
+	else if (!composeFile && dockerBin) startupFailure = { kind: "no-docker-compose" };
 	return false;
 }
 async function waitForEngine(timeoutMs) {
@@ -155,32 +243,60 @@ async function waitForEngine(timeoutMs) {
 	}
 	return false;
 }
+function installInstructions() {
+	if (IS_WINDOWS) return [
+		"agentmemory requires the `iii-engine` runtime. Pick one:",
+		"",
+		"  A) Download the prebuilt Windows binary:",
+		"     1. Open https://github.com/iii-hq/iii/releases/latest",
+		"     2. Download iii-x86_64-pc-windows-msvc.zip",
+		"        (or iii-aarch64-pc-windows-msvc.zip on ARM)",
+		"     3. Extract iii.exe and either add its folder to PATH",
+		"        or move it to %USERPROFILE%\\.local\\bin\\iii.exe",
+		"     4. Re-run: npx @agentmemory/agentmemory",
+		"",
+		"  B) Docker Desktop:",
+		"     1. Install Docker Desktop for Windows",
+		"     2. Start Docker Desktop (engine must be running)",
+		"     3. Re-run: npx @agentmemory/agentmemory",
+		"",
+		"Or skip the engine entirely for standalone MCP:",
+		"  npx @agentmemory/agentmemory mcp"
+	];
+	return [
+		"agentmemory requires the `iii-engine` runtime. Pick one:",
+		"",
+		"  A) curl -fsSL https://install.iii.dev/iii/main/install.sh | sh",
+		"     (installs the prebuilt iii binary into ~/.local/bin/iii)",
+		"",
+		"  B) Docker: install Docker Desktop or docker-ce, then re-run",
+		"",
+		"Or skip the engine entirely for standalone MCP:",
+		"  npx @agentmemory/agentmemory mcp",
+		"",
+		"Docs: https://iii.dev/docs"
+	];
+}
+function portInUseDiagnostic(port) {
+	return IS_WINDOWS ? `  netstat -ano | findstr :${port}` : `  lsof -i :${port}   # or: ss -tlnp | grep :${port}`;
+}
 async function main() {
 	p.intro("agentmemory");
 	if (skipEngine) {
 		p.log.info("Skipping engine check (--no-engine)");
-		await import("./src-Df36IFVL.mjs");
+		await import("./src-BuDB8dPq.mjs");
 		return;
 	}
 	if (await isEngineRunning()) {
 		p.log.success("iii-engine is running");
-		await import("./src-Df36IFVL.mjs");
+		await import("./src-BuDB8dPq.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");
+		const lines = installInstructions();
+		if (startupFailure?.kind === "no-docker-compose") lines.unshift("Docker is installed but docker-compose.yml is missing from this", "install. Re-install with: npm install -g @agentmemory/agentmemory", "");
+		p.note(lines.join("\n"), "Setup required");
 		process.exit(1);
 	}
 	const s = p.spinner();
@@ -188,11 +304,36 @@ async function main() {
 	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.`);
+		if (startupFailure?.kind === "engine-crashed" || startupFailure?.kind === "docker-crashed") {
+			p.log.error("The iii-engine process crashed on startup.");
+			if (startupFailure.binary) p.log.info(`Binary: ${startupFailure.binary}`);
+			if (startupFailure.stderr) p.note(startupFailure.stderr, "engine stderr");
+			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",
+				"    (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)",
+				"",
+				"See https://iii.dev/docs for current install instructions."
+			].join("\n"), "Troubleshooting");
+		} else {
+			p.log.error("The engine process started but the REST API never responded.");
+			p.note([
+				`Check whether port ${port} is already bound by another process:`,
+				portInUseDiagnostic(port),
+				"",
+				"If it is, free the port or override: agentmemory --port <N>",
+				"",
+				"If it isn't, a firewall may be blocking 127.0.0.1:" + port + ".",
+				"Re-run with --verbose to see engine stderr."
+			].join("\n"), "Troubleshooting");
+		}
 		process.exit(1);
 	}
 	s.stop("iii-engine is ready");
-	await import("./src-Df36IFVL.mjs");
+	await import("./src-BuDB8dPq.mjs");
 }
 async function runStatus() {
 	const port = getRestPort();
@@ -204,46 +345,229 @@ async function runStatus() {
 		process.exit(1);
 	}
 	try {
-		const [healthRes, sessionsRes, graphRes] = await Promise.all([
+		const [healthRes, sessionsRes, graphRes, memoriesRes] = await Promise.all([
 			fetch(`${base}/agentmemory/health`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null),
 			fetch(`${base}/agentmemory/sessions`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null),
-			fetch(`${base}/agentmemory/graph/stats`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null)
+			fetch(`${base}/agentmemory/graph/stats`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null),
+			fetch(`${base}/agentmemory/export`, { signal: AbortSignal.timeout(5e3) }).then((r) => r.json()).catch(() => null)
 		]);
 		const h = healthRes?.health;
 		const status = healthRes?.status || "unknown";
 		const version = healthRes?.version || "?";
 		const sessions = Array.isArray(sessionsRes?.sessions) ? sessionsRes.sessions.length : 0;
-		h?.workers?.[0]?.function_count;
 		const nodes = graphRes?.nodes || 0;
 		const edges = graphRes?.edges || 0;
 		const cb = healthRes?.circuitBreaker?.state || "closed";
 		const heapMB = h?.memory ? Math.round(h.memory.heapUsed / 1048576) : 0;
 		const uptime = h?.uptimeSeconds ? Math.round(h.uptimeSeconds) : 0;
+		const obsCount = memoriesRes?.observations?.length || 0;
+		const memCount = memoriesRes?.memories?.length || 0;
+		const estFullTokens = obsCount * 80;
+		const estInjectedTokens = Math.min(obsCount, 50) * 38;
+		const tokensSaved = estFullTokens - estInjectedTokens;
+		const pctSaved = estFullTokens > 0 ? Math.round(tokensSaved / estFullTokens * 100) : 0;
 		p.log.success(`Connected — v${version} on port ${port}`);
 		const lines = [
-			`Health:     ${status === "healthy" ? "healthy" : status}`,
-			`Sessions:   ${sessions}`,
-			`Graph:      ${nodes} nodes, ${edges} edges`,
-			`Circuit:    ${cb}`,
-			`Heap:       ${heapMB} MB`,
-			`Uptime:     ${uptime}s`,
-			`Viewer:     http://localhost:${port + 2}`
+			`Health:       ${status === "healthy" ? "✓ healthy" : status}`,
+			`Sessions:     ${sessions}`,
+			`Observations: ${obsCount}`,
+			`Memories:     ${memCount}`,
+			`Graph:        ${nodes} nodes, ${edges} edges`,
+			`Circuit:      ${cb}`,
+			`Heap:         ${heapMB} MB`,
+			`Uptime:       ${uptime}s`,
+			`Viewer:       http://localhost:${port + 2}`
 		];
+		if (obsCount > 0) {
+			lines.push("");
+			lines.push(`Token savings: ~${tokensSaved.toLocaleString()} tokens saved (${pctSaved}% reduction)`);
+			lines.push(`  Full context: ~${estFullTokens.toLocaleString()} tokens`);
+			lines.push(`  Injected:     ~${estInjectedTokens.toLocaleString()} tokens`);
+		}
 		p.note(lines.join("\n"), "agentmemory");
 	} catch (err) {
 		p.log.error(err instanceof Error ? err.message : String(err));
 		process.exit(1);
 	}
 }
-if (args[0] === "status") runStatus().catch((err) => {
-	p.log.error(err instanceof Error ? err.message : String(err));
-	process.exit(1);
-});
-else main().catch((err) => {
+function buildDemoSessions() {
+	return [
+		{
+			id: generateId("demo"),
+			title: "Session 1: JWT auth setup",
+			observations: [
+				{
+					toolName: "Write",
+					toolInput: { file_path: "src/middleware/auth.ts" },
+					toolOutput: "Created JWT middleware using jose library. Tokens expire after 30 days. Chose jose over jsonwebtoken for Edge compatibility."
+				},
+				{
+					toolName: "Write",
+					toolInput: { file_path: "test/auth.test.ts" },
+					toolOutput: "Added token validation tests covering expired, malformed, and valid cases."
+				},
+				{
+					toolName: "Bash",
+					toolInput: { command: "npm test" },
+					toolOutput: "All 12 auth tests passing."
+				}
+			]
+		},
+		{
+			id: generateId("demo"),
+			title: "Session 2: Database migration debugging",
+			observations: [{
+				toolName: "Read",
+				toolInput: { file_path: "prisma/schema.prisma" },
+				toolOutput: "Found N+1 query issue in user relations. Need to add include on posts query."
+			}, {
+				toolName: "Edit",
+				toolInput: { file_path: "src/api/users.ts" },
+				toolOutput: "Fixed N+1 by adding Prisma include. Query time dropped from 450ms to 28ms."
+			}]
+		},
+		{
+			id: generateId("demo"),
+			title: "Session 3: Rate limiting",
+			observations: [{
+				toolName: "Write",
+				toolInput: { file_path: "src/middleware/ratelimit.ts" },
+				toolOutput: "Added rate limiting middleware with 100 req/min default. Uses in-memory store for dev, Redis for prod."
+			}]
+		}
+	];
+}
+async function postJson(url, body, timeoutMs = 5e3) {
+	try {
+		const res = await fetch(url, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(body),
+			signal: AbortSignal.timeout(timeoutMs)
+		});
+		if (!res.ok) return null;
+		return await res.json().catch(() => null);
+	} catch {
+		return null;
+	}
+}
+async function postJsonStrict(url, body, timeoutMs = 5e3) {
+	const res = await fetch(url, {
+		method: "POST",
+		headers: { "Content-Type": "application/json" },
+		body: JSON.stringify(body),
+		signal: AbortSignal.timeout(timeoutMs)
+	});
+	if (!res.ok) {
+		const errBody = await res.text().catch(() => "");
+		const suffix = errBody ? ` — ${errBody.slice(0, 200)}` : "";
+		throw new Error(`POST ${url} failed: ${res.status} ${res.statusText}${suffix}`);
+	}
+	return await res.json().catch(() => null);
+}
+async function seedDemoSession(base, project, session) {
+	await postJsonStrict(`${base}/agentmemory/session/start`, {
+		sessionId: session.id,
+		project,
+		cwd: project
+	});
+	let stored = 0;
+	for (const obs of session.observations) {
+		const url = `${base}/agentmemory/observe`;
+		const payload = {
+			hookType: "post_tool_use",
+			sessionId: session.id,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			data: {
+				tool_name: obs.toolName,
+				tool_input: obs.toolInput,
+				tool_output: obs.toolOutput
+			}
+		};
+		try {
+			const res = await fetch(url, {
+				method: "POST",
+				headers: { "Content-Type": "application/json" },
+				body: JSON.stringify(payload),
+				signal: AbortSignal.timeout(5e3)
+			});
+			if (res.ok) stored++;
+			else {
+				const body = await res.text().catch(() => "");
+				p.log.warn(`observe failed for ${obs.toolName}: ${res.status} ${res.statusText}${body ? ` — ${body.slice(0, 160)}` : ""}`);
+			}
+		} catch (err) {
+			p.log.warn(`observe request failed for ${obs.toolName}: ${err instanceof Error ? err.message : String(err)}`);
+		}
+	}
+	await postJsonStrict(`${base}/agentmemory/session/end`, { sessionId: session.id });
+	return stored;
+}
+async function runDemoSearch(base, query) {
+	const items = (await postJson(`${base}/agentmemory/smart-search`, {
+		query,
+		limit: 5
+	}, 1e4))?.results ?? [];
+	return {
+		query,
+		hits: items.length,
+		topTitle: items[0]?.title ?? "(no results)"
+	};
+}
+async function runDemo() {
+	const port = getRestPort();
+	const base = `http://localhost:${port}`;
+	p.intro("agentmemory demo");
+	if (!await isEngineRunning()) {
+		p.log.error(`Not running — no response on port ${port}`);
+		p.log.info("Start the server first: npx @agentmemory/agentmemory");
+		process.exit(1);
+	}
+	const demoProject = "/tmp/agentmemory-demo";
+	const sessions = buildDemoSessions();
+	const sSeed = p.spinner();
+	sSeed.start("Seeding 3 demo sessions with realistic observations...");
+	let totalObs = 0;
+	for (const session of sessions) totalObs += await seedDemoSession(base, demoProject, session);
+	sSeed.stop(`Seeded ${totalObs} observations across ${sessions.length} sessions`);
+	const queries = [
+		"jwt auth middleware",
+		"database performance optimization",
+		"rate limiting"
+	];
+	const sQuery = p.spinner();
+	sQuery.start(`Running ${queries.length} smart-search queries...`);
+	const results = [];
+	for (const query of queries) results.push(await runDemoSearch(base, query));
+	sQuery.stop("Search complete");
+	const lines = [
+		`Project:       ${demoProject}`,
+		`Sessions:      ${sessions.length} seeded (${totalObs} observations)`,
+		"",
+		"Search results:",
+		...results.flatMap((r) => [`  "${r.query}"`, `    → ${r.hits} hit(s), top: ${r.topTitle.slice(0, 60)}`]),
+		"",
+		`Notice: searching "database performance optimization"`,
+		`found the N+1 query fix — keyword matching can't do that.`,
+		"",
+		`Viewer:        http://localhost:${port + 2}`,
+		`Clean up with: curl -X DELETE "${base}/agentmemory/sessions?project=${demoProject}"`
+	];
+	p.note(lines.join("\n"), "demo complete");
+	p.log.success("agentmemory is working. Point your agent at it and get back to coding.");
+}
+async function runMcp() {
+	await import("./standalone-CxAvUMQk.mjs");
+}
+({
+	status: runStatus,
+	demo: runDemo,
+	mcp: runMcp
+}[args[0] ?? ""] ?? main)().catch((err) => {
 	p.log.error(err instanceof Error ? err.message : String(err));
 	process.exit(1);
 });
 
 //#endregion
-export {  };
+export { jaccardSimilarity as a, generateId as i, STREAM as n, fingerprintId as r, KV as t };
 //# sourceMappingURL=cli.mjs.map