@agentmemory/agentmemory 0.9.14 → 0.9.15

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.15";
 
 //#endregion
 //#region src/functions/export-import.ts
@@ -6088,7 +6099,8 @@ function registerExportImportFunction(sdk, kv) {
 			"0.9.11",
 			"0.9.12",
 			"0.9.13",
-			"0.9.14"
+			"0.9.14",
+			"0.9.15"
 		]).has(importData.version)) return {
 			success: false,
 			error: `Unsupported export version: ${importData.version}`
@@ -19395,8 +19407,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 +19447,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 +19660,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 +19710,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 +19755,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 +19778,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 +19793,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 +19802,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 +19827,14 @@ 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(`Endpoints: 107 REST + ${getAllTools().length} MCP tools + 6 MCP resources + 3 MCP 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 +19847,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 +19858,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 +19877,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...`);