@agentmemory/agentmemory 0.9.14 → 0.9.16

package/dist/{image-refs-HVu22rfu.mjs → image-refs-R3tin9MR.mjs}

@@ -1,4 +1,4 @@
-import { t as KV } from "./cli.mjs";
+import { i as KV } from "./cli.mjs";
 import { existsSync } from "node:fs";
 import { join, resolve, sep } from "node:path";
 import { homedir } from "node:os";
@@ -113,4 +113,4 @@ async function decrementImageRef(kv, sdk, filePath) {
 
 //#endregion
 export { isManagedImagePath as a, decrementImageRef, getImageRefCount, getMaxBytes as i, incrementImageRef, IMAGES_DIR as n, saveImageToDisk as o, deleteImage as r, touchImage as s, withKeyedLock as t };
-//# sourceMappingURL=image-refs-HVu22rfu.mjs.map
+//# sourceMappingURL=image-refs-R3tin9MR.mjs.map

package/dist/{image-refs-HVu22rfu.mjs.map → image-refs-R3tin9MR.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"image-refs-HVu22rfu.mjs","names":[],"sources":["../src/utils/image-store.ts","../src/state/keyed-mutex.ts","../src/functions/image-refs.ts"],"sourcesContent":["import { homedir } from \"node:os\";\nimport { join, resolve, sep } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { mkdir, writeFile, unlink, utimes, stat } from \"node:fs/promises\";\nimport { createHash } from \"node:crypto\";\n\nexport const IMAGES_DIR = join(homedir(), \".agentmemory\", \"images\");\n\nconst DEFAULT_MAX_BYTES = 500 * 1024 * 1024;\n\nexport function getMaxBytes(): number {\n  return Number(process.env.AGENTMEMORY_IMAGE_STORE_MAX_BYTES) || DEFAULT_MAX_BYTES;\n}\n\nexport function isManagedImagePath(filePath: string): boolean {\n  const resolved = resolve(filePath);\n  const normalizedImagesDir = resolve(IMAGES_DIR);\n  return resolved.startsWith(normalizedImagesDir + sep) || resolved === normalizedImagesDir;\n}\n\nfunction contentHash(data: string): string {\n  return createHash(\"sha256\").update(data).digest(\"hex\");\n}\n\nexport async function saveImageToDisk(base64Data: string): Promise<{ filePath: string; bytesWritten: number }> {\n  if (!base64Data) return { filePath: \"\", bytesWritten: 0 };\n\n  if (!existsSync(IMAGES_DIR)) {\n    await mkdir(IMAGES_DIR, { recursive: true });\n  }\n\n  let cleanBase64 = base64Data;\n  let ext = \"png\";\n\n  if (base64Data.startsWith(\"data:image/\")) {\n     const commaIdx = base64Data.indexOf(\",\");\n     if (commaIdx !== -1) {\n       const meta = base64Data.substring(0, commaIdx);\n       if (meta.includes(\"jpeg\") || meta.includes(\"jpg\")) ext = \"jpg\";\n       else if (meta.includes(\"webp\")) ext = \"webp\";\n       else if (meta.includes(\"gif\")) ext = \"gif\";\n       cleanBase64 = base64Data.substring(commaIdx + 1);\n     }\n  } else if (base64Data.startsWith(\"/9j/\")) {\n     ext = \"jpg\";\n  }\n\n  const hash = contentHash(cleanBase64);\n  const filePath = join(IMAGES_DIR, `${hash}.${ext}`);\n\n  if (existsSync(filePath)) {\n    return { filePath, bytesWritten: 0 };\n  }\n\n  const buffer = Buffer.from(cleanBase64, \"base64\");\n  await writeFile(filePath, buffer);\n\n  const s = await stat(filePath);\n\n  return { filePath, bytesWritten: s.size };\n}\n\nexport async function deleteImage(filePath: string | undefined): Promise<{ deletedBytes: number }> {\n  if (!filePath) return { deletedBytes: 0 };\n  if (!isManagedImagePath(filePath)) return { deletedBytes: 0 };\n  try {\n    if (existsSync(filePath)) {\n      const s = await stat(filePath);\n      const size = s.size;\n      await unlink(filePath);\n      return { deletedBytes: size };\n    }\n  } catch (err) {\n    console.error(\"[agentmemory] Failed to delete image context:\", err);\n  }\n  return { deletedBytes: 0 };\n}\n\n/** Touch an image file to update its mtime (marking it as recently used for LRU eviction) */\nexport async function touchImage(filePath: string): Promise<void> {\n  if (!filePath || !isManagedImagePath(filePath)) return;\n  try {\n    if (existsSync(filePath)) {\n      const now = new Date();\n      await utimes(filePath, now, now);\n    }\n  } catch (err) {\n    // Ignore touch errors silently\n  }\n}\n","const locks = new Map<string, Promise<void>>();\n\nexport function withKeyedLock<T>(\n  key: string,\n  fn: () => Promise<T>,\n): Promise<T> {\n  const prev = locks.get(key) ?? Promise.resolve();\n  const next = prev.then(fn, fn);\n  const cleanup = next.then(\n    () => {},\n    () => {},\n  );\n  locks.set(key, cleanup);\n  cleanup.then(() => {\n    if (locks.get(key) === cleanup) locks.delete(key);\n  });\n  return next;\n}\n","import type { ISdk } from \"iii-sdk\";\nimport { KV } from \"../state/schema.js\";\nimport { StateKV } from \"../state/kv.js\";\nimport { deleteImage, touchImage } from \"../utils/image-store.js\";\nimport { withKeyedLock } from \"../state/keyed-mutex.js\";\n\nexport async function getImageRefCount(kv: StateKV, filePath: string): Promise<number> {\n  const count = await kv.get<number>(KV.imageRefs, filePath);\n  return count ? Number(count) : 0;\n}\n\nexport async function incrementImageRef(kv: StateKV, filePath: string): Promise<void> {\n  return withKeyedLock(`imgRef:${filePath}`, async () => {\n    const current = await getImageRefCount(kv, filePath);\n    await kv.set(KV.imageRefs, filePath, current + 1);\n    await touchImage(filePath);\n  });\n}\n\nexport async function decrementImageRef(kv: StateKV, sdk: ISdk, filePath: string): Promise<void> {\n  return withKeyedLock(`imgRef:${filePath}`, async () => {\n    const current = await getImageRefCount(kv, filePath);\n    if (current <= 1) {\n      await kv.delete(KV.imageEmbeddings, filePath);\n      await kv.delete(KV.imageRefs, filePath);\n      const { deletedBytes } = await deleteImage(filePath);\n      if (deletedBytes > 0) {\n        sdk.triggerVoid(\"mem::disk-size-delta\", { deltaBytes: -deletedBytes });\n      }\n    } else {\n      await kv.set(KV.imageRefs, filePath, current - 1);\n    }\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"image-refs-R3tin9MR.mjs","names":[],"sources":["../src/utils/image-store.ts","../src/state/keyed-mutex.ts","../src/functions/image-refs.ts"],"sourcesContent":["import { homedir } from \"node:os\";\nimport { join, resolve, sep } from \"node:path\";\nimport { existsSync } from \"node:fs\";\nimport { mkdir, writeFile, unlink, utimes, stat } from \"node:fs/promises\";\nimport { createHash } from \"node:crypto\";\n\nexport const IMAGES_DIR = join(homedir(), \".agentmemory\", \"images\");\n\nconst DEFAULT_MAX_BYTES = 500 * 1024 * 1024;\n\nexport function getMaxBytes(): number {\n  return Number(process.env.AGENTMEMORY_IMAGE_STORE_MAX_BYTES) || DEFAULT_MAX_BYTES;\n}\n\nexport function isManagedImagePath(filePath: string): boolean {\n  const resolved = resolve(filePath);\n  const normalizedImagesDir = resolve(IMAGES_DIR);\n  return resolved.startsWith(normalizedImagesDir + sep) || resolved === normalizedImagesDir;\n}\n\nfunction contentHash(data: string): string {\n  return createHash(\"sha256\").update(data).digest(\"hex\");\n}\n\nexport async function saveImageToDisk(base64Data: string): Promise<{ filePath: string; bytesWritten: number }> {\n  if (!base64Data) return { filePath: \"\", bytesWritten: 0 };\n\n  if (!existsSync(IMAGES_DIR)) {\n    await mkdir(IMAGES_DIR, { recursive: true });\n  }\n\n  let cleanBase64 = base64Data;\n  let ext = \"png\";\n\n  if (base64Data.startsWith(\"data:image/\")) {\n     const commaIdx = base64Data.indexOf(\",\");\n     if (commaIdx !== -1) {\n       const meta = base64Data.substring(0, commaIdx);\n       if (meta.includes(\"jpeg\") || meta.includes(\"jpg\")) ext = \"jpg\";\n       else if (meta.includes(\"webp\")) ext = \"webp\";\n       else if (meta.includes(\"gif\")) ext = \"gif\";\n       cleanBase64 = base64Data.substring(commaIdx + 1);\n     }\n  } else if (base64Data.startsWith(\"/9j/\")) {\n     ext = \"jpg\";\n  }\n\n  const hash = contentHash(cleanBase64);\n  const filePath = join(IMAGES_DIR, `${hash}.${ext}`);\n\n  if (existsSync(filePath)) {\n    return { filePath, bytesWritten: 0 };\n  }\n\n  const buffer = Buffer.from(cleanBase64, \"base64\");\n  await writeFile(filePath, buffer);\n\n  const s = await stat(filePath);\n\n  return { filePath, bytesWritten: s.size };\n}\n\nexport async function deleteImage(filePath: string | undefined): Promise<{ deletedBytes: number }> {\n  if (!filePath) return { deletedBytes: 0 };\n  if (!isManagedImagePath(filePath)) return { deletedBytes: 0 };\n  try {\n    if (existsSync(filePath)) {\n      const s = await stat(filePath);\n      const size = s.size;\n      await unlink(filePath);\n      return { deletedBytes: size };\n    }\n  } catch (err) {\n    console.error(\"[agentmemory] Failed to delete image context:\", err);\n  }\n  return { deletedBytes: 0 };\n}\n\n/** Touch an image file to update its mtime (marking it as recently used for LRU eviction) */\nexport async function touchImage(filePath: string): Promise<void> {\n  if (!filePath || !isManagedImagePath(filePath)) return;\n  try {\n    if (existsSync(filePath)) {\n      const now = new Date();\n      await utimes(filePath, now, now);\n    }\n  } catch (err) {\n    // Ignore touch errors silently\n  }\n}\n","const locks = new Map<string, Promise<void>>();\n\nexport function withKeyedLock<T>(\n  key: string,\n  fn: () => Promise<T>,\n): Promise<T> {\n  const prev = locks.get(key) ?? Promise.resolve();\n  const next = prev.then(fn, fn);\n  const cleanup = next.then(\n    () => {},\n    () => {},\n  );\n  locks.set(key, cleanup);\n  cleanup.then(() => {\n    if (locks.get(key) === cleanup) locks.delete(key);\n  });\n  return next;\n}\n","import type { ISdk } from \"iii-sdk\";\nimport { KV } from \"../state/schema.js\";\nimport { StateKV } from \"../state/kv.js\";\nimport { deleteImage, touchImage } from \"../utils/image-store.js\";\nimport { withKeyedLock } from \"../state/keyed-mutex.js\";\n\nexport async function getImageRefCount(kv: StateKV, filePath: string): Promise<number> {\n  const count = await kv.get<number>(KV.imageRefs, filePath);\n  return count ? Number(count) : 0;\n}\n\nexport async function incrementImageRef(kv: StateKV, filePath: string): Promise<void> {\n  return withKeyedLock(`imgRef:${filePath}`, async () => {\n    const current = await getImageRefCount(kv, filePath);\n    await kv.set(KV.imageRefs, filePath, current + 1);\n    await touchImage(filePath);\n  });\n}\n\nexport async function decrementImageRef(kv: StateKV, sdk: ISdk, filePath: string): Promise<void> {\n  return withKeyedLock(`imgRef:${filePath}`, async () => {\n    const current = await getImageRefCount(kv, filePath);\n    if (current <= 1) {\n      await kv.delete(KV.imageEmbeddings, filePath);\n      await kv.delete(KV.imageRefs, filePath);\n      const { deletedBytes } = await deleteImage(filePath);\n      if (deletedBytes > 0) {\n        sdk.triggerVoid(\"mem::disk-size-delta\", { deltaBytes: -deletedBytes });\n      }\n    } else {\n      await kv.set(KV.imageRefs, filePath, current - 1);\n    }\n  });\n}\n"],"mappings":"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"}

package/dist/{image-store-BfN1vDbj.mjs → image-store-DyrKZKqZ.mjs}

@@ -1,3 +1,3 @@
-import { a as isManagedImagePath, i as getMaxBytes, n as IMAGES_DIR, o as saveImageToDisk, r as deleteImage, s as touchImage } from "./image-refs-HVu22rfu.mjs";
+import { a as isManagedImagePath, i as getMaxBytes, n as IMAGES_DIR, o as saveImageToDisk, r as deleteImage, s as touchImage } from "./image-refs-R3tin9MR.mjs";
 
 export { deleteImage, saveImageToDisk };

package/dist/index.mjs

@@ -1452,6 +1452,17 @@ const logger = {
 		emit("error", msg, fields);
 	}
 };
+let bootVerbose = process.env["AGENTMEMORY_VERBOSE"] === "1" || process.env["AGENTMEMORY_VERBOSE"] === "true";
+const bootBuffer = [];
+function bootLog(msg) {
+	if (bootVerbose) {
+		try {
+			process.stderr.write(`[agentmemory] ${msg}\n`);
+		} catch {}
+		return;
+	}
+	if (bootBuffer.length < 500) bootBuffer.push(msg);
+}
 
 //#endregion
 //#region src/functions/query-expansion.ts
@@ -5956,7 +5967,7 @@ function registerAutoForgetFunction(sdk, kv) {
 
 //#endregion
 //#region src/version.ts
-const VERSION = "0.9.14";
+const VERSION = "0.9.16";
 
 //#endregion
 //#region src/functions/export-import.ts
@@ -6088,7 +6099,9 @@ function registerExportImportFunction(sdk, kv) {
 			"0.9.11",
 			"0.9.12",
 			"0.9.13",
-			"0.9.14"
+			"0.9.14",
+			"0.9.15",
+			"0.9.16"
 		]).has(importData.version)) return {
 			success: false,
 			error: `Unsupported export version: ${importData.version}`
@@ -19395,8 +19408,10 @@ function readBody(req) {
 		req.on("error", reject);
 	});
 }
+const MAX_VIEWER_PORT_RETRIES = 10;
 function startViewerServer(port, _kv, _sdk, secret, restPort) {
 	const resolvedRestPort = restPort ?? port - 2;
+	const requestedPort = port;
 	const server = createServer(async (req, res) => {
 		const raw = req.url || "/";
 		const qIdx = raw.indexOf("?");
@@ -19433,13 +19448,26 @@ function startViewerServer(port, _kv, _sdk, secret, restPort) {
 			json(res, 502, { error: "upstream error" }, req);
 		}
 	});
+	let attempt = 0;
+	let currentPort = requestedPort;
+	const tryListen = () => {
+		server.listen(currentPort, "127.0.0.1");
+	};
+	server.on("listening", () => {
+		if (currentPort === requestedPort) console.log(`[agentmemory] Viewer: http://localhost:${currentPort}`);
+		else console.log(`[agentmemory] Viewer started on http://localhost:${currentPort} (fallback from ${requestedPort})`);
+	});
 	server.on("error", (err) => {
-		if (err.code === "EADDRINUSE") console.warn(`[agentmemory] Viewer port ${port} already in use, skipping viewer.`);
+		if (err.code === "EADDRINUSE" && attempt < MAX_VIEWER_PORT_RETRIES) {
+			attempt++;
+			currentPort = requestedPort + attempt;
+			setImmediate(tryListen);
+			return;
+		}
+		if (err.code === "EADDRINUSE") console.warn(`[agentmemory] Viewer ports ${requestedPort}-${requestedPort + MAX_VIEWER_PORT_RETRIES} all in use, skipping viewer.`);
 		else console.error(`[agentmemory] Viewer error:`, err.message);
 	});
-	server.listen(port, "127.0.0.1", () => {
-		console.log(`[agentmemory] Viewer: http://localhost:${port}`);
-	});
+	tryListen();
 	return server;
 }
 async function proxyToRestApi(restPort, pathname, qs, method, req, res, secret) {
@@ -19633,14 +19661,14 @@ async function main() {
 	const provider = fallbackConfig.providers.length > 0 ? createFallbackProvider(config.provider, fallbackConfig) : createProvider(config.provider);
 	const embeddingProvider = createEmbeddingProvider();
 	const imageEmbeddingProvider = createImageEmbeddingProvider();
-	console.log(`[agentmemory] Starting worker v${VERSION}...`);
-	console.log(`[agentmemory] Engine: ${config.engineUrl}`);
-	console.log(`[agentmemory] Provider: ${config.provider.provider} (${config.provider.model})`);
-	if (embeddingProvider) console.log(`[agentmemory] Embedding provider: ${embeddingProvider.name} (${embeddingProvider.dimensions} dims)`);
-	else console.log(`[agentmemory] Embedding provider: none (BM25-only mode)`);
-	if (imageEmbeddingProvider) console.log(`[agentmemory] Image embedding provider: ${imageEmbeddingProvider.name} (${imageEmbeddingProvider.dimensions} dims) — vision-search active`);
-	console.log(`[agentmemory] REST API: http://localhost:${config.restPort}/agentmemory/*`);
-	console.log(`[agentmemory] Streams: ws://localhost:${config.streamsPort}`);
+	bootLog(`Starting worker v${VERSION}...`);
+	bootLog(`Engine: ${config.engineUrl}`);
+	bootLog(`Provider: ${config.provider.provider} (${config.provider.model})`);
+	if (embeddingProvider) bootLog(`Embedding provider: ${embeddingProvider.name} (${embeddingProvider.dimensions} dims)`);
+	else bootLog(`Embedding provider: none (BM25-only mode)`);
+	if (imageEmbeddingProvider) bootLog(`Image embedding provider: ${imageEmbeddingProvider.name} (${imageEmbeddingProvider.dimensions} dims) — vision-search active`);
+	bootLog(`REST API: http://localhost:${config.restPort}/agentmemory/*`);
+	bootLog(`Streams: ws://localhost:${config.streamsPort}`);
 	const sdk = registerWorker(config.engineUrl, {
 		workerName: "agentmemory",
 		invocationTimeoutMs: 18e4,
@@ -19683,22 +19711,22 @@ async function main() {
 	const claudeBridgeConfig = loadClaudeBridgeConfig();
 	if (claudeBridgeConfig.enabled) {
 		registerClaudeBridgeFunction(sdk, kv, claudeBridgeConfig);
-		console.log(`[agentmemory] Claude bridge: syncing to ${claudeBridgeConfig.memoryFilePath}`);
+		bootLog(`Claude bridge: syncing to ${claudeBridgeConfig.memoryFilePath}`);
 	}
 	if (isGraphExtractionEnabled()) {
 		registerGraphFunction(sdk, kv, provider);
-		console.log(`[agentmemory] Knowledge graph: extraction enabled`);
+		bootLog(`Knowledge graph: extraction enabled`);
 	}
 	registerConsolidationPipelineFunction(sdk, kv, provider);
-	console.log(`[agentmemory] Consolidation pipeline: registered (CONSOLIDATION_ENABLED=${isConsolidationEnabled() ? "true" : "false"})`);
-	if (isAutoCompressEnabled()) console.log(`[agentmemory] WARNING: AGENTMEMORY_AUTO_COMPRESS=true — every PostToolUse observation will be sent to your LLM provider for compression. This spends API tokens proportional to your session tool-use frequency (see #138). Set AGENTMEMORY_AUTO_COMPRESS=false to disable.`);
-	else console.log(`[agentmemory] Auto-compress: OFF (default, #138) — observations indexed via zero-LLM synthetic compression. Set AGENTMEMORY_AUTO_COMPRESS=true to opt-in to LLM-powered summaries (uses your API key).`);
-	if (isContextInjectionEnabled()) console.log(`[agentmemory] WARNING: AGENTMEMORY_INJECT_CONTEXT=true — the PreToolUse and SessionStart hooks will inject up to ~4000 chars of memory context into every tool turn. On Claude Pro this burns session tokens proportional to your tool-call frequency (see #143). Set AGENTMEMORY_INJECT_CONTEXT=false to disable.`);
-	else console.log(`[agentmemory] Context injection: OFF (default, #143) — hooks capture observations but do not inject context into Claude Code's conversation. Set AGENTMEMORY_INJECT_CONTEXT=true to opt-in (warning: expect your Claude Pro allocation to drain faster).`);
+	bootLog(`Consolidation pipeline: registered (CONSOLIDATION_ENABLED=${isConsolidationEnabled() ? "true" : "false"})`);
+	if (isAutoCompressEnabled()) bootLog(`WARNING: AGENTMEMORY_AUTO_COMPRESS=true — every PostToolUse observation will be sent to your LLM provider for compression. This spends API tokens proportional to your session tool-use frequency (see #138). Set AGENTMEMORY_AUTO_COMPRESS=false to disable.`);
+	else bootLog(`Auto-compress: OFF (default, #138) — observations indexed via zero-LLM synthetic compression. Set AGENTMEMORY_AUTO_COMPRESS=true to opt-in to LLM-powered summaries (uses your API key).`);
+	if (isContextInjectionEnabled()) bootLog(`WARNING: AGENTMEMORY_INJECT_CONTEXT=true — the PreToolUse and SessionStart hooks will inject up to ~4000 chars of memory context into every tool turn. On Claude Pro this burns session tokens proportional to your tool-call frequency (see #143). Set AGENTMEMORY_INJECT_CONTEXT=false to disable.`);
+	else bootLog(`Context injection: OFF (default, #143) — hooks capture observations but do not inject context into Claude Code's conversation. Set AGENTMEMORY_INJECT_CONTEXT=true to opt-in (warning: expect your Claude Pro allocation to drain faster).`);
 	const teamConfig = loadTeamConfig();
 	if (teamConfig) {
 		registerTeamFunction(sdk, kv, teamConfig);
-		console.log(`[agentmemory] Team memory: ${teamConfig.teamId} (${teamConfig.mode})`);
+		bootLog(`Team memory: ${teamConfig.teamId} (${teamConfig.mode})`);
 	}
 	registerGovernanceFunction(sdk, kv);
 	registerActionsFunction(sdk, kv);
@@ -19728,13 +19756,13 @@ async function main() {
 	registerRetentionFunctions(sdk, kv);
 	registerCompressFileFunction(sdk, kv, provider);
 	registerReplayFunctions(sdk, kv);
-	console.log(`[agentmemory] v0.6 advanced retrieval: sliding-window, query-expansion, temporal-graph, retention-scoring`);
-	console.log(`[agentmemory] Orchestration layer: actions, frontier, leases, routines, signals, checkpoints, flow-compress, mesh, branch-aware, sentinels, sketches, crystallize, diagnostics, facets`);
-	if (isSlotsEnabled()) console.log(`[agentmemory] Slots: enabled (pinned editable memory). Reflect on Stop hook: ${isReflectEnabled() ? "on" : "off"}`);
+	bootLog(`v0.6 advanced retrieval: sliding-window, query-expansion, temporal-graph, retention-scoring`);
+	bootLog(`Orchestration layer: actions, frontier, leases, routines, signals, checkpoints, flow-compress, mesh, branch-aware, sentinels, sketches, crystallize, diagnostics, facets`);
+	if (isSlotsEnabled()) bootLog(`Slots: enabled (pinned editable memory). Reflect on Stop hook: ${isReflectEnabled() ? "on" : "off"}`);
 	const snapshotConfig = loadSnapshotConfig();
 	if (snapshotConfig.enabled) {
 		registerSnapshotFunction(sdk, kv, snapshotConfig.dir);
-		console.log(`[agentmemory] Git snapshots: ${snapshotConfig.dir} (every ${snapshotConfig.interval}s)`);
+		bootLog(`Git snapshots: ${snapshotConfig.dir} (every ${snapshotConfig.interval}s)`);
 	}
 	const bm25Index = getSearchIndex();
 	const graphWeight = parseFloat(getEnvVar("AGENTMEMORY_GRAPH_WEIGHT") || "0.3");
@@ -19751,7 +19779,7 @@ async function main() {
 	});
 	if (loaded?.bm25 && loaded.bm25.size > 0) {
 		bm25Index.restoreFrom(loaded.bm25);
-		console.log(`[agentmemory] Loaded persisted BM25 index (${bm25Index.size} docs)`);
+		bootLog(`Loaded persisted BM25 index (${bm25Index.size} docs)`);
 	}
 	if (loaded?.vector && vectorIndex && loaded.vector.size > 0) {
 		const activeDim = embeddingProvider?.dimensions ?? 0;
@@ -19766,7 +19794,7 @@ async function main() {
 			else throw new Error(`[agentmemory] Refusing to start: persisted vector index has ${mismatches.length} of ${loaded.vector.size} vectors with the wrong dimension. Active provider (${embeddingProvider?.name}) declares ${activeDim}; dimensions seen on disk: ${distinct}. First mismatched obsIds: ${sample}. Loading would silently corrupt search (cross-dimension cosine returns 0). Choose one:\n  - Re-embed the existing index against the new provider, then start.\n  - Set AGENTMEMORY_DROP_STALE_INDEX=true to discard the persisted vectors and rebuild from live observations.\n  - Switch the embedding provider back to the one that wrote the index.`);
 		} else {
 			vectorIndex.restoreFrom(loaded.vector);
-			console.log(`[agentmemory] Loaded persisted vector index (${vectorIndex.size} vectors)`);
+			bootLog(`Loaded persisted vector index (${vectorIndex.size} vectors)`);
 		}
 	}
 	if (bm25Index.size === 0) {
@@ -19775,7 +19803,7 @@ async function main() {
 			return 0;
 		});
 		if (indexCount > 0) {
-			console.log(`[agentmemory] Search index rebuilt: ${indexCount} entries`);
+			bootLog(`Search index rebuilt: ${indexCount} entries`);
 			indexPersistence.scheduleSave();
 		}
 	} else try {
@@ -19800,14 +19828,15 @@ async function main() {
 			backfilled++;
 		}
 		if (backfilled > 0) {
-			console.log(`[agentmemory] Backfilled ${backfilled} memories into BM25 (legacy gap before #257)`);
+			bootLog(`Backfilled ${backfilled} memories into BM25 (legacy gap before #257)`);
 			indexPersistence.scheduleSave();
 		}
 	} catch (err) {
 		console.warn(`[agentmemory] Failed to backfill memories into BM25:`, err);
 	}
-	console.log(`[agentmemory] Ready. ${embeddingProvider ? "Triple-stream (BM25+Vector+Graph)" : "BM25+Graph"} search active.`);
-	console.log(`[agentmemory] Endpoints: 107 REST + ${getAllTools().length} MCP tools + 6 MCP resources + 3 MCP prompts`);
+	bootLog(`Ready. ${embeddingProvider ? "Triple-stream (BM25+Vector+Graph)" : "BM25+Graph"} search active.`);
+	bootLog(`REST API: 107 endpoints at http://localhost:${config.restPort}/agentmemory/*`);
+	bootLog(`MCP surface (opt-in via \`npx @agentmemory/mcp\`): ${getAllTools().length} tools · 6 resources · 3 prompts`);
 	const viewerServer = startViewerServer(config.restPort + 2, kv, sdk, secret, config.restPort);
 	const autoForgetIntervalMs = parseInt(process.env.AUTO_FORGET_INTERVAL_MS || "3600000", 10);
 	const consolidationIntervalMs = parseInt(process.env.CONSOLIDATION_INTERVAL_MS || "7200000", 10);
@@ -19820,7 +19849,7 @@ async function main() {
 				});
 			} catch {}
 		}, autoForgetIntervalMs).unref();
-		console.log(`[agentmemory] Auto-forget: enabled (every ${autoForgetIntervalMs / 6e4}m)`);
+		bootLog(`Auto-forget: enabled (every ${autoForgetIntervalMs / 6e4}m)`);
 	}
 	if (process.env.LESSON_DECAY_ENABLED !== "false") {
 		setInterval(async () => {
@@ -19831,7 +19860,7 @@ async function main() {
 				});
 			} catch {}
 		}, 864e5).unref();
-		console.log(`[agentmemory] Lesson decay sweep: enabled (every 24h)`);
+		bootLog(`Lesson decay sweep: enabled (every 24h)`);
 	}
 	if (process.env.INSIGHT_DECAY_ENABLED !== "false") setInterval(async () => {
 		try {
@@ -19850,7 +19879,7 @@ async function main() {
 				});
 			} catch {}
 		}, consolidationIntervalMs).unref();
-		console.log(`[agentmemory] Auto-consolidation: enabled (every ${consolidationIntervalMs / 6e4}m)`);
+		bootLog(`Auto-consolidation: enabled (every ${consolidationIntervalMs / 6e4}m)`);
 	}
 	const shutdown = async () => {
 		console.log(`\n[agentmemory] Shutting down...`);