@agentmemory/agentmemory 0.9.14 → 0.9.16

package/dist/{src-BBI-ah3h.mjs → src-3Oy_OOlF.mjs}

@@ -1,6 +1,6 @@
-import { a as jaccardSimilarity, i as generateId, n as STREAM, r as fingerprintId, t as KV } from "./cli.mjs";
-import { a as isManagedImagePath, getImageRefCount, i as getMaxBytes, n as IMAGES_DIR, r as deleteImage, t as withKeyedLock } from "./image-refs-HVu22rfu.mjs";
-import { _ as loadSnapshotConfig, a as detectLlmProviderKind, d as isContextInjectionEnabled, f as isGraphExtractionEnabled, g as loadFallbackConfig, h as loadEmbeddingConfig, i as detectEmbeddingProvider, l as isAutoCompressEnabled, m as loadConfig, n as getVisibleTools, o as getConsolidationDecayDays, p as loadClaudeBridgeConfig, r as VERSION, s as getEnvVar, t as getAllTools, u as isConsolidationEnabled, v as loadTeamConfig } from "./tools-registry-BDimtXJb.mjs";
+import { a as STREAM, c as jaccardSimilarity, i as KV, n as bootLog, o as fingerprintId, r as logger, s as generateId, t as VERSION } from "./cli.mjs";
+import { a as isManagedImagePath, getImageRefCount, i as getMaxBytes, n as IMAGES_DIR, r as deleteImage, t as withKeyedLock } from "./image-refs-R3tin9MR.mjs";
+import { _ as loadTeamConfig, a as getConsolidationDecayDays, c as isAutoCompressEnabled, d as isGraphExtractionEnabled, f as loadClaudeBridgeConfig, g as loadSnapshotConfig, h as loadFallbackConfig, i as detectLlmProviderKind, l as isConsolidationEnabled, m as loadEmbeddingConfig, n as getVisibleTools, o as getEnvVar, p as loadConfig, r as detectEmbeddingProvider, t as getAllTools, u as isContextInjectionEnabled } from "./tools-registry-BF0pgZmI.mjs";
 import { createRequire } from "node:module";
 import { execFile } from "node:child_process";
 import { constants, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
@@ -1143,33 +1143,6 @@ var GraphRetrieval = class {
 	}
 };
 
-//#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);
-	}
-};
-
 //#endregion
 //#region src/functions/query-expansion.ts
 const QUERY_EXPANSION_SYSTEM = `You are a query expansion engine for a memory retrieval system. Given a user query, generate diverse reformulations to maximize recall.
@@ -2674,10 +2647,10 @@ function registerObserveFunction(sdk, kv, dedupMap, maxObservationsPerSession) {
 				};
 			}
 			if (pendingImageData && (pendingImageData.startsWith("data:image/") || pendingImageData.startsWith("iVBORw0KGgo") || pendingImageData.startsWith("/9j/"))) {
-				const { saveImageToDisk } = await import("./image-store-BfN1vDbj.mjs");
+				const { saveImageToDisk } = await import("./image-store-DyrKZKqZ.mjs");
 				const { filePath, bytesWritten } = await saveImageToDisk(pendingImageData);
 				raw.imageData = filePath;
-				const { incrementImageRef } = await import("./image-refs-HVu22rfu.mjs");
+				const { incrementImageRef } = await import("./image-refs-R3tin9MR.mjs");
 				await incrementImageRef(kv, filePath);
 				sdk.triggerVoid("mem::disk-size-delta", { deltaBytes: bytesWritten });
 				if (process.env["AGENTMEMORY_IMAGE_EMBEDDINGS"] === "true") sdk.triggerVoid("mem::vision-embed", {
@@ -2690,7 +2663,7 @@ function registerObserveFunction(sdk, kv, dedupMap, maxObservationsPerSession) {
 				await kv.set(KV.observations(payload.sessionId), obsId, raw);
 			} catch (error) {
 				if (raw.imageData) {
-					const { deleteImage } = await import("./image-store-BfN1vDbj.mjs");
+					const { deleteImage } = await import("./image-store-DyrKZKqZ.mjs");
 					const { deletedBytes } = await deleteImage(raw.imageData);
 					if (deletedBytes > 0) sdk.triggerVoid("mem::disk-size-delta", { deltaBytes: -deletedBytes });
 				}
@@ -4776,7 +4749,7 @@ function registerRememberFunction(sdk, kv) {
 		const deletedMemoryIds = [];
 		const deletedObservationIds = [];
 		let deletedSession = false;
-		const { decrementImageRef } = await import("./image-refs-HVu22rfu.mjs");
+		const { decrementImageRef } = await import("./image-refs-R3tin9MR.mjs");
 		if (data.memoryId) {
 			const mem = await kv.get(KV.memories, data.memoryId);
 			await kv.delete(KV.memories, data.memoryId);
@@ -4835,7 +4808,7 @@ const DEFAULTS$1 = {
 function registerEvictFunction(sdk, kv) {
 	sdk.registerFunction("mem::evict", async (data) => {
 		const dryRun = data?.dryRun ?? false;
-		const { decrementImageRef } = await import("./image-refs-HVu22rfu.mjs");
+		const { decrementImageRef } = await import("./image-refs-R3tin9MR.mjs");
 		const configOverride = await kv.get(KV.config, "eviction").catch(() => null);
 		const cfg = {
 			...DEFAULTS$1,
@@ -5438,7 +5411,7 @@ function registerAutoForgetFunction(sdk, kv) {
 	sdk.registerFunction("mem::auto-forget", async (data) => {
 		const dryRun = data?.dryRun ?? false;
 		const now = Date.now();
-		const { decrementImageRef } = await import("./image-refs-HVu22rfu.mjs");
+		const { decrementImageRef } = await import("./image-refs-R3tin9MR.mjs");
 		const result = {
 			ttlExpired: [],
 			contradictions: [],
@@ -5681,7 +5654,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}`
@@ -12038,7 +12013,7 @@ function registerRetentionFunctions(sdk, kv) {
 		const threshold = typeof data?.threshold === "number" && Number.isFinite(data.threshold) ? data.threshold : DEFAULT_DECAY.tierThresholds.cold;
 		const maxEvictRaw = typeof data?.maxEvict === "number" && Number.isInteger(data.maxEvict) ? data.maxEvict : 50;
 		const maxEvict = Math.min(1e3, Math.max(0, maxEvictRaw));
-		const { decrementImageRef } = await import("./image-refs-HVu22rfu.mjs");
+		const { decrementImageRef } = await import("./image-refs-R3tin9MR.mjs");
 		const candidates = (await kv.list(KV.retentionScores)).filter((s) => s.score < threshold).sort((a, b) => a.score - b.score).slice(0, maxEvict);
 		if (data?.dryRun) return {
 			success: true,
@@ -17915,8 +17890,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("?");
@@ -17953,13 +17930,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) {
@@ -18153,14 +18143,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,
@@ -18203,22 +18193,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);
@@ -18248,13 +18238,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");
@@ -18271,7 +18261,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;
@@ -18286,7 +18276,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) {
@@ -18295,7 +18285,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 {
@@ -18320,14 +18310,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);
@@ -18340,7 +18331,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 () => {
@@ -18351,7 +18342,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 {
@@ -18370,7 +18361,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...`);
@@ -18394,4 +18385,4 @@ main().catch((err) => {
 
 //#endregion
 export {  };
-//# sourceMappingURL=src-BBI-ah3h.mjs.map
+//# sourceMappingURL=src-3Oy_OOlF.mjs.map