@agentmemory/agentmemory 0.9.21 → 0.9.22

package/dist/cli.mjs

@@ -1,101 +1,16 @@
 #!/usr/bin/env node
-import { createRequire } from "node:module";
+import { n as resolveAdapter, r as runAdapter } from "./connect-BQQXpyDS.mjs";
+import { i as generateId } from "./schema-BkALl7Z_.mjs";
+import { r as setBootVerbose } from "./logger-xlVlvCWX.mjs";
+import { t as VERSION } from "./version-DvQMNbEH.mjs";
 import { execFileSync, spawn, spawnSync } from "node:child_process";
-import { closeSync, constants, copyFileSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, readlinkSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync, writeSync } from "node:fs";
+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";
 import { fileURLToPath } from "node:url";
 import { homedir, platform } from "node:os";
 import * as p from "@clack/prompts";
-import { createHash } from "node:crypto";
 import { copyFile, mkdir } from "node:fs/promises";
 
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) {
-		__defProp(target, name, {
-			get: all[name],
-			enumerable: true
-		});
-	}
-	if (!no_symbols) {
-		__defProp(target, Symbol.toStringTag, { value: "Module" });
-	}
-	return target;
-};
-
-//#endregion
-//#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",
-	imageRefs: "mem:image-refs",
-	imageEmbeddings: "mem:image-embeddings",
-	slots: "mem:slots",
-	globalSlots: "mem:slots:global",
-	state: "mem:state",
-	commits: "mem:commits"
-};
-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/doctor-diagnostics.ts
 /** Common placeholder values shipped in .env.example. */
 const PLACEHOLDER_VALUES = new Set([
@@ -323,7 +238,7 @@ function envPath(home) {
 function preferencesPath(home) {
 	return join(home, ".agentmemory", "preferences.json");
 }
-function backupsDir$1(home) {
+function backupsDir(home) {
 	return join(home, ".agentmemory", "backups");
 }
 function dataDir(home) {
@@ -399,9 +314,9 @@ function buildRemovePlan(ctx, options) {
 	plan.push({
 		id: "backups",
 		description: "Delete backups/ directory (connect manifest + backups)",
-		path: backupsDir$1(home),
+		path: backupsDir(home),
 		alwaysAsk: false,
-		applicable: !options.keepData && pathExists(backupsDir$1(home)),
+		applicable: !options.keepData && pathExists(backupsDir(home)),
 		sizeBytes: -1
 	});
 	if (connectManifest?.installed?.length) for (const entry of connectManifest.installed) plan.push({
@@ -564,544 +479,6 @@ function isFirstRun() {
 	return readPrefs().firstRunAt === null;
 }
 
-//#endregion
-//#region src/cli/connect/util.ts
-const AGENTMEMORY_MCP_BLOCK = {
-	command: "npx",
-	args: ["-y", "@agentmemory/mcp"],
-	env: {
-		AGENTMEMORY_URL: "${AGENTMEMORY_URL}",
-		AGENTMEMORY_SECRET: "${AGENTMEMORY_SECRET}"
-	}
-};
-function backupsDir() {
-	return join(homedir(), ".agentmemory", "backups");
-}
-function ensureBackupsDir() {
-	const dir = backupsDir();
-	mkdirSync(dir, { recursive: true });
-	return dir;
-}
-function timestampSlug() {
-	return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-}
-function backupFile(sourcePath, agent, ext = "json") {
-	ensureBackupsDir();
-	const stamp = timestampSlug();
-	const target = join(backupsDir(), `${agent}-${stamp}.${ext}`);
-	copyFileSync(sourcePath, target);
-	return target;
-}
-function readJsonSafe(path) {
-	if (!existsSync(path)) return null;
-	try {
-		return JSON.parse(readFileSync(path, "utf-8"));
-	} catch {
-		return null;
-	}
-}
-function writeJsonAtomic(path, value) {
-	mkdirSync(dirname(path), { recursive: true });
-	const tmp = `${path}.tmp-${process.pid}-${Date.now()}`;
-	writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\n`, "utf-8");
-	renameSync(tmp, path);
-}
-function logInstalled(label, target) {
-	p.log.success(`${label} → wired into ${target}`);
-}
-function logAlreadyWired(label, target) {
-	p.log.info(`${label} already wired in ${target} (use --force to re-install)`);
-}
-function logBackup(target) {
-	p.log.info(`Backup: ${target}`);
-}
-
-//#endregion
-//#region src/cli/connect/claude-code.ts
-const CLAUDE_DIR = join(homedir(), ".claude");
-const CLAUDE_JSON = join(homedir(), ".claude.json");
-function entryMatches$1(entry) {
-	if (!entry || typeof entry !== "object") return false;
-	const e = entry;
-	if (e["command"] !== "npx") return false;
-	return (Array.isArray(e["args"]) ? e["args"] : []).includes("@agentmemory/mcp");
-}
-const adapter$7 = {
-	name: "claude-code",
-	displayName: "Claude Code",
-	docs: "https://github.com/rohitg00/agentmemory#claude-code-one-block-paste-it",
-	protocolNote: "→ Using MCP. Hooks are also available — see docs/claude-code.md.",
-	detect() {
-		return existsSync(CLAUDE_DIR);
-	},
-	async install(opts) {
-		const existing = readJsonSafe(CLAUDE_JSON);
-		const next = existing ? { ...existing } : {};
-		const servers = { ...next.mcpServers ?? {} };
-		const alreadyHas = entryMatches$1(servers["agentmemory"]);
-		if (alreadyHas && !opts.force) {
-			logAlreadyWired("Claude Code", CLAUDE_JSON);
-			return {
-				kind: "already-wired",
-				mutatedPath: CLAUDE_JSON
-			};
-		}
-		if (opts.dryRun) {
-			p.log.info(`[dry-run] Would ${alreadyHas ? "overwrite" : "add"} mcpServers.agentmemory in ${CLAUDE_JSON}`);
-			return {
-				kind: "installed",
-				mutatedPath: CLAUDE_JSON
-			};
-		}
-		let backupPath;
-		if (existsSync(CLAUDE_JSON)) {
-			backupPath = backupFile(CLAUDE_JSON, "claude-code");
-			logBackup(backupPath);
-		} else {
-			mkdirSync(CLAUDE_DIR, { recursive: true });
-			writeFileSync(CLAUDE_JSON, "{}\n", "utf-8");
-		}
-		servers["agentmemory"] = AGENTMEMORY_MCP_BLOCK;
-		next.mcpServers = servers;
-		writeJsonAtomic(CLAUDE_JSON, next);
-		if (!entryMatches$1(readJsonSafe(CLAUDE_JSON)?.mcpServers?.["agentmemory"])) {
-			p.log.error(`Verification failed: ${CLAUDE_JSON} did not contain mcpServers.agentmemory after write.`);
-			return {
-				kind: "skipped",
-				reason: "verification-failed"
-			};
-		}
-		logInstalled("Claude Code", CLAUDE_JSON);
-		p.log.info("Restart Claude Code (or run `/mcp` inside a session) to pick up the new server.");
-		return {
-			kind: "installed",
-			mutatedPath: CLAUDE_JSON,
-			backupPath
-		};
-	}
-};
-
-//#endregion
-//#region src/cli/connect/codex.ts
-const CODEX_DIR = join(homedir(), ".codex");
-const CODEX_TOML = join(CODEX_DIR, "config.toml");
-const TOML_BLOCK = `[mcp_servers.agentmemory]
-command = "npx"
-args = ["-y", "@agentmemory/mcp"]
-
-[mcp_servers.agentmemory.env]
-AGENTMEMORY_URL = "http://localhost:3111"
-`;
-const SECTION_HEADER = "[mcp_servers.agentmemory]";
-function isWiredText(toml) {
-	return toml.includes(SECTION_HEADER);
-}
-function stripExistingBlock(toml) {
-	const lines = toml.split(/\r?\n/);
-	const out = [];
-	let skipping = false;
-	for (const line of lines) {
-		const trimmed = line.trim();
-		if (trimmed === SECTION_HEADER || trimmed === "[mcp_servers.agentmemory.env]") {
-			skipping = true;
-			continue;
-		}
-		if (skipping && trimmed.startsWith("[") && trimmed !== "[mcp_servers.agentmemory.env]") skipping = false;
-		if (!skipping) out.push(line);
-	}
-	return out.join("\n").replace(/\n{3,}$/, "\n\n").trimEnd() + "\n";
-}
-const adapter$6 = {
-	name: "codex",
-	displayName: "Codex CLI",
-	docs: "https://github.com/rohitg00/agentmemory#codex-cli-codex-plugin-platform",
-	protocolNote: "→ Using MCP. Hooks are also available — see docs/codex.md.",
-	detect() {
-		return existsSync(CODEX_DIR);
-	},
-	async install(opts) {
-		const exists = existsSync(CODEX_TOML);
-		const current = exists ? readFileSync(CODEX_TOML, "utf-8") : "";
-		const wired = isWiredText(current);
-		if (wired && !opts.force) {
-			logAlreadyWired("Codex CLI", CODEX_TOML);
-			return {
-				kind: "already-wired",
-				mutatedPath: CODEX_TOML
-			};
-		}
-		if (opts.dryRun) {
-			p.log.info(`[dry-run] Would ${wired ? "rewrite" : "append"} [mcp_servers.agentmemory] in ${CODEX_TOML}`);
-			return {
-				kind: "installed",
-				mutatedPath: CODEX_TOML
-			};
-		}
-		let backupPath;
-		if (exists) {
-			backupPath = backupFile(CODEX_TOML, "codex", "toml");
-			logBackup(backupPath);
-		} else mkdirSync(dirname(CODEX_TOML), { recursive: true });
-		const cleaned = wired ? stripExistingBlock(current) : current;
-		writeFileSync(CODEX_TOML, `${cleaned}${cleaned.length === 0 || cleaned.endsWith("\n") ? "" : "\n"}${cleaned.length > 0 ? "\n" : ""}${TOML_BLOCK}`, "utf-8");
-		if (!isWiredText(readFileSync(CODEX_TOML, "utf-8"))) {
-			p.log.error(`Verification failed: ${CODEX_TOML} did not contain ${SECTION_HEADER} after write.`);
-			return {
-				kind: "skipped",
-				reason: "verification-failed"
-			};
-		}
-		logInstalled("Codex CLI", CODEX_TOML);
-		p.log.info("Codex picks up MCP servers on next launch. For the deeper plugin install, run: codex plugin marketplace add rohitg00/agentmemory && codex plugin install agentmemory");
-		return {
-			kind: "installed",
-			mutatedPath: CODEX_TOML,
-			...backupPath !== void 0 && { backupPath }
-		};
-	}
-};
-
-//#endregion
-//#region src/cli/connect/json-mcp-adapter.ts
-function entryMatches(entry) {
-	if (!entry || typeof entry !== "object") return false;
-	const e = entry;
-	if (e["command"] !== "npx") return false;
-	return (Array.isArray(e["args"]) ? e["args"] : []).includes("@agentmemory/mcp");
-}
-function createJsonMcpAdapter(config) {
-	return {
-		name: config.name,
-		displayName: config.displayName,
-		...config.docs !== void 0 && { docs: config.docs },
-		...config.protocolNote !== void 0 && { protocolNote: config.protocolNote },
-		detect() {
-			return existsSync(config.detectDir);
-		},
-		async install(opts) {
-			const existing = readJsonSafe(config.configPath);
-			const next = existing ? { ...existing } : {};
-			const servers = { ...next.mcpServers ?? {} };
-			const alreadyHas = entryMatches(servers["agentmemory"]);
-			if (alreadyHas && !opts.force) {
-				logAlreadyWired(config.displayName, config.configPath);
-				return {
-					kind: "already-wired",
-					mutatedPath: config.configPath
-				};
-			}
-			if (opts.dryRun) {
-				p.log.info(`[dry-run] Would ${alreadyHas ? "overwrite" : "add"} mcpServers.agentmemory in ${config.configPath}`);
-				return {
-					kind: "installed",
-					mutatedPath: config.configPath
-				};
-			}
-			let backupPath;
-			if (existsSync(config.configPath)) {
-				backupPath = backupFile(config.configPath, config.name);
-				logBackup(backupPath);
-			} else mkdirSync(dirname(config.configPath), { recursive: true });
-			servers["agentmemory"] = AGENTMEMORY_MCP_BLOCK;
-			next.mcpServers = servers;
-			writeJsonAtomic(config.configPath, next);
-			if (!entryMatches(readJsonSafe(config.configPath)?.mcpServers?.["agentmemory"])) {
-				p.log.error(`Verification failed: ${config.configPath} did not contain mcpServers.agentmemory after write.`);
-				return {
-					kind: "skipped",
-					reason: "verification-failed"
-				};
-			}
-			logInstalled(config.displayName, config.configPath);
-			return {
-				kind: "installed",
-				mutatedPath: config.configPath,
-				...backupPath !== void 0 && { backupPath }
-			};
-		}
-	};
-}
-
-//#endregion
-//#region src/cli/connect/cursor.ts
-const adapter$5 = createJsonMcpAdapter({
-	name: "cursor",
-	displayName: "Cursor",
-	detectDir: join(homedir(), ".cursor"),
-	configPath: join(homedir(), ".cursor", "mcp.json"),
-	docs: "https://github.com/rohitg00/agentmemory#other-agents",
-	protocolNote: "→ Using MCP (the only protocol Cursor speaks). Memory bridge runs at :3111 underneath."
-});
-
-//#endregion
-//#region src/cli/connect/gemini-cli.ts
-const adapter$4 = createJsonMcpAdapter({
-	name: "gemini-cli",
-	displayName: "Gemini CLI",
-	detectDir: join(homedir(), ".gemini"),
-	configPath: join(homedir(), ".gemini", "settings.json"),
-	docs: "https://github.com/rohitg00/agentmemory#other-agents",
-	protocolNote: "→ Using MCP (the only protocol Gemini CLI speaks). Memory bridge runs at :3111 underneath."
-});
-
-//#endregion
-//#region src/cli/connect/hermes.ts
-const HERMES_DIR = join(homedir(), ".hermes");
-const HERMES_CONFIG = join(HERMES_DIR, "config.yaml");
-const DOCS$2 = "https://github.com/rohitg00/agentmemory/tree/main/integrations/hermes";
-const adapter$3 = {
-	name: "hermes",
-	displayName: "Hermes Agent",
-	docs: DOCS$2,
-	protocolNote: "→ Using MCP. Hooks are also available — see docs/hermes.md.",
-	detect() {
-		return existsSync(HERMES_DIR);
-	},
-	async install(_opts) {
-		p.log.warn("Hermes uses YAML config. Automated merge isn't implemented yet — manual install required.");
-		p.note([
-			`Add to ${HERMES_CONFIG}:`,
-			"",
-			"  mcp_servers:",
-			"    agentmemory:",
-			"      command: npx",
-			"      args: [\"-y\", \"@agentmemory/mcp\"]",
-			"",
-			"  memory:",
-			"    provider: agentmemory",
-			"",
-			`Full guide: ${DOCS$2}`
-		].join("\n"), "Hermes manual install");
-		return {
-			kind: "stub",
-			reason: "yaml-merge-not-implemented"
-		};
-	}
-};
-
-//#endregion
-//#region src/cli/connect/openclaw.ts
-const adapter$2 = createJsonMcpAdapter({
-	name: "openclaw",
-	displayName: "OpenClaw",
-	detectDir: join(homedir(), ".openclaw"),
-	configPath: join(homedir(), ".openclaw", "openclaw.json"),
-	docs: "https://github.com/rohitg00/agentmemory/tree/main/integrations/openclaw",
-	protocolNote: "→ Using MCP. Hooks are also available — see docs/openclaw.md."
-});
-
-//#endregion
-//#region src/cli/connect/openhuman.ts
-const OPENHUMAN_DIR = join(homedir(), ".openhuman");
-const DOCS$1 = "https://github.com/tinyhumansai/openhuman";
-const adapter$1 = {
-	name: "openhuman",
-	displayName: "OpenHuman",
-	docs: DOCS$1,
-	protocolNote: "→ Using native hooks (REST API at :3111). MCP not required.",
-	detect() {
-		return existsSync(OPENHUMAN_DIR);
-	},
-	async install(_opts) {
-		p.log.warn("OpenHuman integration is not yet automated. No `integrations/openhuman/` folder exists in the agentmemory repo today.");
-		p.note([
-			"OpenHuman is a Memory-trait host. The expected wiring is the REST",
-			"proxy at http://localhost:3111 plus an OpenHuman-side Memory trait",
-			"impl. Once integrations/openhuman/ lands in agentmemory we'll wire",
-			"this up automatically.",
-			"",
-			`Tracking: ${DOCS$1}`
-		].join("\n"), "OpenHuman manual install");
-		return {
-			kind: "stub",
-			reason: "no-integration-folder-yet"
-		};
-	}
-};
-
-//#endregion
-//#region src/cli/connect/pi.ts
-const PI_DIR = join(homedir(), ".pi");
-const PI_EXT_DIR = join(PI_DIR, "agent", "extensions", "agentmemory");
-const DOCS = "https://github.com/rohitg00/agentmemory/tree/main/integrations/pi";
-const adapter = {
-	name: "pi",
-	displayName: "pi",
-	docs: DOCS,
-	protocolNote: "→ Using native hooks (REST API at :3111). MCP not required.",
-	detect() {
-		return existsSync(PI_DIR);
-	},
-	async install(_opts) {
-		p.log.warn("pi uses a TypeScript extension file. Automated copy + register isn't implemented yet — manual install required.");
-		p.note([
-			"Run these from the agentmemory repo root:",
-			"",
-			`  mkdir -p ${PI_EXT_DIR}`,
-			`  cp integrations/pi/index.ts ${PI_EXT_DIR}/index.ts`,
-			`  cp integrations/pi/security.ts ${PI_EXT_DIR}/security.ts`,
-			"",
-			"Then add to ~/.pi/agent/settings.json:",
-			"  { \"extensions\": [\"~/.pi/agent/extensions/agentmemory\"] }",
-			"",
-			`Full guide: ${DOCS}`
-		].join("\n"), "pi manual install");
-		return {
-			kind: "stub",
-			reason: "ts-extension-copy-not-implemented"
-		};
-	}
-};
-
-//#endregion
-//#region src/cli/connect/index.ts
-var connect_exports = /* @__PURE__ */ __exportAll({
-	ADAPTERS: () => ADAPTERS,
-	knownAgents: () => knownAgents,
-	resolveAdapter: () => resolveAdapter,
-	runAdapter: () => runAdapter,
-	runConnect: () => runConnect
-});
-const ADAPTERS = [
-	adapter$7,
-	adapter$6,
-	adapter$5,
-	adapter$4,
-	adapter$2,
-	adapter$3,
-	adapter,
-	adapter$1
-];
-function resolveAdapter(name) {
-	const lower = name.toLowerCase();
-	return ADAPTERS.find((a) => a.name === lower) ?? null;
-}
-function knownAgents() {
-	return ADAPTERS.map((a) => a.name);
-}
-function parseFlags(args) {
-	const positional = [];
-	let dryRun = false;
-	let force = false;
-	let all = false;
-	for (const a of args) if (a === "--dry-run") dryRun = true;
-	else if (a === "--force") force = true;
-	else if (a === "--all") all = true;
-	else if (!a.startsWith("-")) positional.push(a);
-	return {
-		dryRun,
-		force,
-		all,
-		positional
-	};
-}
-async function runAdapter(adapter, opts) {
-	if (!adapter.detect()) {
-		p.log.warn(`${adapter.displayName}: not detected on this machine (skipping).${adapter.docs ? ` Docs: ${adapter.docs}` : ""}`);
-		return {
-			kind: "skipped",
-			reason: "not-detected"
-		};
-	}
-	p.log.step(`Wiring ${adapter.displayName}…`);
-	if (adapter.protocolNote) p.log.message(adapter.protocolNote);
-	try {
-		return await adapter.install(opts);
-	} catch (err) {
-		p.log.error(`${adapter.displayName}: ${err instanceof Error ? err.message : String(err)}`);
-		return {
-			kind: "skipped",
-			reason: "exception"
-		};
-	}
-}
-async function runConnect(args) {
-	if (platform() === "win32") {
-		p.intro("agentmemory connect");
-		p.log.warn("Windows: automated `connect` is not supported yet. See https://github.com/rohitg00/agentmemory#other-agents for manual install steps.");
-		p.outro("Windows: manual install required — see docs");
-		return;
-	}
-	const { dryRun, force, all, positional } = parseFlags(args);
-	const opts = {
-		dryRun,
-		force
-	};
-	p.intro("agentmemory connect");
-	if (positional.length === 0 && !all) {
-		const detected = ADAPTERS.filter((a) => a.detect());
-		if (detected.length === 0) {
-			p.log.error("No supported agents detected on this machine.");
-			p.outro(`Supported: ${knownAgents().join(", ")}`);
-			process.exit(1);
-		}
-		const picked = await p.multiselect({
-			message: "Wire agentmemory into which agents?",
-			options: detected.map((a) => ({
-				value: a.name,
-				label: a.displayName
-			})),
-			required: true
-		});
-		if (p.isCancel(picked)) {
-			p.cancel("Cancelled.");
-			return;
-		}
-		const results = [];
-		for (const name of picked) {
-			const adapter = resolveAdapter(name);
-			if (!adapter) continue;
-			results.push({
-				name,
-				result: await runAdapter(adapter, opts)
-			});
-		}
-		summarize(results);
-		return;
-	}
-	if (all) {
-		const detected = ADAPTERS.filter((a) => a.detect());
-		if (detected.length === 0) {
-			p.log.error("No supported agents detected on this machine.");
-			process.exit(1);
-		}
-		const results = [];
-		for (const adapter of detected) results.push({
-			name: adapter.name,
-			result: await runAdapter(adapter, opts)
-		});
-		summarize(results);
-		return;
-	}
-	const agentName = positional[0];
-	const adapter = resolveAdapter(agentName);
-	if (!adapter) {
-		p.log.error(`Unknown agent: ${agentName}`);
-		p.outro(`Supported: ${knownAgents().join(", ")}`);
-		process.exit(1);
-	}
-	const result = await runAdapter(adapter, opts);
-	summarize([{
-		name: agentName,
-		result
-	}]);
-	if (result.kind === "skipped" && result.reason !== "not-detected") process.exit(1);
-}
-function summarize(results) {
-	const lines = results.map(({ name, result }) => {
-		switch (result.kind) {
-			case "installed": return `  ✓ ${name}${result.mutatedPath ? ` → ${result.mutatedPath}` : ""}`;
-			case "already-wired": return `  ✓ ${name} (already wired)`;
-			case "stub": return `  ⚠ ${name} (manual install required: ${result.reason})`;
-			case "skipped": return `  ✗ ${name} (skipped: ${result.reason})`;
-		}
-	});
-	p.note(lines.join("\n"), "summary");
-	const stubs = results.filter((r) => r.result.kind === "stub");
-	if (stubs.length > 0) p.log.info(`${stubs.length} agent(s) require manual install — see docs links above.`);
-	p.outro("Restart any wired agent (or open a new session) to pick up agentmemory.");
-}
-
 //#endregion
 //#region src/cli/onboarding.ts
 const __dirname$1 = dirname(fileURLToPath(import.meta.url));
@@ -1412,51 +789,6 @@ async function wireSelectedAgents(agents) {
 	p.note(summary.join("\n"), "wire summary");
 }
 
-//#endregion
-//#region src/logger.ts
-function fmt(level, msg, fields) {
-	if (!fields || Object.keys(fields).length === 0) return `[agentmemory] ${level} ${msg}`;
-	try {
-		return `[agentmemory] ${level} ${msg} ${JSON.stringify(fields)}`;
-	} catch {
-		return `[agentmemory] ${level} ${msg}`;
-	}
-}
-function emit(level, msg, fields) {
-	try {
-		process.stderr.write(fmt(level, msg, fields) + "\n");
-	} catch {}
-}
-const logger = {
-	info(msg, fields) {
-		emit("info", msg, fields);
-	},
-	warn(msg, fields) {
-		emit("warn", msg, fields);
-	},
-	error(msg, fields) {
-		emit("error", msg, fields);
-	}
-};
-let bootVerbose = process.env["AGENTMEMORY_VERBOSE"] === "1" || process.env["AGENTMEMORY_VERBOSE"] === "true";
-const bootBuffer = [];
-function setBootVerbose(enabled) {
-	bootVerbose = enabled;
-}
-function bootLog(msg) {
-	if (bootVerbose) {
-		try {
-			process.stderr.write(`[agentmemory] ${msg}\n`);
-		} catch {}
-		return;
-	}
-	if (bootBuffer.length < 500) bootBuffer.push(msg);
-}
-
-//#endregion
-//#region src/version.ts
-const VERSION = "0.9.21";
-
 //#endregion
 //#region src/cli.ts
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -1521,7 +853,7 @@ Options:
   --help, -h         Show this help
   --verbose, -v      Show engine stderr, boot log, and diagnostic info
   --reset            Wipe ~/.agentmemory/preferences.json and re-run onboarding
-  --tools all|core   Tool visibility (default: core = 7 tools)
+  --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)
 
@@ -1561,9 +893,26 @@ function getBaseUrl() {
 	if (url) return url.replace(/\/+$/, "");
 	return `http://localhost:${getRestPort()}`;
 }
+let discoveredViewerPort = null;
+async function discoverViewerPort() {
+	if (discoveredViewerPort !== null) return;
+	try {
+		const res = await fetch(`${getBaseUrl()}/agentmemory/livez`, { signal: AbortSignal.timeout(1e3) });
+		if (res.ok) {
+			const data = await res.json();
+			if (typeof data.viewerPort === "number") discoveredViewerPort = data.viewerPort;
+		}
+	} catch {}
+}
 function getViewerUrl() {
 	const envUrl = process.env["AGENTMEMORY_VIEWER_URL"];
 	if (envUrl) return envUrl.replace(/\/+$/, "");
+	if (discoveredViewerPort !== null) try {
+		const u = new URL(getBaseUrl());
+		return `${u.protocol}//${u.hostname}:${discoveredViewerPort}`;
+	} catch {
+		return `http://localhost:${discoveredViewerPort}`;
+	}
 	try {
 		const u = new URL(getBaseUrl());
 		const vPort = parseInt(process.env["III_VIEWER_PORT"] || "", 10) || (parseInt(u.port || "3111", 10) || 3111) + 2;
@@ -1595,7 +944,19 @@ async function isEngineRunning() {
 }
 async function isAgentmemoryReady() {
 	try {
-		return (await fetch(`${getBaseUrl()}/agentmemory/livez`, { signal: AbortSignal.timeout(2e3) })).ok;
+		const res = await fetch(`${getBaseUrl()}/agentmemory/livez`, { signal: AbortSignal.timeout(2e3) });
+		if (!res.ok) return false;
+		try {
+			const data = await res.json();
+			if (typeof data.viewerPort === "number") {
+				discoveredViewerPort = data.viewerPort;
+				return true;
+			}
+			if (data.viewerSkipped) return true;
+			return false;
+		} catch {
+			return false;
+		}
 	} catch {
 		return false;
 	}
@@ -1689,6 +1050,23 @@ function clearEnginePidfile() {
 		unlinkSync(enginePidfilePath());
 	} catch {}
 }
+function workerPidfilePath() {
+	return join(homedir(), ".agentmemory", "worker.pid");
+}
+function readWorkerPidfile() {
+	try {
+		const pidStr = readFileSync(workerPidfilePath(), "utf-8").trim();
+		const pid = parseInt(pidStr, 10);
+		return Number.isFinite(pid) && pid > 0 ? pid : null;
+	} catch {
+		return null;
+	}
+}
+function clearWorkerPidfile() {
+	try {
+		unlinkSync(workerPidfilePath());
+	} catch {}
+}
 function writeEngineState(state) {
 	try {
 		const statePath = engineStatePath();
@@ -2110,7 +1488,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-D5arboxc.mjs");
+		await import("./src-gpTAJuBy.mjs");
 		if (await waitForAgentmemoryReady(15e3)) {
 			const consoleState = await ensureIiiConsole();
 			await maybeOfferGlobalInstall();
@@ -2122,7 +1500,7 @@ async function main() {
 		if (IS_VERBOSE) p.log.success("iii-engine is running");
 		warnIfEngineVersionMismatch(whichBinary("iii") ?? fallbackIiiPaths().find((p) => existsSync(p)) ?? null);
 		adoptRunningEngine();
-		await import("./src-D5arboxc.mjs");
+		await import("./src-gpTAJuBy.mjs");
 		if (await waitForAgentmemoryReady(15e3)) {
 			const consoleState = await ensureIiiConsole();
 			await maybeOfferGlobalInstall();
@@ -2171,7 +1549,7 @@ async function main() {
 		process.exit(1);
 	}
 	s.stop("iii-engine is ready");
-	await import("./src-D5arboxc.mjs");
+	await import("./src-gpTAJuBy.mjs");
 	if (await waitForAgentmemoryReady(15e3)) {
 		const consoleState = await ensureIiiConsole();
 		await maybeOfferGlobalInstall();
@@ -2209,6 +1587,7 @@ async function runStatus() {
 			apiFetch(base, "export"),
 			apiFetch(base, "config/flags")
 		]);
+		if (typeof healthRes?.viewerPort === "number") discoveredViewerPort = healthRes.viewerPort;
 		const h = healthRes?.health;
 		const status = healthRes?.status || "unknown";
 		const version = healthRes?.version || "?";
@@ -2328,6 +1707,7 @@ function buildDoctorEffects() {
 		iiiBinaryVersion: (binPath) => iiiBinVersion(binPath),
 		viewerReachable: async (timeoutMs = 2e3) => {
 			try {
+				await discoverViewerPort();
 				return (await fetch(getViewerUrl(), { signal: AbortSignal.timeout(timeoutMs) })).ok;
 			} catch {
 				return false;
@@ -2877,14 +2257,14 @@ async function runUpgrade() {
 	};
 	if (hasPackageJson) if (!!pnpmBin && hasPnpmLock && pnpmBin) {
 		requireSuccess(runCommand(pnpmBin, ["install"], { label: "Refreshing dependencies (pnpm install)" }), "pnpm install");
-		runCommand(pnpmBin, ["up", "iii-sdk@latest"], {
-			label: "Upgrading iii-sdk to latest",
+		runCommand(pnpmBin, ["up", "iii-sdk@0.11.2"], {
+			label: "Pinning iii-sdk@0.11.2",
 			optional: true
 		});
 	} else if (npmBin) {
 		requireSuccess(runCommand(npmBin, ["install"], { label: "Refreshing dependencies (npm install)" }), "npm install");
-		runCommand(npmBin, ["install", "iii-sdk@latest"], {
-			label: "Upgrading iii-sdk to latest",
+		runCommand(npmBin, ["install", "iii-sdk@0.11.2"], {
+			label: "Pinning iii-sdk@0.11.2",
 			optional: true
 		});
 	} else p.log.warn("No package manager found (pnpm/npm). Skipping JS dependency upgrade.");
@@ -2992,6 +2372,7 @@ async function stopDockerEngine(composeFile, port) {
 	], { label: `docker compose -f ${composeFile} down` });
 	clearEnginePidfile();
 	clearEngineState();
+	clearWorkerPidfile();
 	if (!ok) {
 		p.log.error(`docker compose down failed. The engine may still be running on :${port}. Inspect with:\n  docker compose -f ${composeFile} ps`);
 		process.exit(1);
@@ -3009,6 +2390,7 @@ async function runStop() {
 			p.log.info(`No engine responding on port ${port}.`);
 			clearEnginePidfile();
 			clearEngineState();
+			clearWorkerPidfile();
 			p.outro("Nothing to stop.");
 			return;
 		}
@@ -3017,17 +2399,35 @@ async function runStop() {
 	}
 	const portPids = findEnginePidsByPort(port);
 	const pidfilePid = readEnginePidfile();
+	const workerPid = readWorkerPidfile();
 	if (!running) {
-		if (portPids.length === 0 && pidfilePid === null) {
+		if (portPids.length === 0 && pidfilePid === null && workerPid === null) {
 			clearEnginePidfile();
 			clearEngineState();
+			clearWorkerPidfile();
 			p.outro("Nothing to stop.");
 			return;
 		}
+		if (workerPid !== null && portPids.length === 0 && pidfilePid === null) {
+			const s = p.spinner();
+			s.start(`Stopping orphaned agentmemory worker (pid ${workerPid})...`);
+			const ok = await signalAndWait(workerPid, "SIGTERM", 3e3);
+			s.stop(ok ? `Stopped worker pid ${workerPid}` : `Failed to stop worker pid ${workerPid}`);
+			clearEnginePidfile();
+			clearEngineState();
+			clearWorkerPidfile();
+			if (!ok) {
+				p.log.error(`Worker pid ${workerPid} survived SIGKILL. Investigate with \`ps\`.`);
+				process.exit(1);
+			}
+			p.outro("Stopped orphaned worker. Memories persisted to disk.");
+			return;
+		}
 		const survivors = new Set(portPids);
 		if (pidfilePid) survivors.add(pidfilePid);
+		if (workerPid) survivors.add(workerPid);
 		p.log.warn(`Engine not responding on :${port}, but ${survivors.size} process(es) still hold the port or pidfile: ${[...survivors].join(", ")}`);
-		p.log.info(`Preserving ~/.agentmemory/iii.pid. Investigate before manual cleanup:\n  ps -p ${[...survivors].join(",")} -o pid,ppid,comm,etime\n  ${IS_WINDOWS ? "netstat -ano | findstr :" + port : "lsof -i :" + port}`);
+		p.log.info(`Preserving ~/.agentmemory/iii.pid + worker.pid. Investigate before manual cleanup:\n  ps -p ${[...survivors].join(",")} -o pid,ppid,comm,etime\n  ${IS_WINDOWS ? "netstat -ano | findstr :" + port : "lsof -i :" + port}`);
 		process.exit(1);
 	}
 	if (!state) {
@@ -3041,7 +2441,9 @@ async function runStop() {
 	const candidates = /* @__PURE__ */ new Set();
 	if (pidfilePid) candidates.add(pidfilePid);
 	for (const pid of portPids) candidates.add(pid);
-	if (candidates.size === 0) {
+	const workerCandidates = /* @__PURE__ */ new Set();
+	if (workerPid) workerCandidates.add(workerPid);
+	if (candidates.size === 0 && workerCandidates.size === 0) {
 		p.log.error(`Could not locate engine process. Try:\n  ${IS_WINDOWS ? "netstat -ano | findstr :" + port : "lsof -i :" + port + " -t | xargs kill -9"}`);
 		process.exit(1);
 	}
@@ -3053,19 +2455,28 @@ async function runStop() {
 		s.stop(ok ? `Stopped pid ${pid}` : `Failed to stop pid ${pid}`);
 		if (!ok) allStopped = false;
 	}
+	for (const pid of workerCandidates) {
+		if (candidates.has(pid)) continue;
+		const s = p.spinner();
+		s.start(`Stopping agentmemory worker (pid ${pid})...`);
+		const ok = await signalAndWait(pid, "SIGTERM", 3e3);
+		s.stop(ok ? `Stopped worker pid ${pid}` : `Failed to stop worker pid ${pid}`);
+		if (!ok) allStopped = false;
+	}
 	clearEnginePidfile();
 	clearEngineState();
+	clearWorkerPidfile();
 	if (!allStopped) {
-		p.log.error("One or more engine processes survived SIGKILL. Investigate with `ps`.");
+		p.log.error("One or more processes survived SIGKILL. Investigate with `ps`.");
 		process.exit(1);
 	}
 	p.outro("Stopped. Memories persisted to disk; restart anytime with: npx @agentmemory/agentmemory");
 }
 async function runMcp() {
-	await import("./standalone-C7BgzzIN.mjs");
+	await import("./standalone-C4i7ktpn.mjs");
 }
 async function runConnectCmd() {
-	const { runConnect } = await Promise.resolve().then(() => connect_exports);
+	const { runConnect } = await import("./connect-BQQXpyDS.mjs").then((n) => n.t);
 	await runConnect(args.slice(1));
 }
 async function runImportJsonl() {
@@ -3298,5 +2709,5 @@ async function runRemove() {
 });
 
 //#endregion
-export { STREAM as a, jaccardSimilarity as c, KV as i, bootLog as n, fingerprintId as o, logger as r, generateId as s, VERSION as t };
+export { discoverViewerPort };
 //# sourceMappingURL=cli.mjs.map