@agentmemory/agentmemory 0.9.3 → 0.9.5

package/dist/index.mjs

@@ -50,7 +50,14 @@ function loadEnvFile() {
 		if (eqIdx === -1) continue;
 		const key = trimmed.slice(0, eqIdx).trim();
 		let val = trimmed.slice(eqIdx + 1).trim();
-		if (val.startsWith("\"") && val.endsWith("\"") || val.startsWith("'") && val.endsWith("'")) val = val.slice(1, -1);
+		const quoteChar = val[0] === "\"" || val[0] === "'" ? val[0] : "";
+		if (quoteChar) {
+			const closeIdx = val.indexOf(quoteChar, 1);
+			if (closeIdx !== -1) val = val.slice(1, closeIdx);
+		} else {
+			const hashIdx = val.indexOf(" #");
+			if (hashIdx !== -1) val = val.slice(0, hashIdx).trim();
+		}
 		vars[key] = val;
 	}
 	return vars;
@@ -123,6 +130,11 @@ function getMergedEnv(overrides) {
 function getEnvVar(key) {
 	return getMergedEnv()[key];
 }
+function detectLlmProviderKind() {
+	const env = getMergedEnv();
+	if (hasRealValue(env["ANTHROPIC_API_KEY"]) || hasRealValue(env["GEMINI_API_KEY"]) || hasRealValue(env["GOOGLE_API_KEY"]) || hasRealValue(env["OPENROUTER_API_KEY"]) || hasRealValue(env["MINIMAX_API_KEY"])) return "llm";
+	return "noop";
+}
 function loadEmbeddingConfig() {
 	const env = getMergedEnv();
 	let bm25Weight = parseFloat(env["BM25_WEIGHT"] || "0.4");
@@ -883,22 +895,38 @@ let imageEmbeddingProvider = null;
 function createImageEmbeddingProvider() {
 	if (process.env["AGENTMEMORY_IMAGE_EMBEDDINGS"] !== "true") return null;
 	if (imageEmbeddingProvider) return imageEmbeddingProvider;
-	imageEmbeddingProvider = new ClipEmbeddingProvider();
+	imageEmbeddingProvider = withDimensionGuard(new ClipEmbeddingProvider());
 	return imageEmbeddingProvider;
 }
 function createEmbeddingProvider() {
 	const detected = detectEmbeddingProvider();
 	if (!detected) return null;
 	switch (detected) {
-		case "gemini": return new GeminiEmbeddingProvider(getEnvVar("GEMINI_API_KEY"));
-		case "openai": return new OpenAIEmbeddingProvider(getEnvVar("OPENAI_API_KEY"));
-		case "voyage": return new VoyageEmbeddingProvider(getEnvVar("VOYAGE_API_KEY"));
-		case "cohere": return new CohereEmbeddingProvider(getEnvVar("COHERE_API_KEY"));
-		case "openrouter": return new OpenRouterEmbeddingProvider(getEnvVar("OPENROUTER_API_KEY"));
-		case "local": return new LocalEmbeddingProvider();
+		case "gemini": return withDimensionGuard(new GeminiEmbeddingProvider(getEnvVar("GEMINI_API_KEY")));
+		case "openai": return withDimensionGuard(new OpenAIEmbeddingProvider(getEnvVar("OPENAI_API_KEY")));
+		case "voyage": return withDimensionGuard(new VoyageEmbeddingProvider(getEnvVar("VOYAGE_API_KEY")));
+		case "cohere": return withDimensionGuard(new CohereEmbeddingProvider(getEnvVar("COHERE_API_KEY")));
+		case "openrouter": return withDimensionGuard(new OpenRouterEmbeddingProvider(getEnvVar("OPENROUTER_API_KEY")));
+		case "local": return withDimensionGuard(new LocalEmbeddingProvider());
 		default: return null;
 	}
 }
+function withDimensionGuard(provider) {
+	const expected = provider.dimensions;
+	const check = (v, where) => {
+		if (v.length !== expected) throw new Error(`Embedding dimension mismatch in ${provider.name}.${where}: expected ${expected}, got ${v.length}`);
+		return v;
+	};
+	const wrapped = Object.create(provider);
+	wrapped.embed = async (t) => check(await provider.embed(t), "embed");
+	wrapped.embedBatch = async (ts) => {
+		const out = await provider.embedBatch(ts);
+		out.forEach((v, i) => check(v, `embedBatch[${i}]`));
+		return out;
+	};
+	if (provider.embedImage) wrapped.embedImage = async (s) => check(await provider.embedImage(s), "embedImage");
+	return wrapped;
+}
 
 //#endregion
 //#region src/providers/index.ts
@@ -994,6 +1022,75 @@ var StateKV = class {
 	}
 };
 
+//#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"
+};
+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/state/vector-index.ts
 function float32ToBase64(arr) {
@@ -1057,6 +1154,22 @@ var VectorIndex = class VectorIndex {
 	get size() {
 		return this.vectors.size;
 	}
+	validateDimensions(expected) {
+		const mismatches = [];
+		const seenDimensions = /* @__PURE__ */ new Set();
+		for (const [obsId, entry] of this.vectors) {
+			const dim = entry.embedding.length;
+			seenDimensions.add(dim);
+			if (dim !== expected) mismatches.push({
+				obsId,
+				dim
+			});
+		}
+		return {
+			mismatches,
+			seenDimensions
+		};
+	}
 	clear() {
 		this.vectors.clear();
 	}
@@ -1100,75 +1213,6 @@ var VectorIndex = class VectorIndex {
 	}
 };
 
-//#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"
-};
-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/functions/graph-retrieval.ts
 function buildGraphContext(path) {
@@ -2040,6 +2084,9 @@ var SearchIndex = class SearchIndex {
 		}
 		this.sortedTerms = null;
 	}
+	has(id) {
+		return this.entries.has(id);
+	}
 	search(query, limit = 20) {
 		const rawTerms = this.tokenize(query.toLowerCase());
 		if (rawTerms.length === 0) return [];
@@ -2183,8 +2230,10 @@ var SearchIndex = class SearchIndex {
 //#endregion
 //#region src/state/index-persistence.ts
 const DEBOUNCE_MS = 5e3;
+const FAILURE_LOG_THROTTLE_MS = 6e4;
 var IndexPersistence = class {
 	timer = null;
+	lastFailureLogAt = 0;
 	constructor(kv, bm25, vector) {
 		this.kv = kv;
 		this.bm25 = bm25;
@@ -2192,15 +2241,21 @@ var IndexPersistence = class {
 	}
 	scheduleSave() {
 		if (this.timer) clearTimeout(this.timer);
-		this.timer = setTimeout(() => this.save(), DEBOUNCE_MS);
+		this.timer = setTimeout(() => {
+			this.save().catch((err) => this.logFailure(err));
+		}, DEBOUNCE_MS);
 	}
 	async save() {
 		if (this.timer) {
 			clearTimeout(this.timer);
 			this.timer = null;
 		}
-		await this.kv.set(KV.bm25Index, "data", this.bm25.serialize());
-		if (this.vector && this.vector.size > 0) await this.kv.set(KV.bm25Index, "vectors", this.vector.serialize());
+		try {
+			await this.kv.set(KV.bm25Index, "data", this.bm25.serialize());
+			if (this.vector && this.vector.size > 0) await this.kv.set(KV.bm25Index, "vectors", this.vector.serialize());
+		} catch (err) {
+			this.logFailure(err);
+		}
 	}
 	async load() {
 		let bm25 = null;
@@ -2220,6 +2275,18 @@ var IndexPersistence = class {
 			this.timer = null;
 		}
 	}
+	logFailure(err) {
+		const now = Date.now();
+		if (now - this.lastFailureLogAt < FAILURE_LOG_THROTTLE_MS) return;
+		this.lastFailureLogAt = now;
+		const code = err?.code;
+		const message = err instanceof Error ? err.message : String(err);
+		logger.warn("index persistence: failed to save BM25/vector index", {
+			code,
+			message,
+			hint: code === "TIMEOUT" ? "iii-engine state::set timed out; recent index updates remain in memory and will retry on the next debounce flush" : void 0
+		});
+	}
 };
 
 //#endregion
@@ -2440,6 +2507,20 @@ async function deleteAccessLog(kv, memoryId) {
 
 //#endregion
 //#region src/functions/search.ts
+function memoryAsIndexable$1(memory) {
+	return {
+		id: memory.id,
+		sessionId: memory.sessionIds[0] ?? "memory",
+		timestamp: memory.createdAt,
+		type: "decision",
+		title: memory.title,
+		facts: [memory.content],
+		narrative: memory.content,
+		concepts: memory.concepts,
+		files: memory.files,
+		importance: memory.strength
+	};
+}
 let index = null;
 function getSearchIndex() {
 	if (!index) index = new SearchIndex();
@@ -2448,9 +2529,20 @@ function getSearchIndex() {
 async function rebuildIndex(kv) {
 	const idx = getSearchIndex();
 	idx.clear();
-	const sessions = await kv.list(KV.sessions);
-	if (!sessions.length) return 0;
 	let count = 0;
+	try {
+		const memories = await kv.list(KV.memories);
+		for (const memory of memories) {
+			if (memory.isLatest === false) continue;
+			if (!memory.title || !memory.content) continue;
+			idx.add(memoryAsIndexable$1(memory));
+			count++;
+		}
+	} catch (err) {
+		logger.warn("rebuildIndex: failed to load memories", { error: err instanceof Error ? err.message : String(err) });
+	}
+	const sessions = await kv.list(KV.sessions);
+	if (!sessions.length) return count;
 	const obsPerSession = [];
 	const failedSessions = [];
 	for (let batch = 0; batch < sessions.length; batch += 10) {
@@ -4756,6 +4848,20 @@ function registerPatternsFunction(sdk, kv) {
 
 //#endregion
 //#region src/functions/remember.ts
+function memoryAsIndexable(memory) {
+	return {
+		id: memory.id,
+		sessionId: memory.sessionIds[0] ?? "memory",
+		timestamp: memory.createdAt,
+		type: "decision",
+		title: memory.title,
+		facts: [memory.content],
+		narrative: memory.content,
+		concepts: memory.concepts,
+		files: memory.files,
+		importance: memory.strength
+	};
+}
 function registerRememberFunction(sdk, kv) {
 	sdk.registerFunction("mem::remember", async (data) => {
 		if (!data.content || typeof data.content !== "string" || !data.content.trim()) return {
@@ -4821,6 +4927,14 @@ function registerRememberFunction(sdk, kv) {
 				await kv.set(KV.memories, supersededMemory.id, supersededMemory);
 			}
 			await kv.set(KV.memories, memory.id, memory);
+			try {
+				getSearchIndex().add(memoryAsIndexable(memory));
+			} catch (err) {
+				logger.warn("Failed to index saved memory into BM25", {
+					memId: memory.id,
+					error: err instanceof Error ? err.message : String(err)
+				});
+			}
 			if (supersededId) await sdk.trigger({
 				function_id: "mem::cascade-update",
 				payload: { supersededMemoryId: supersededId },
@@ -5618,7 +5732,7 @@ function registerAutoForgetFunction(sdk, kv) {
 
 //#endregion
 //#region src/version.ts
-const VERSION = "0.9.3";
+const VERSION = "0.9.5";
 
 //#endregion
 //#region src/functions/export-import.ts
@@ -5739,7 +5853,9 @@ function registerExportImportFunction(sdk, kv) {
 			"0.9.0",
 			"0.9.1",
 			"0.9.2",
-			"0.9.3"
+			"0.9.3",
+			"0.9.4",
+			"0.9.5"
 		]).has(importData.version)) return {
 			success: false,
 			error: `Unsupported export version: ${importData.version}`
@@ -12357,7 +12473,7 @@ function parseJsonlText(text, fallbackSessionId) {
 		const parsed = JSON.parse(line);
 		if (parsed && typeof parsed === "object") entries.push(parsed);
 	} catch {}
-	let sessionId = fallbackSessionId || "";
+	let sessionId = "";
 	let cwd = "";
 	let firstTs = "";
 	let lastTs = "";
@@ -12418,7 +12534,7 @@ function parseJsonlText(text, fallbackSessionId) {
 			});
 		} else if (entry.type === "summary" || entry.type === "system") {}
 	}
-	const effectiveSessionId = sessionId || generateId("sess");
+	const effectiveSessionId = sessionId || fallbackSessionId || generateId("sess");
 	for (const obs of observations) if (obs.sessionId === "imported") obs.sessionId = effectiveSessionId;
 	const nowIso = (/* @__PURE__ */ new Date()).toISOString();
 	return {
@@ -12528,6 +12644,8 @@ function projectTimeline(observations) {
 
 //#endregion
 //#region src/functions/replay.ts
+const MAX_FILES_DEFAULT = 200;
+const MAX_FILES_UPPER_BOUND = 1e3;
 const SENSITIVE_PATH_PATTERNS = [
 	/(^|[\\/_.-])secret([\\/_.-]|s?$)/i,
 	/(^|[\\/_.-])credentials?([\\/_.-]|$)/i,
@@ -12662,8 +12780,11 @@ async function loadObservations(kv, sessionId) {
 }
 async function findJsonlFiles(root, limit = 200) {
 	const out = [];
+	let discovered = 0;
+	let walked = 0;
+	const traversalCap = Math.max(limit * 50, 5e4);
 	async function walk(dir) {
-		if (out.length >= limit) return;
+		if (walked >= traversalCap) return;
 		let names;
 		try {
 			names = await readdir(dir);
@@ -12671,7 +12792,8 @@ async function findJsonlFiles(root, limit = 200) {
 			return;
 		}
 		for (const name of names) {
-			if (out.length >= limit) return;
+			if (walked >= traversalCap) return;
+			walked++;
 			const full = join(dir, name);
 			let st;
 			try {
@@ -12681,11 +12803,20 @@ async function findJsonlFiles(root, limit = 200) {
 			}
 			if (st.isSymbolicLink()) continue;
 			if (st.isDirectory()) await walk(full);
-			else if (st.isFile() && name.endsWith(".jsonl")) out.push(full);
+			else if (st.isFile() && name.endsWith(".jsonl")) {
+				discovered++;
+				if (out.length < limit) out.push(full);
+			}
 		}
 	}
 	await walk(root);
-	return out;
+	const traversalCapped = walked >= traversalCap;
+	return {
+		files: out,
+		truncated: discovered > out.length || traversalCapped,
+		discovered,
+		traversalCapped
+	};
 }
 function registerReplayFunctions(sdk, kv) {
 	sdk.registerFunction("mem::replay::load", async (data) => {
@@ -12733,10 +12864,21 @@ function registerReplayFunctions(sdk, kv) {
 				error: "path not found"
 			};
 		}
+		const maxFiles = Number.isInteger(data.maxFiles) && data.maxFiles > 0 ? Math.min(data.maxFiles, MAX_FILES_UPPER_BOUND) : MAX_FILES_DEFAULT;
 		let files = [];
-		if (stat.isDirectory()) files = await findJsonlFiles(abs, data.maxFiles || 200);
-		else if (stat.isFile() && abs.endsWith(".jsonl")) files = [abs];
-		else return {
+		let truncated = false;
+		let discovered = 0;
+		let traversalCapped = false;
+		if (stat.isDirectory()) {
+			const found = await findJsonlFiles(abs, maxFiles);
+			files = found.files;
+			truncated = found.truncated;
+			discovered = found.discovered;
+			traversalCapped = found.traversalCapped;
+		} else if (stat.isFile() && abs.endsWith(".jsonl")) {
+			files = [abs];
+			discovered = 1;
+		} else return {
 			success: false,
 			error: "path must be a .jsonl file or directory"
 		};
@@ -12744,7 +12886,12 @@ function registerReplayFunctions(sdk, kv) {
 			success: true,
 			imported: 0,
 			sessionIds: [],
-			observations: 0
+			observations: 0,
+			discovered,
+			truncated,
+			traversalCapped,
+			maxFiles,
+			maxFilesUpperBound: MAX_FILES_UPPER_BOUND
 		};
 		const sessionIds = [];
 		let observationCount = 0;
@@ -12810,7 +12957,12 @@ function registerReplayFunctions(sdk, kv) {
 			success: true,
 			imported: files.length,
 			sessionIds,
-			observations: observationCount
+			observations: observationCount,
+			discovered,
+			truncated,
+			traversalCapped,
+			maxFiles,
+			maxFilesUpperBound: MAX_FILES_UPPER_BOUND
 		};
 	});
 }
@@ -13113,12 +13265,11 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction("api::config-flags", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
-		const env = process.env;
 		return {
 			status_code: 200,
 			body: {
 				version: VERSION,
-				provider: env["ANTHROPIC_API_KEY"] || env["GEMINI_API_KEY"] || env["OPENROUTER_API_KEY"] || env["MINIMAX_API_KEY"] ? "llm" : "noop",
+				provider: detectLlmProviderKind(),
 				embeddingProvider: detectEmbeddingProvider() ? "embeddings" : "none",
 				flags: [
 					{
@@ -13416,11 +13567,12 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			payload.path = body.path.trim();
 		}
 		if (body.maxFiles !== void 0) {
-			if (!Number.isInteger(body.maxFiles) || body.maxFiles < 1) return {
+			const n = body.maxFiles;
+			if (!Number.isInteger(n) || n < 1 || n > MAX_FILES_UPPER_BOUND) return {
 				status_code: 400,
-				body: { error: "maxFiles must be a positive integer" }
+				body: { error: `maxFiles must be an integer between 1 and ${MAX_FILES_UPPER_BOUND}` }
 			};
-			payload.maxFiles = body.maxFiles;
+			payload.maxFiles = n;
 		}
 		return {
 			status_code: 202,
@@ -14336,6 +14488,32 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			http_method: "GET"
 		}
 	});
+	sdk.registerFunction("api::memory-by-id", async (req) => {
+		const authErr = checkAuth(req, secret);
+		if (authErr) return authErr;
+		const id = req.path_params?.["id"];
+		if (!id || typeof id !== "string") return {
+			status_code: 400,
+			body: { error: "id path parameter is required" }
+		};
+		const memory = await kv.get(KV.memories, id);
+		if (!memory) return {
+			status_code: 404,
+			body: { error: `memory not found: ${id}` }
+		};
+		return {
+			status_code: 200,
+			body: { memory }
+		};
+	});
+	sdk.registerTrigger({
+		type: "http",
+		function_id: "api::memory-by-id",
+		config: {
+			api_path: "/agentmemory/memories/:id",
+			http_method: "GET"
+		}
+	});
 	sdk.registerFunction("api::semantic-list", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
@@ -16214,6 +16392,15 @@ function registerEventTriggers(sdk, kv) {
 				error: err instanceof Error ? err.message : String(err)
 			});
 		}
+		if (isGraphExtractionEnabled()) try {
+			const compressed = (await kv.list(KV.observations(data.sessionId))).filter((o) => o.title);
+			if (compressed.length > 0) sdk.triggerVoid("mem::graph-extract", { observations: compressed });
+		} catch (err) {
+			logger.warn("graph-extract triggerVoid failed", {
+				sessionId: data.sessionId,
+				error: err instanceof Error ? err.message : String(err)
+			});
+		}
 		return summary;
 	});
 	sdk.registerTrigger({
@@ -19198,6 +19385,14 @@ function initMetrics(getMeter) {
 function hasGetMeter(sdk) {
 	return typeof sdk === "object" && sdk !== null && "getMeter" in sdk && typeof sdk.getMeter === "function";
 }
+let lastUnhandledLogAt = 0;
+process.on("unhandledRejection", (reason) => {
+	const now = Date.now();
+	if (now - lastUnhandledLogAt < 6e4) return;
+	lastUnhandledLogAt = now;
+	const r = reason;
+	console.warn(`[agentmemory] unhandledRejection (suppressed):`, r?.code ? `${r.code} ${r.function_id ?? ""} ${r.message ?? ""}`.trim() : reason);
+});
 async function main() {
 	const config = loadConfig();
 	const embeddingConfig = loadEmbeddingConfig();
@@ -19215,6 +19410,7 @@ async function main() {
 	console.log(`[agentmemory] Streams: ws://localhost:${config.streamsPort}`);
 	const sdk = registerWorker(config.engineUrl, {
 		workerName: "agentmemory",
+		invocationTimeoutMs: 18e4,
 		otel: {
 			serviceName: OTEL_CONFIG.serviceName,
 			serviceVersion: OTEL_CONFIG.serviceVersion,
@@ -19323,8 +19519,20 @@ async function main() {
 		console.log(`[agentmemory] Loaded persisted BM25 index (${bm25Index.size} docs)`);
 	}
 	if (loaded?.vector && vectorIndex && loaded.vector.size > 0) {
-		vectorIndex.restoreFrom(loaded.vector);
-		console.log(`[agentmemory] Loaded persisted vector index (${vectorIndex.size} vectors)`);
+		const activeDim = embeddingProvider?.dimensions ?? 0;
+		const { mismatches, seenDimensions } = activeDim > 0 ? loaded.vector.validateDimensions(activeDim) : {
+			mismatches: [],
+			seenDimensions: /* @__PURE__ */ new Set()
+		};
+		if (mismatches.length > 0) {
+			const sample = mismatches.slice(0, 5).map((m) => `${m.obsId} (dim=${m.dim})`).join(", ");
+			const distinct = Array.from(seenDimensions).sort((a, b) => a - b).join(", ");
+			if (process.env["AGENTMEMORY_DROP_STALE_INDEX"] === "true") console.warn(`[agentmemory] 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}. AGENTMEMORY_DROP_STALE_INDEX=true is set — discarding the persisted vectors. Live observations will rebuild the index over time.`);
+			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)`);
+		}
 	}
 	if (bm25Index.size === 0) {
 		const indexCount = await rebuildIndex(kv).catch((err) => {
@@ -19332,9 +19540,36 @@ async function main() {
 			return 0;
 		});
 		if (indexCount > 0) {
-			console.log(`[agentmemory] Search index rebuilt: ${indexCount} observations`);
+			console.log(`[agentmemory] Search index rebuilt: ${indexCount} entries`);
 			indexPersistence.scheduleSave();
 		}
+	} else try {
+		const memories = await kv.list(KV.memories);
+		let backfilled = 0;
+		for (const memory of memories) {
+			if (memory.isLatest === false) continue;
+			if (!memory.title || !memory.content) continue;
+			if (bm25Index.has(memory.id)) continue;
+			bm25Index.add({
+				id: memory.id,
+				sessionId: memory.sessionIds[0] ?? "memory",
+				timestamp: memory.createdAt,
+				type: "decision",
+				title: memory.title,
+				facts: [memory.content],
+				narrative: memory.content,
+				concepts: memory.concepts,
+				files: memory.files,
+				importance: memory.strength
+			});
+			backfilled++;
+		}
+		if (backfilled > 0) {
+			console.log(`[agentmemory] 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`);