@agentmemory/agentmemory 0.9.22 → 0.9.23

package/dist/index.mjs

@@ -233,7 +233,17 @@ function isGraphExtractionEnabled() {
 	return getMergedEnv()["GRAPH_EXTRACTION_ENABLED"] === "true";
 }
 function isConsolidationEnabled() {
-	return getMergedEnv()["CONSOLIDATION_ENABLED"] === "true";
+	const env = getMergedEnv();
+	const explicit = env["CONSOLIDATION_ENABLED"];
+	if (explicit === "false" || explicit === "0") return false;
+	if (explicit === "true" || explicit === "1") return true;
+	return hasLLMProviderConfigured(env);
+}
+function hasLLMProviderConfigured(env) {
+	const provider = (env["AGENTMEMORY_PROVIDER"] || "").toLowerCase();
+	if (provider === "noop") return false;
+	const openaiKeyForLlm = env["OPENAI_API_KEY"] && (env["OPENAI_API_KEY_FOR_LLM"] || "").toLowerCase() !== "false";
+	return Boolean(env["ANTHROPIC_API_KEY"] || openaiKeyForLlm || env["OPENROUTER_API_KEY"] || env["GEMINI_API_KEY"] || env["GOOGLE_API_KEY"] || env["MINIMAX_API_KEY"] || env["OPENAI_BASE_URL"] || provider === "agent-sdk");
 }
 function isAutoCompressEnabled() {
 	return getMergedEnv()["AGENTMEMORY_AUTO_COMPRESS"] === "true";
@@ -886,16 +896,30 @@ function resolveDimensions(model, override) {
 * `api-key` header instead of `Authorization: Bearer`.
 *
 * Required env vars:
-*   OPENAI_API_KEY            — API key
+*   OPENAI_API_KEY               — API key (fallback for OPENAI_EMBEDDING_API_KEY)
 *
 * Optional:
-*   OPENAI_BASE_URL           — base URL without path (default: https://api.openai.com).
-*                               Azure: https://<resource>.openai.azure.com/openai/deployments/<deployment>
-*   OPENAI_API_VERSION        — Azure api-version query param (default: 2024-08-01-preview)
-*   OPENAI_EMBEDDING_MODEL    — model name (default: text-embedding-3-small)
-*   OPENAI_EMBEDDING_DIMENSIONS — override reported dimensions (required for
-*                                 custom / self-hosted models not in the
-*                                 MODEL_DIMENSIONS table above)
+*   OPENAI_BASE_URL              — base URL without path (default: https://api.openai.com).
+*                                  Azure: https://<resource>.openai.azure.com/openai/deployments/<deployment>
+*   OPENAI_EMBEDDING_BASE_URL    — embedding-specific base URL override (defaults
+*                                  to OPENAI_BASE_URL). Lets operators run
+*                                  embeddings on a separate endpoint from chat —
+*                                  e.g. local Ollama / LM Studio / llama.cpp /
+*                                  vLLM at http://localhost:1234 for unlimited
+*                                  free embeddings, while keeping chat
+*                                  completions on a rate-limited but high-quality
+*                                  hosted provider. Azure detection runs on
+*                                  whichever URL ends up selected.
+*   OPENAI_EMBEDDING_API_KEY     — separate API key for the embedding endpoint
+*                                  (defaults to OPENAI_API_KEY). Useful when the
+*                                  embedding endpoint requires a different key
+*                                  or no key at all (set to e.g. "local" for
+*                                  endpoints that ignore Authorization).
+*   OPENAI_API_VERSION           — Azure api-version query param (default: 2024-08-01-preview)
+*   OPENAI_EMBEDDING_MODEL       — model name (default: text-embedding-3-small)
+*   OPENAI_EMBEDDING_DIMENSIONS  — override reported dimensions (required for
+*                                  custom / self-hosted models not in the
+*                                  MODEL_DIMENSIONS table above)
 */
 var OpenAIEmbeddingProvider = class {
 	name = "openai";
@@ -906,9 +930,9 @@ var OpenAIEmbeddingProvider = class {
 	isAzure;
 	azureApiVersion;
 	constructor(apiKey) {
-		this.apiKey = apiKey || getEnvVar("OPENAI_API_KEY") || "";
-		if (!this.apiKey) throw new Error("OPENAI_API_KEY is required");
-		this.baseUrl = normalizeBaseUrl(getEnvVar("OPENAI_BASE_URL"));
+		this.apiKey = apiKey || getEnvVar("OPENAI_EMBEDDING_API_KEY") || getEnvVar("OPENAI_API_KEY") || "";
+		if (!this.apiKey) throw new Error("API key is required (via constructor, OPENAI_EMBEDDING_API_KEY, or OPENAI_API_KEY)");
+		this.baseUrl = normalizeBaseUrl(getEnvVar("OPENAI_EMBEDDING_BASE_URL") || getEnvVar("OPENAI_BASE_URL"));
 		this.model = getEnvVar("OPENAI_EMBEDDING_MODEL") || DEFAULT_MODEL$1;
 		this.dimensions = resolveDimensions(this.model, getEnvVar("OPENAI_EMBEDDING_DIMENSIONS"));
 		this.isAzure = detectAzure(this.baseUrl);
@@ -1355,10 +1379,11 @@ function jaccardSimilarity(a, b) {
 //#endregion
 //#region src/state/vector-index.ts
 function float32ToBase64(arr) {
-	return Buffer.from(arr.buffer).toString("base64");
+	return Buffer.from(arr.buffer, arr.byteOffset, arr.byteLength).toString("base64");
 }
 function base64ToFloat32(b64) {
-	return new Float32Array(Buffer.from(b64, "base64").buffer);
+	const buf = Buffer.from(b64, "base64");
+	return new Float32Array(buf.buffer, buf.byteOffset, buf.byteLength / Float32Array.BYTES_PER_ELEMENT);
 }
 function cosineSimilarity(a, b) {
 	if (a.length !== b.length) return 0;
@@ -1479,7 +1504,7 @@ var VectorIndex = class VectorIndex {
 function memoryToObservation(memory) {
 	return {
 		id: memory.id,
-		sessionId: memory.sessionIds[0] ?? "memory",
+		sessionId: memory.sessionIds?.[0] ?? "memory",
 		timestamp: memory.createdAt,
 		type: "decision",
 		title: memory.title,
@@ -3151,7 +3176,7 @@ async function rebuildIndex(kv) {
 			idx.add(memoryToObservation(memory));
 			await enqueue({
 				id: memory.id,
-				sessionId: memory.sessionIds[0] ?? "memory",
+				sessionId: memory.sessionIds?.[0] ?? "memory",
 				text: memory.title + " " + memory.content,
 				context: {
 					kind: "memory",
@@ -3210,8 +3235,8 @@ function registerSearchFunction(sdk, kv) {
 			if (!Number.isInteger(data.limit) || data.limit < 1) throw new Error("mem::search: limit must be a positive integer");
 			effectiveLimit = Math.min(data.limit, MAX_LIMIT);
 		}
-		const projectFilter = typeof data.project === "string" && data.project.length > 0 ? data.project : void 0;
-		const cwdFilter = typeof data.cwd === "string" && data.cwd.length > 0 ? data.cwd : void 0;
+		const projectFilter = typeof data.project === "string" && data.project.trim().length > 0 ? data.project.trim() : void 0;
+		const cwdFilter = typeof data.cwd === "string" && data.cwd.trim().length > 0 ? data.cwd.trim() : void 0;
 		const format = typeof data.format === "string" ? data.format : "full";
 		if (![
 			"full",
@@ -3237,14 +3262,25 @@ function registerSearchFunction(sdk, kv) {
 			sessionCache.set(sessionId, s ?? null);
 			return s ?? null;
 		};
+		const memoryProjectCache = /* @__PURE__ */ new Map();
+		const loadMemoryProject = async (obsId) => {
+			if (memoryProjectCache.has(obsId)) return memoryProjectCache.get(obsId);
+			const proj = (await kv.get(KV.memories, obsId).catch(() => null))?.project ?? null;
+			memoryProjectCache.set(obsId, proj);
+			return proj;
+		};
 		const candidates = [];
 		for (const r of results) {
 			if (candidates.length >= effectiveLimit) break;
 			if (filtering) {
 				const s = await loadSession(r.sessionId);
-				if (!s) continue;
-				if (projectFilter && s.project !== projectFilter) continue;
-				if (cwdFilter && s.cwd !== cwdFilter) continue;
+				if (s) {
+					if (projectFilter && s.project !== projectFilter) continue;
+					if (cwdFilter && s.cwd !== cwdFilter) continue;
+				} else if (projectFilter) {
+					const memProject = await loadMemoryProject(r.obsId);
+					if (memProject !== null && memProject !== projectFilter) continue;
+				}
 			}
 			candidates.push(r);
 		}
@@ -3996,10 +4032,10 @@ const DEFAULT_SLOTS = [
 	}
 ];
 function isSlotsEnabled() {
-	return process.env["AGENTMEMORY_SLOTS"] === "true";
+	return getEnvVar("AGENTMEMORY_SLOTS") === "true";
 }
 function isReflectEnabled() {
-	return process.env["AGENTMEMORY_REFLECT"] === "true";
+	return getEnvVar("AGENTMEMORY_REFLECT") === "true";
 }
 function scopeKv(scope) {
 	return scope === "global" ? KV.globalSlots : KV.slots;
@@ -5264,8 +5300,78 @@ function isAllowedPath(dbPath) {
 	const resolved = resolve(dbPath);
 	return ALLOWED_DIRS.some((dir) => resolved.startsWith(dir + "/"));
 }
+async function inferMemoryProjects(kv, dryRun = false) {
+	const memories = await kv.list(KV.memories);
+	const sessionCache = /* @__PURE__ */ new Map();
+	const loadSession = async (sid) => {
+		if (sessionCache.has(sid)) return sessionCache.get(sid);
+		const s = await kv.get(KV.sessions, sid).catch(() => null);
+		sessionCache.set(sid, s);
+		return s;
+	};
+	let updated = 0;
+	let skipped = 0;
+	let ambiguous = 0;
+	for (const memory of memories) {
+		if (memory.project) {
+			skipped++;
+			continue;
+		}
+		const sessionIds = memory.sessionIds ?? [];
+		if (sessionIds.length === 0) {
+			ambiguous++;
+			continue;
+		}
+		const projects = [];
+		for (const sid of sessionIds) {
+			const session = await loadSession(sid);
+			if (session?.project) projects.push(session.project);
+		}
+		if (projects.length === 0) {
+			ambiguous++;
+			continue;
+		}
+		const freq = /* @__PURE__ */ new Map();
+		for (const p of projects) freq.set(p, (freq.get(p) ?? 0) + 1);
+		const sorted = [...freq.entries()].sort((a, b) => b[1] - a[1]);
+		const [topProject, topCount] = sorted[0];
+		if (topCount <= projects.length / 2 && sorted.length > 1) {
+			ambiguous++;
+			continue;
+		}
+		if (!dryRun) {
+			memory.project = topProject;
+			await kv.set(KV.memories, memory.id, memory);
+		}
+		updated++;
+	}
+	logger.info("inferMemoryProjects complete", {
+		updated,
+		skipped,
+		ambiguous,
+		dryRun
+	});
+	return {
+		updated,
+		skipped,
+		ambiguous
+	};
+}
 function registerMigrateFunction(sdk, kv) {
 	sdk.registerFunction("mem::migrate", async (data) => {
+		if (data.step === "infer-memory-projects") {
+			const dryRun = data.dryRun ?? false;
+			logger.info("Migration step: infer-memory-projects", { dryRun });
+			return {
+				success: true,
+				step: "infer-memory-projects",
+				...await inferMemoryProjects(kv, dryRun)
+			};
+		}
+		if (!data.dbPath) return {
+			success: false,
+			error: "Either step or dbPath is required"
+		};
 		logger.info("Migration started", { dbPath: data.dbPath });
 		if (!isAllowedPath(data.dbPath)) return {
 			success: false,
@@ -5541,9 +5647,10 @@ function registerConsolidateFunction(sdk, kv, provider) {
 				llmCallCount++;
 				const parsed = parseMemoryXml(response, sessionIds);
 				if (!parsed) continue;
-				const existingMatch = existingMemories.find((m) => m.title.toLowerCase() === parsed.title.toLowerCase());
 				const now = (/* @__PURE__ */ new Date()).toISOString();
 				const obsIds = [...new Set(top.map((o) => o.id))];
+				const scopedProject = typeof data.project === "string" && data.project.trim().length > 0 ? data.project.trim() : void 0;
+				const existingMatch = existingMemories.find((m) => m.title.toLowerCase() === parsed.title.toLowerCase() && (!scopedProject || !m.project || m.project === scopedProject));
 				if (existingMatch) {
 					existingMatch.isLatest = false;
 					await kv.set(KV.memories, existingMatch.id, existingMatch);
@@ -5560,7 +5667,8 @@ function registerConsolidateFunction(sdk, kv, provider) {
 						parentId: existingMatch.id,
 						supersedes: [existingMatch.id, ...existingMatch.supersedes || []],
 						sourceObservationIds: obsIds,
-						isLatest: true
+						isLatest: true,
+						...scopedProject !== void 0 && { project: scopedProject }
 					};
 					await kv.set(KV.memories, evolved.id, evolved);
 					await recordAudit(kv, "evolve", "mem::consolidate", [evolved.id], {
@@ -5579,7 +5687,8 @@ function registerConsolidateFunction(sdk, kv, provider) {
 						...parsed,
 						sourceObservationIds: obsIds,
 						version: 1,
-						isLatest: true
+						isLatest: true,
+						...scopedProject !== void 0 && { project: scopedProject }
 					};
 					await kv.set(KV.memories, memory.id, memory);
 					await recordAudit(kv, "remember", "mem::consolidate", [memory.id], {
@@ -5720,6 +5829,7 @@ function registerRememberFunction(sdk, kv) {
 			"fact"
 		]).has(data.type || "") ? data.type : "fact";
 		const now = (/* @__PURE__ */ new Date()).toISOString();
+		const project = typeof data.project === "string" && data.project.trim().length > 0 ? data.project.trim() : void 0;
 		return withKeyedLock("mem:remember", async () => {
 			const existingMemories = await kv.list(KV.memories);
 			let supersededId;
@@ -5728,6 +5838,7 @@ function registerRememberFunction(sdk, kv) {
 			const lowerContent = data.content.toLowerCase();
 			for (const existing of existingMemories) {
 				if (existing.isLatest === false) continue;
+				if (project && existing.project && existing.project !== project) continue;
 				if (jaccardSimilarity(lowerContent, existing.content.toLowerCase()) > .7) {
 					supersededId = existing.id;
 					supersededVersion = existing.version ?? 1;
@@ -5752,7 +5863,8 @@ function registerRememberFunction(sdk, kv) {
 				supersedes: supersededId ? [supersededId] : [],
 				sourceObservationIds: (data.sourceObservationIds || []).filter((id) => typeof id === "string" && id.length > 0),
 				isLatest: true,
-				...callAgentId ? { agentId: callAgentId } : {}
+				...callAgentId ? { agentId: callAgentId } : {},
+				...project !== void 0 && { project }
 			};
 			if (data.ttlDays && typeof data.ttlDays === "number" && data.ttlDays > 0) memory.forgetAfter = new Date(Date.now() + data.ttlDays * 864e5).toISOString();
 			if (supersededMemory) {
@@ -5768,7 +5880,7 @@ function registerRememberFunction(sdk, kv) {
 					error: err instanceof Error ? err.message : String(err)
 				});
 			}
-			await vectorIndexAddGuarded(memory.id, memory.sessionIds[0] ?? "memory", memory.title + " " + memory.content, {
+			await vectorIndexAddGuarded(memory.id, memory.sessionIds?.[0] ?? "memory", memory.title + " " + memory.content, {
 				kind: "memory",
 				logId: memory.id
 			});
@@ -5779,7 +5891,8 @@ function registerRememberFunction(sdk, kv) {
 			});
 			logger.info("Memory saved", {
 				memId: memory.id,
-				type: memory.type
+				type: memory.type,
+				project: memory.project
 			});
 			return {
 				success: true,
@@ -6680,7 +6793,7 @@ function registerAutoForgetFunction(sdk, kv) {
 
 //#endregion
 //#region src/version.ts
-const VERSION = "0.9.22";
+const VERSION = "0.9.23";
 
 //#endregion
 //#region src/functions/export-import.ts
@@ -6820,7 +6933,8 @@ function registerExportImportFunction(sdk, kv) {
 			"0.9.19",
 			"0.9.20",
 			"0.9.21",
-			"0.9.22"
+			"0.9.22",
+			"0.9.23"
 		]).has(importData.version)) return {
 			success: false,
 			error: `Unsupported export version: ${importData.version}`
@@ -6943,6 +7057,7 @@ function registerExportImportFunction(sdk, kv) {
 					continue;
 				}
 			}
+			if (!Array.isArray(memory.sessionIds)) memory.sessionIds = [];
 			await kv.set(KV.memories, memory.id, memory);
 			stats.memories++;
 		}
@@ -7146,6 +7261,7 @@ function escapeXml(s) {
 }
 function registerEnrichFunction(sdk, kv) {
 	sdk.registerFunction("mem::enrich", async (data) => {
+		const project = typeof data.project === "string" && data.project.trim().length > 0 ? data.project.trim() : void 0;
 		const parts = [];
 		const fileContextPromise = sdk.trigger({
 			function_id: "mem::file-context",
@@ -7159,10 +7275,11 @@ function registerEnrichFunction(sdk, kv) {
 			function_id: "mem::search",
 			payload: {
 				query: searchQueries.join(" "),
-				limit: 5
+				limit: 5,
+				...project !== void 0 && { project }
 			}
 		}).catch(() => ({ results: [] })) : Promise.resolve({ results: [] });
-		const bugMemoriesPromise = kv.list(KV.memories).then((memories) => memories.filter((m) => m.type === "bug" && m.isLatest && m.files.some((f) => data.files.some((df) => f.includes(df) || df.includes(f)))).sort((a, b) => new Date(b.updatedAt || b.createdAt).getTime() - new Date(a.updatedAt || a.createdAt).getTime())).catch(() => []);
+		const bugMemoriesPromise = kv.list(KV.memories).then((memories) => memories.filter((m) => m.type === "bug" && m.isLatest && (!project || !m.project || m.project === project) && m.files.some((f) => data.files.some((df) => f.includes(df) || df.includes(f)))).sort((a, b) => new Date(b.updatedAt || b.createdAt).getTime() - new Date(a.updatedAt || a.createdAt).getTime())).catch(() => []);
 		const [fileContext, searchResult, bugMemories] = await Promise.all([
 			fileContextPromise,
 			searchPromise,
@@ -7185,6 +7302,7 @@ function registerEnrichFunction(sdk, kv) {
 		}
 		logger.info("Enrichment completed", {
 			sessionId: data.sessionId,
+			project,
 			fileCount: data.files.length,
 			contextLength: context.length,
 			truncated
@@ -7342,16 +7460,24 @@ function buildGraphExtractionPrompt(observations) {
 
 //#endregion
 //#region src/functions/graph.ts
+function parseAttrs(raw) {
+	const attrs = {};
+	const attrRegex = /([A-Za-z_][\w:-]*)="([^"]*)"/g;
+	let m;
+	while ((m = attrRegex.exec(raw)) !== null) attrs[m[1]] = m[2];
+	return attrs;
+}
 function parseGraphXml(xml, observationIds) {
 	const nodes = [];
 	const edges = [];
 	const now = (/* @__PURE__ */ new Date()).toISOString();
-	const entityRegex = /<entity\s+type="([^"]+)"\s+name="([^"]+)"[^>]*?(?:\/>|>([\s\S]*?)<\/entity>)/g;
-	let match;
-	while ((match = entityRegex.exec(xml)) !== null) {
-		const type = match[1];
-		const name = match[2];
-		const propsBlock = match[3] ?? "";
+	const entitySelfClose = /<entity\b([^>]*?)\/>/g;
+	const entityWithBody = /<entity\b([^>]*[^/])>([\s\S]*?)<\/entity>/g;
+	const addEntity = (rawAttrs, propsBlock = "") => {
+		const attrs = parseAttrs(rawAttrs);
+		const type = attrs["type"];
+		const name = attrs["name"];
+		if (!type || !name) return;
 		const properties = {};
 		const propRegex = /<property\s+key="([^"]+)">([^<]*)<\/property>/g;
 		let propMatch;
@@ -7364,17 +7490,23 @@ function parseGraphXml(xml, observationIds) {
 			sourceObservationIds: observationIds,
 			createdAt: now
 		});
-	}
-	const relRegex = /<relationship\s+type="([^"]+)"\s+source="([^"]+)"\s+target="([^"]+)"\s+weight="([^"]+)"\s*\/>/g;
+	};
+	let match;
+	while ((match = entitySelfClose.exec(xml)) !== null) addEntity(match[1]);
+	while ((match = entityWithBody.exec(xml)) !== null) addEntity(match[1], match[2]);
+	const relRegex = /<relationship\b([^>]*?)\/>/g;
 	while ((match = relRegex.exec(xml)) !== null) {
-		const type = match[1];
-		const sourceName = match[2];
-		const targetName = match[3];
-		const parsedWeight = parseFloat(match[4]);
-		const weight = Number.isNaN(parsedWeight) ? .5 : parsedWeight;
+		const attrs = parseAttrs(match[1]);
+		const type = attrs["type"];
+		const sourceName = attrs["source"];
+		const targetName = attrs["target"];
+		if (!type || !sourceName || !targetName) continue;
+		const parsedWeight = parseFloat(attrs["weight"] ?? "");
+		const weight = Number.isFinite(parsedWeight) ? parsedWeight : .5;
 		const sourceNode = nodes.find((n) => n.name === sourceName);
 		const targetNode = nodes.find((n) => n.name === targetName);
-		if (sourceNode && targetNode) edges.push({
+		if (!sourceNode || !targetNode) continue;
+		edges.push({
 			id: generateId("ge"),
 			type,
 			sourceNodeId: sourceNode.id,
@@ -7588,7 +7720,7 @@ function registerConsolidationPipelineFunction(sdk, kv, provider) {
 		if (!data?.force && !isConsolidationEnabled()) return {
 			success: false,
 			skipped: true,
-			reason: "CONSOLIDATION_ENABLED is not set to true"
+			reason: "Consolidation disabled: set CONSOLIDATION_ENABLED=true or configure an LLM provider (ANTHROPIC_API_KEY / OPENAI_API_KEY / OPENROUTER_API_KEY / GEMINI_API_KEY / GOOGLE_API_KEY / MINIMAX_API_KEY / OPENAI_BASE_URL / AGENTMEMORY_PROVIDER=agent-sdk)"
 		};
 		const tier = data?.tier || "all";
 		const decayDays = getConsolidationDecayDays();
@@ -10758,11 +10890,34 @@ function registerDiagnosticsFunction(sdk, kv) {
 				});
 				memoryIssues++;
 			}
+			const latestMemories = memories.filter((m) => m.isLatest);
+			const unscopedCount = latestMemories.filter((m) => !m.project).length;
+			if (unscopedCount === 0) checks.push({
+				name: "memory-project-coverage",
+				category: "memories",
+				status: "pass",
+				message: `All ${latestMemories.length} latest memories have a project scope`,
+				fixable: false
+			});
+			else if (unscopedCount <= 10) checks.push({
+				name: "memory-project-coverage",
+				category: "memories",
+				status: "warn",
+				message: `${unscopedCount} of ${latestMemories.length} latest memories have no project scope — run POST /agentmemory/migrate {"step":"infer-memory-projects"} to backfill`,
+				fixable: true
+			});
+			else checks.push({
+				name: "memory-project-coverage",
+				category: "memories",
+				status: "fail",
+				message: `${unscopedCount} of ${latestMemories.length} latest memories have no project scope — run POST /agentmemory/migrate {"step":"infer-memory-projects"} to backfill`,
+				fixable: true
+			});
 			if (memoryIssues === 0) checks.push({
 				name: "memories-ok",
 				category: "memories",
 				status: "pass",
-				message: `All ${memories.length} memories are consistent`,
+				message: `All ${memories.length} memories are structurally consistent`,
 				fixable: false
 			});
 		}
@@ -14535,6 +14690,22 @@ function consolidationDisabledResponse() {
 		docsHref: "https://github.com/rohitg00/agentmemory#consolidation"
 	});
 }
+function slotsDisabledResponse() {
+	return flagDisabledResponse({
+		error: "Memory slots not enabled",
+		flag: "AGENTMEMORY_SLOTS",
+		enableHow: "Set AGENTMEMORY_SLOTS=true (in ~/.agentmemory/.env or the shell) and restart.",
+		docsHref: "https://github.com/rohitg00/agentmemory#memory-slots"
+	});
+}
+function reflectDisabledResponse() {
+	return flagDisabledResponse({
+		error: "Slot reflection not enabled",
+		flag: "AGENTMEMORY_REFLECT",
+		enableHow: "Set AGENTMEMORY_REFLECT=true (in ~/.agentmemory/.env or the shell) and restart. Requires AGENTMEMORY_SLOTS=true.",
+		docsHref: "https://github.com/rohitg00/agentmemory#memory-slots"
+	});
+}
 function asNonEmptyString$1(value) {
 	if (typeof value !== "string") return null;
 	const trimmed = value.trim();
@@ -14979,6 +15150,14 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			path: "status",
 			value: "completed"
 		}]);
+		try {
+			sdk.triggerVoid("event::session::stopped", { sessionId });
+		} catch (err) {
+			logger.warn("event::session::stopped triggerVoid failed", {
+				sessionId,
+				error: err instanceof Error ? err.message : String(err)
+			});
+		}
 		return {
 			status_code: 200,
 			body: { success: true }
@@ -15197,11 +15376,21 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			status_code: 400,
 			body: { error: "terms must be an array of strings" }
 		};
+		if (req.body.project !== void 0 && (typeof req.body.project !== "string" || !req.body.project.trim())) return {
+			status_code: 400,
+			body: { error: "project must be a non-empty string" }
+		};
 		return {
 			status_code: 200,
 			body: await sdk.trigger({
 				function_id: "mem::enrich",
-				payload: req.body
+				payload: {
+					sessionId: req.body.sessionId,
+					files: req.body.files,
+					...req.body.terms !== void 0 && { terms: req.body.terms },
+					...req.body.toolName !== void 0 && { toolName: req.body.toolName },
+					...req.body.project !== void 0 && { project: req.body.project }
+				}
 			})
 		};
 	});
@@ -15220,11 +15409,23 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			status_code: 400,
 			body: { error: "content is required" }
 		};
+		if (req.body.project !== void 0 && (typeof req.body.project !== "string" || !req.body.project.trim())) return {
+			status_code: 400,
+			body: { error: "project must be a non-empty string" }
+		};
 		return {
 			status_code: 201,
 			body: await sdk.trigger({
 				function_id: "mem::remember",
-				payload: req.body
+				payload: {
+					content: req.body.content,
+					...req.body.type !== void 0 && { type: req.body.type },
+					...req.body.concepts !== void 0 && { concepts: req.body.concepts },
+					...req.body.files !== void 0 && { files: req.body.files },
+					...req.body.ttlDays !== void 0 && { ttlDays: req.body.ttlDays },
+					...req.body.sourceObservationIds !== void 0 && { sourceObservationIds: req.body.sourceObservationIds },
+					...req.body.project !== void 0 && { project: req.body.project }
+				}
 			})
 		};
 	});
@@ -15319,15 +15520,21 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction("api::migrate", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
-		if (!req.body?.dbPath || typeof req.body.dbPath !== "string") return {
+		const hasStep = typeof req.body?.step === "string" && req.body.step.trim().length > 0;
+		const hasDbPath = typeof req.body?.dbPath === "string" && req.body.dbPath.trim().length > 0;
+		if (!hasStep && !hasDbPath) return {
 			status_code: 400,
-			body: { error: "dbPath is required" }
+			body: { error: "Either step (string) or dbPath (string) is required" }
 		};
 		return {
 			status_code: 200,
 			body: await sdk.trigger({
 				function_id: "mem::migrate",
-				payload: req.body
+				payload: {
+					...req.body.step !== void 0 && { step: req.body.step },
+					...req.body.dbPath !== void 0 && { dbPath: req.body.dbPath },
+					...req.body.dryRun !== void 0 && { dryRun: req.body.dryRun }
+				}
 			})
 		};
 	});
@@ -15673,6 +15880,63 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			http_method: "POST"
 		}
 	});
+	sdk.registerFunction("api::graph-build", async (req) => {
+		const authErr = checkAuth(req, secret);
+		if (authErr) return authErr;
+		const batchSize = Math.max(1, Math.min(100, Number(req.body?.batchSize) || 25));
+		try {
+			const sessions = await kv.list(KV.sessions);
+			let totalNodes = 0;
+			let totalEdges = 0;
+			let batchesRun = 0;
+			for (const session of sessions) {
+				const sid = session?.id;
+				if (typeof sid !== "string" || sid.length === 0) continue;
+				const compressed = (await kv.list(KV.observations(sid))).filter((o) => o && typeof o.title === "string" && o.title.length > 0);
+				if (compressed.length === 0) continue;
+				for (let i = 0; i < compressed.length; i += batchSize) {
+					const batch = compressed.slice(i, i + batchSize);
+					try {
+						const result = await sdk.trigger({
+							function_id: "mem::graph-extract",
+							payload: { observations: batch }
+						});
+						if (result?.success) {
+							totalNodes += Number(result.nodesAdded) || 0;
+							totalEdges += Number(result.edgesAdded) || 0;
+						}
+						batchesRun++;
+					} catch (err) {
+						logger.warn("graph-build batch failed", {
+							sessionId: sid,
+							batchIndex: Math.floor(i / batchSize),
+							error: err instanceof Error ? err.message : String(err)
+						});
+					}
+				}
+			}
+			return {
+				status_code: 200,
+				body: {
+					success: true,
+					sessions: sessions.length,
+					batches: batchesRun,
+					nodes: totalNodes,
+					edges: totalEdges
+				}
+			};
+		} catch {
+			return graphDisabledResponse();
+		}
+	});
+	sdk.registerTrigger({
+		type: "http",
+		function_id: "api::graph-build",
+		config: {
+			api_path: "/agentmemory/graph/build",
+			http_method: "POST"
+		}
+	});
 	sdk.registerFunction("api::consolidate-pipeline", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
@@ -16130,6 +16394,7 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction("api::slot-list", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
+		if (!isSlotsEnabled()) return slotsDisabledResponse();
 		return {
 			status_code: 200,
 			body: await sdk.trigger({
@@ -16149,6 +16414,7 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction("api::slot-get", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
+		if (!isSlotsEnabled()) return slotsDisabledResponse();
 		const label = asNonEmptyString$1(req.query_params?.["label"]);
 		if (!label) return {
 			status_code: 400,
@@ -16179,6 +16445,7 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction("api::slot-create", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
+		if (!isSlotsEnabled()) return slotsDisabledResponse();
 		const body = req.body ?? {};
 		const label = asNonEmptyString$1(body["label"]);
 		if (!label) return {
@@ -16241,6 +16508,7 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction("api::slot-append", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
+		if (!isSlotsEnabled()) return slotsDisabledResponse();
 		const body = req.body ?? {};
 		const label = asNonEmptyString$1(body["label"]);
 		const text = typeof body["text"] === "string" ? body["text"] : null;
@@ -16280,6 +16548,7 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction("api::slot-replace", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
+		if (!isSlotsEnabled()) return slotsDisabledResponse();
 		const body = req.body ?? {};
 		const label = asNonEmptyString$1(body["label"]);
 		const content = body["content"];
@@ -16319,6 +16588,7 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction("api::slot-delete", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
+		if (!isSlotsEnabled()) return slotsDisabledResponse();
 		const label = asNonEmptyString$1(req.query_params?.["label"]);
 		if (!label) return {
 			status_code: 400,
@@ -16349,6 +16619,8 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction("api::slot-reflect", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
+		if (!isSlotsEnabled()) return slotsDisabledResponse();
+		if (!isReflectEnabled()) return reflectDisabledResponse();
 		const body = req.body ?? {};
 		const sessionId = asNonEmptyString$1(body["sessionId"]);
 		if (!sessionId) return {
@@ -18001,6 +18273,10 @@ const CORE_TOOLS = [
 				files: {
 					type: "string",
 					description: "Comma-separated relevant file paths"
+				},
+				project: {
+					type: "string",
+					description: "Stable canonical project identifier this memory belongs to (e.g. a slug, UUID, or registry key). Must match the value used when the session was started. Do not use filesystem paths or ad-hoc display names — those change across machines and will silently break project scoping."
 				}
 			},
 			required: ["content"]
@@ -19157,13 +19433,15 @@ function registerMcpEndpoints(sdk, kv, secret) {
 					const type = args.type || "fact";
 					const concepts = typeof args.concepts === "string" ? args.concepts.split(",").map((c) => c.trim()).filter(Boolean) : [];
 					const files = typeof args.files === "string" ? args.files.split(",").map((f) => f.trim()).filter(Boolean) : [];
+					const project = typeof args.project === "string" && args.project.trim().length > 0 ? args.project.trim() : void 0;
 					const result = await sdk.trigger({
 						function_id: "mem::remember",
 						payload: {
 							content: args.content,
 							type,
 							concepts,
-							files
+							files,
+							...project !== void 0 && { project }
 						}
 					});
 					return {
@@ -21010,7 +21288,7 @@ async function main() {
 			if (bm25Index.has(memory.id)) continue;
 			bm25Index.add({
 				id: memory.id,
-				sessionId: memory.sessionIds[0] ?? "memory",
+				sessionId: memory.sessionIds?.[0] ?? "memory",
 				timestamp: memory.createdAt,
 				type: "decision",
 				title: memory.title,
@@ -21030,7 +21308,7 @@ async function main() {
 		console.warn(`[agentmemory] Failed to backfill memories into BM25:`, err);
 	}
 	bootLog(`Ready. ${embeddingProvider ? "Triple-stream (BM25+Vector+Graph)" : "BM25+Graph"} search active.`);
-	bootLog(`REST API: 124 endpoints at http://localhost:${config.restPort}/agentmemory/*`);
+	bootLog(`REST API: 125 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);