@agentmemory/agentmemory 0.9.26 → 0.9.28

package/dist/index.mjs

@@ -4,6 +4,7 @@ import { TriggerAction, registerWorker } from "iii-sdk";
 import { constants, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
 import { basename, dirname, extname, join, resolve, sep } from "node:path";
 import { homedir } from "node:os";
+import pc from "picocolors";
 import { AsyncLocalStorage } from "node:async_hooks";
 import Anthropic from "@anthropic-ai/sdk";
 import { lstat, mkdir, open, readFile, readdir, stat, unlink, utimes, writeFile } from "node:fs/promises";
@@ -15,18 +16,6 @@ import { lookup } from "node:dns/promises";
 import { isIP } from "node:net";
 import { fileURLToPath } from "node:url";
 import { createServer } from "node:http";
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-//#endregion
 //#region src/config.ts
 function safeParseInt(value, fallback) {
 	if (!value) return fallback;
@@ -102,14 +91,14 @@ function detectProvider(env) {
 		};
 	}
 	if (!(env["AGENTMEMORY_ALLOW_AGENT_SDK"] === "true")) {
-		process.stderr.write("[agentmemory] No LLM provider key found (ANTHROPIC_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY, MINIMAX_API_KEY, OPENAI_API_KEY). LLM-backed compression and summarization are DISABLED — using no-op provider. This is the safe default: the agent-sdk fallback used to spawn Claude Agent SDK child sessions which inherit Claude Code's plugin hooks and cause infinite Stop-hook recursion (#149 follow-up). To opt in to the agent-sdk fallback anyway, set both AGENTMEMORY_AUTO_COMPRESS=true AND AGENTMEMORY_ALLOW_AGENT_SDK=true — but be aware it will burn your Claude Pro allocation and may still recurse if you use it from inside Claude Code itself.\n");
+		process.stderr.write(pc.dim("[agentmemory] No LLM provider key set — running zero-LLM (BM25 + on-device embeddings). Set ANTHROPIC_API_KEY (or GEMINI/OPENAI/OPENROUTER/MINIMAX) in ~/.agentmemory/.env for LLM compression and summaries. Agent-SDK fallback stays off by default to avoid a Stop-hook recursion loop; opt in with AGENTMEMORY_AUTO_COMPRESS=true + AGENTMEMORY_ALLOW_AGENT_SDK=true.\n"));
 		return {
 			provider: "noop",
 			model: "noop",
 			maxTokens
 		};
 	}
-	process.stderr.write("[agentmemory] WARNING: agent-sdk fallback enabled via AGENTMEMORY_ALLOW_AGENT_SDK=true. This spawns @anthropic-ai/claude-agent-sdk child sessions that can trigger the Stop-hook recursion loop (#149 follow-up). A SDK-child env marker is set to block re-entry, but prefer setting a real API key in ~/.agentmemory/.env instead.\n");
+	process.stderr.write("[agentmemory] WARNING: agent-sdk fallback enabled via AGENTMEMORY_ALLOW_AGENT_SDK=true. This spawns @anthropic-ai/claude-agent-sdk child sessions that can trigger the Stop-hook recursion loop. A SDK-child env marker is set to block re-entry, but prefer setting a real API key in ~/.agentmemory/.env instead.\n");
 	return {
 		provider: "agent-sdk",
 		model: "claude-sonnet-4-20250514",
@@ -119,10 +108,12 @@ function detectProvider(env) {
 function loadConfig() {
 	const env = getMergedEnv();
 	const provider = detectProvider(env);
+	const restPort = parseInt(env["III_REST_PORT"] || "3111", 10) || 3111;
+	const streamsPort = parseInt(env["III_STREAM_PORT"] || env["III_STREAMS_PORT"] || "", 10) || restPort + 1;
 	return {
-		engineUrl: env["III_ENGINE_URL"] || "ws://localhost:49134",
-		restPort: parseInt(env["III_REST_PORT"] || "3111", 10) || 3111,
-		streamsPort: parseInt(env["III_STREAMS_PORT"] || "3112", 10) || 3112,
+		engineUrl: env["III_ENGINE_URL"] || `ws://localhost:${parseInt(env["III_ENGINE_PORT"] || "", 10) || restPort + 46023}`,
+		restPort,
+		streamsPort,
 		provider,
 		tokenBudget: safeParseInt(env["TOKEN_BUDGET"], 2e3),
 		maxObservationsPerSession: safeParseInt(env["MAX_OBS_PER_SESSION"], 500),
@@ -267,7 +258,7 @@ function loadFallbackConfig() {
 	const allowAgentSdk = env["AGENTMEMORY_ALLOW_AGENT_SDK"] === "true";
 	return { providers: raw.split(",").map((p) => p.trim()).filter((p) => Boolean(p) && VALID_PROVIDERS.has(p)).filter((p) => {
 		if (p === "agent-sdk" && !allowAgentSdk) {
-			process.stderr.write("[agentmemory] Ignoring FALLBACK_PROVIDERS entry 'agent-sdk' (AGENTMEMORY_ALLOW_AGENT_SDK is not 'true'). The agent-sdk fallback can spawn Claude Agent SDK child sessions that trigger the Stop-hook recursion loop (#149 follow-up). Opt in explicitly with AGENTMEMORY_ALLOW_AGENT_SDK=true if this is intentional.\n");
+			process.stderr.write("[agentmemory] Ignoring FALLBACK_PROVIDERS entry 'agent-sdk' (AGENTMEMORY_ALLOW_AGENT_SDK is not 'true'). The agent-sdk fallback can spawn Claude Agent SDK child sessions that trigger the Stop-hook recursion loop. Opt in explicitly with AGENTMEMORY_ALLOW_AGENT_SDK=true if this is intentional.\n");
 			return false;
 		}
 		return true;
@@ -1326,6 +1317,10 @@ const KV = {
 	claudeBridge: "mem:claude-bridge",
 	graphNodes: "mem:graph:nodes",
 	graphEdges: "mem:graph:edges",
+	graphSnapshot: "mem:graph:snapshot",
+	graphNameIndex: "mem:graph:name-index",
+	graphEdgeKey: "mem:graph:edge-key",
+	graphNodeDegree: "mem:graph:node-degree",
 	semantic: "mem:semantic",
 	procedural: "mem:procedural",
 	teamShared: (teamId) => `mem:team:${teamId}:shared`,
@@ -3482,6 +3477,12 @@ function registerSearchFunction(sdk, kv) {
 		}
 		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 isolated = isAgentScopeIsolated();
+		const explicitAgentId = typeof data.agentId === "string" && data.agentId.trim().length > 0 ? data.agentId.trim() : void 0;
+		const wildcardAgent = explicitAgentId === "*";
+		const envAgentId = isolated ? getAgentId() : void 0;
+		const filterAgentId = wildcardAgent ? void 0 : explicitAgentId ?? envAgentId;
+		if (isolated && !wildcardAgent && !explicitAgentId && !envAgentId) throw new Error("mem::search: AGENTMEMORY_AGENT_SCOPE=isolated is set but no agent id is available (env AGENT_ID unset and no explicit agentId in the call). Refusing to read cross-agent rows. Pass agentId: \"*\" to opt in to a wildcard read.");
 		const format = typeof data.format === "string" ? data.format : "full";
 		if (![
 			"full",
@@ -3497,7 +3498,7 @@ function registerSearchFunction(sdk, kv) {
 			const count = await rebuildIndex(kv);
 			logger.info("Search index rebuilt", { entries: count });
 		}
-		const filtering = !!(projectFilter || cwdFilter);
+		const filtering = !!(projectFilter || cwdFilter || filterAgentId);
 		const fetchLimit = filtering ? Math.max(effectiveLimit * 10, 100) : effectiveLimit;
 		const results = idx.search(query, fetchLimit);
 		const sessionCache = /* @__PURE__ */ new Map();
@@ -3514,9 +3515,10 @@ function registerSearchFunction(sdk, kv) {
 			memoryProjectCache.set(obsId, proj);
 			return proj;
 		};
+		const earlyCap = filterAgentId ? fetchLimit : effectiveLimit;
 		const candidates = [];
 		for (const r of results) {
-			if (candidates.length >= effectiveLimit) break;
+			if (candidates.length >= earlyCap) break;
 			if (filtering) {
 				const s = await loadSession(r.sessionId);
 				if (s) {
@@ -3538,7 +3540,10 @@ function registerSearchFunction(sdk, kv) {
 		const enriched = [];
 		for (let i = 0; i < candidates.length; i++) {
 			const obs = obsResults[i];
-			if (obs) enriched.push({
+			if (!obs) continue;
+			if (filterAgentId !== void 0 && obs.agentId !== filterAgentId) continue;
+			if (enriched.length >= effectiveLimit) break;
+			enriched.push({
 				observation: obs,
 				score: candidates[i].score,
 				sessionId: candidates[i].sessionId
@@ -3623,6 +3628,74 @@ function registerSearchFunction(sdk, kv) {
 	});
 }
 //#endregion
+//#region src/utils/image-store.ts
+const IMAGES_DIR = join(homedir(), ".agentmemory", "images");
+const DEFAULT_MAX_BYTES = 500 * 1024 * 1024;
+function getMaxBytes() {
+	return Number(process.env.AGENTMEMORY_IMAGE_STORE_MAX_BYTES) || DEFAULT_MAX_BYTES;
+}
+function isManagedImagePath(filePath) {
+	const resolved = resolve(filePath);
+	const normalizedImagesDir = resolve(IMAGES_DIR);
+	return resolved.startsWith(normalizedImagesDir + sep) || resolved === normalizedImagesDir;
+}
+function contentHash(data) {
+	return createHash("sha256").update(data).digest("hex");
+}
+async function saveImageToDisk(base64Data) {
+	if (!base64Data) return {
+		filePath: "",
+		bytesWritten: 0
+	};
+	if (!existsSync(IMAGES_DIR)) await mkdir(IMAGES_DIR, { recursive: true });
+	let cleanBase64 = base64Data;
+	let ext = "png";
+	if (base64Data.startsWith("data:image/")) {
+		const commaIdx = base64Data.indexOf(",");
+		if (commaIdx !== -1) {
+			const meta = base64Data.substring(0, commaIdx);
+			if (meta.includes("jpeg") || meta.includes("jpg")) ext = "jpg";
+			else if (meta.includes("webp")) ext = "webp";
+			else if (meta.includes("gif")) ext = "gif";
+			cleanBase64 = base64Data.substring(commaIdx + 1);
+		}
+	} else if (base64Data.startsWith("/9j/")) ext = "jpg";
+	const filePath = join(IMAGES_DIR, `${contentHash(cleanBase64)}.${ext}`);
+	if (existsSync(filePath)) return {
+		filePath,
+		bytesWritten: 0
+	};
+	await writeFile(filePath, Buffer.from(cleanBase64, "base64"));
+	return {
+		filePath,
+		bytesWritten: (await stat(filePath)).size
+	};
+}
+async function deleteImage(filePath) {
+	if (!filePath) return { deletedBytes: 0 };
+	if (!isManagedImagePath(filePath)) return { deletedBytes: 0 };
+	try {
+		if (existsSync(filePath)) {
+			const size = (await stat(filePath)).size;
+			await unlink(filePath);
+			return { deletedBytes: size };
+		}
+	} catch (err) {
+		console.error("[agentmemory] Failed to delete image context:", err);
+	}
+	return { deletedBytes: 0 };
+}
+/** Touch an image file to update its mtime (marking it as recently used for LRU eviction) */
+async function touchImage(filePath) {
+	if (!filePath || !isManagedImagePath(filePath)) return;
+	try {
+		if (existsSync(filePath)) {
+			const now = /* @__PURE__ */ new Date();
+			await utimes(filePath, now, now);
+		}
+	} catch (err) {}
+}
+//#endregion
 //#region src/functions/observe.ts
 function extractImage(d) {
 	if (!d) return void 0;
@@ -3700,10 +3773,9 @@ function registerObserveFunction(sdk, kv, dedupMap, maxObservationsPerSession) {
 			const inheritedAgentId = existingSession ? existingSession.agentId : getAgentId();
 			if (inheritedAgentId) raw.agentId = inheritedAgentId;
 			if (pendingImageData && (pendingImageData.startsWith("data:image/") || pendingImageData.startsWith("iVBORw0KGgo") || pendingImageData.startsWith("/9j/"))) {
-				const { saveImageToDisk } = await Promise.resolve().then(() => image_store_exports);
 				const { filePath, bytesWritten } = await saveImageToDisk(pendingImageData);
 				raw.imageData = filePath;
-				const { incrementImageRef } = await Promise.resolve().then(() => image_refs_exports);
+				const { incrementImageRef } = await import("./image-refs-BKLmp_sD.mjs");
 				await incrementImageRef(kv, filePath);
 				sdk.trigger({
 					function_id: "mem::disk-size-delta",
@@ -3723,13 +3795,13 @@ function registerObserveFunction(sdk, kv, dedupMap, maxObservationsPerSession) {
 			try {
 				await kv.set(KV.observations(payload.sessionId), obsId, raw);
 			} catch (error) {
-				if (raw.imageData) {
-					const { deleteImage } = await Promise.resolve().then(() => image_store_exports);
-					const { deletedBytes } = await deleteImage(raw.imageData);
-					if (deletedBytes > 0) sdk.trigger({
-						function_id: "mem::disk-size-delta",
-						payload: { deltaBytes: -deletedBytes },
-						action: TriggerAction.Void()
+				if (raw.imageData) try {
+					const { decrementImageRef } = await import("./image-refs-BKLmp_sD.mjs");
+					await decrementImageRef(kv, sdk, raw.imageData);
+				} catch (rollbackError) {
+					logger.error("Failed to roll back image ref after observation write failure", {
+						imageRef: raw.imageData,
+						error: rollbackError instanceof Error ? rollbackError.message : String(rollbackError)
 					});
 				}
 				throw error;
@@ -3851,115 +3923,6 @@ function registerObserveFunction(sdk, kv, dedupMap, maxObservationsPerSession) {
 	});
 }
 //#endregion
-//#region src/utils/image-store.ts
-var image_store_exports = /* @__PURE__ */ __exportAll({
-	IMAGES_DIR: () => IMAGES_DIR,
-	deleteImage: () => deleteImage,
-	getMaxBytes: () => getMaxBytes,
-	isManagedImagePath: () => isManagedImagePath,
-	saveImageToDisk: () => saveImageToDisk,
-	touchImage: () => touchImage
-});
-const IMAGES_DIR = join(homedir(), ".agentmemory", "images");
-const DEFAULT_MAX_BYTES = 500 * 1024 * 1024;
-function getMaxBytes() {
-	return Number(process.env.AGENTMEMORY_IMAGE_STORE_MAX_BYTES) || DEFAULT_MAX_BYTES;
-}
-function isManagedImagePath(filePath) {
-	const resolved = resolve(filePath);
-	const normalizedImagesDir = resolve(IMAGES_DIR);
-	return resolved.startsWith(normalizedImagesDir + sep) || resolved === normalizedImagesDir;
-}
-function contentHash(data) {
-	return createHash("sha256").update(data).digest("hex");
-}
-async function saveImageToDisk(base64Data) {
-	if (!base64Data) return {
-		filePath: "",
-		bytesWritten: 0
-	};
-	if (!existsSync(IMAGES_DIR)) await mkdir(IMAGES_DIR, { recursive: true });
-	let cleanBase64 = base64Data;
-	let ext = "png";
-	if (base64Data.startsWith("data:image/")) {
-		const commaIdx = base64Data.indexOf(",");
-		if (commaIdx !== -1) {
-			const meta = base64Data.substring(0, commaIdx);
-			if (meta.includes("jpeg") || meta.includes("jpg")) ext = "jpg";
-			else if (meta.includes("webp")) ext = "webp";
-			else if (meta.includes("gif")) ext = "gif";
-			cleanBase64 = base64Data.substring(commaIdx + 1);
-		}
-	} else if (base64Data.startsWith("/9j/")) ext = "jpg";
-	const filePath = join(IMAGES_DIR, `${contentHash(cleanBase64)}.${ext}`);
-	if (existsSync(filePath)) return {
-		filePath,
-		bytesWritten: 0
-	};
-	await writeFile(filePath, Buffer.from(cleanBase64, "base64"));
-	return {
-		filePath,
-		bytesWritten: (await stat(filePath)).size
-	};
-}
-async function deleteImage(filePath) {
-	if (!filePath) return { deletedBytes: 0 };
-	if (!isManagedImagePath(filePath)) return { deletedBytes: 0 };
-	try {
-		if (existsSync(filePath)) {
-			const size = (await stat(filePath)).size;
-			await unlink(filePath);
-			return { deletedBytes: size };
-		}
-	} catch (err) {
-		console.error("[agentmemory] Failed to delete image context:", err);
-	}
-	return { deletedBytes: 0 };
-}
-/** Touch an image file to update its mtime (marking it as recently used for LRU eviction) */
-async function touchImage(filePath) {
-	if (!filePath || !isManagedImagePath(filePath)) return;
-	try {
-		if (existsSync(filePath)) {
-			const now = /* @__PURE__ */ new Date();
-			await utimes(filePath, now, now);
-		}
-	} catch (err) {}
-}
-//#endregion
-//#region src/functions/image-refs.ts
-var image_refs_exports = /* @__PURE__ */ __exportAll({
-	decrementImageRef: () => decrementImageRef,
-	getImageRefCount: () => getImageRefCount,
-	incrementImageRef: () => incrementImageRef
-});
-async function getImageRefCount(kv, filePath) {
-	const count = await kv.get(KV.imageRefs, filePath);
-	return count ? Number(count) : 0;
-}
-async function incrementImageRef(kv, filePath) {
-	return withKeyedLock(`imgRef:${filePath}`, async () => {
-		const current = await getImageRefCount(kv, filePath);
-		await kv.set(KV.imageRefs, filePath, current + 1);
-		await touchImage(filePath);
-	});
-}
-async function decrementImageRef(kv, sdk, filePath) {
-	return withKeyedLock(`imgRef:${filePath}`, async () => {
-		const current = await getImageRefCount(kv, filePath);
-		if (current <= 1) {
-			await kv.delete(KV.imageEmbeddings, filePath);
-			await kv.delete(KV.imageRefs, filePath);
-			const { deletedBytes } = await deleteImage(filePath);
-			if (deletedBytes > 0) sdk.trigger({
-				function_id: "mem::disk-size-delta",
-				payload: { deltaBytes: -deletedBytes },
-				action: TriggerAction.Void()
-			});
-		} else await kv.set(KV.imageRefs, filePath, current - 1);
-	});
-}
-//#endregion
 //#region src/functions/image-quota-cleanup.ts
 const GRACE_PERIOD_MS = 3e4;
 function registerImageQuotaCleanup(sdk, kv) {
@@ -4007,6 +3970,7 @@ function registerImageQuotaCleanup(sdk, kv) {
 				await withKeyedLock(`imgRef:${f.filePath}`, async () => {
 					let refCount;
 					try {
+						const { getImageRefCount } = await import("./image-refs-BKLmp_sD.mjs");
 						refCount = await getImageRefCount(kv, f.filePath);
 					} catch (err) {
 						logger.error("Failed to read refCount; skipping eviction", {
@@ -5097,6 +5061,12 @@ function registerContextFunction(sdk, kv, tokenBudget) {
 	sdk.registerFunction("mem::context", async (data) => {
 		const budget = data.budget || tokenBudget;
 		const blocks = [];
+		const isolated = isAgentScopeIsolated();
+		const explicitAgentId = typeof data.agentId === "string" && data.agentId.trim().length > 0 ? data.agentId.trim() : void 0;
+		const wildcardAgent = explicitAgentId === "*";
+		const envAgentId = isolated ? getAgentId() : void 0;
+		const filterAgentId = wildcardAgent ? void 0 : explicitAgentId ?? envAgentId;
+		if (isolated && !wildcardAgent && !explicitAgentId && !envAgentId) throw new Error("mem::context: AGENTMEMORY_AGENT_SCOPE=isolated is set but no agent id is available (env AGENT_ID unset and no explicit agentId in the call). Refusing to read cross-agent rows. Pass agentId: \"*\" to opt in to a wildcard read.");
 		const [pinnedSlots, profile, lessons] = await Promise.all([
 			isSlotsEnabled() ? listPinnedSlots(kv).catch(() => []) : Promise.resolve([]),
 			kv.get(KV.profiles, data.project).catch(() => null),
@@ -5143,7 +5113,7 @@ function registerContextFunction(sdk, kv, tokenBudget) {
 				sourceIds: relevantLessons.map((l) => l.id)
 			});
 		}
-		const sessions = (await kv.list(KV.sessions)).filter((s) => s.project === data.project && s.id !== data.sessionId).sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime()).slice(0, 10);
+		const sessions = (await kv.list(KV.sessions)).filter((s) => s.project === data.project && s.id !== data.sessionId && (filterAgentId === void 0 || s.agentId === filterAgentId)).sort((a, b) => new Date(b.startedAt).getTime() - new Date(a.startedAt).getTime()).slice(0, 10);
 		const summariesPerSession = await Promise.all(sessions.map((s) => kv.get(KV.summaries, s.id).catch(() => null)));
 		const sessionsNeedingObs = [];
 		for (let i = 0; i < sessions.length; i++) {
@@ -6133,7 +6103,7 @@ function registerRememberFunction(sdk, kv) {
 		const deletedMemoryIds = [];
 		const deletedObservationIds = [];
 		let deletedSession = false;
-		const { decrementImageRef } = await Promise.resolve().then(() => image_refs_exports);
+		const { decrementImageRef } = await import("./image-refs-BKLmp_sD.mjs");
 		if (data.memoryId) {
 			const mem = await kv.get(KV.memories, data.memoryId);
 			await kv.delete(KV.memories, data.memoryId);
@@ -6240,7 +6210,7 @@ async function runRecoveredSessionConsolidation(sdk) {
 function registerEvictFunction(sdk, kv) {
 	sdk.registerFunction("mem::evict", async (data) => {
 		const dryRun = data?.dryRun ?? false;
-		const { decrementImageRef } = await Promise.resolve().then(() => image_refs_exports);
+		const { decrementImageRef } = await import("./image-refs-BKLmp_sD.mjs");
 		const configOverride = await kv.get(KV.config, "eviction").catch(() => null);
 		const cfg = {
 			...DEFAULTS$1,
@@ -6688,7 +6658,7 @@ async function findByKeyword(kv, keyword, project) {
 }
 //#endregion
 //#region src/version.ts
-const VERSION = "0.9.26";
+const VERSION = "0.9.28";
 //#endregion
 //#region src/telemetry/setup.ts
 const OTEL_CONFIG = {
@@ -6763,7 +6733,10 @@ function registerSmartSearchFunction(sdk, kv, searchFn) {
 	sdk.registerFunction("mem::smart-search", async (data) => {
 		const isolated = isAgentScopeIsolated();
 		const explicitAgentId = typeof data.agentId === "string" && data.agentId.trim().length > 0 ? data.agentId.trim() : void 0;
-		const filterAgentId = explicitAgentId === "*" ? void 0 : explicitAgentId ?? (isolated ? getAgentId() : void 0);
+		const wildcardAgent = explicitAgentId === "*";
+		const envAgentId = isolated ? getAgentId() : void 0;
+		const filterAgentId = wildcardAgent ? void 0 : explicitAgentId ?? envAgentId;
+		if (isolated && !wildcardAgent && !explicitAgentId && !envAgentId) throw new Error("mem::smart-search: AGENTMEMORY_AGENT_SCOPE=isolated is set but no agent id is available (env AGENT_ID unset and no explicit agentId in the call). Refusing to read cross-agent rows. Pass agentId: \"*\" to opt in to a wildcard read.");
 		if (data.expandIds && data.expandIds.length > 0) {
 			const raw = data.expandIds.slice(0, 20);
 			const items = raw.map((entry) => {
@@ -7055,7 +7028,7 @@ function registerAutoForgetFunction(sdk, kv) {
 	sdk.registerFunction("mem::auto-forget", async (data) => {
 		const dryRun = data?.dryRun ?? false;
 		const now = Date.now();
-		const { decrementImageRef } = await Promise.resolve().then(() => image_refs_exports);
+		const { decrementImageRef } = await import("./image-refs-BKLmp_sD.mjs");
 		const result = {
 			ttlExpired: [],
 			contradictions: [],
@@ -7314,7 +7287,9 @@ function registerExportImportFunction(sdk, kv) {
 			"0.9.23",
 			"0.9.24",
 			"0.9.25",
-			"0.9.26"
+			"0.9.26",
+			"0.9.27",
+			"0.9.28"
 		]).has(importData.version)) return {
 			success: false,
 			error: `Unsupported export version: ${importData.version}`
@@ -7838,19 +7813,167 @@ function buildGraphExtractionPrompt(observations) {
 //#region src/functions/graph.ts
 const DEFAULT_GRAPH_QUERY_LIMIT = 500;
 const MAX_GRAPH_QUERY_LIMIT = 5e3;
-function resolvePagination(rawLimit, rawOffset) {
+const SNAPSHOT_TOP_NODES = DEFAULT_GRAPH_QUERY_LIMIT;
+const SNAPSHOT_KEY = "current";
+const LIVE_ENUMERATION_BUDGET_MS = 6e3;
+function withTimeout(p, ms, label) {
+	return new Promise((resolve, reject) => {
+		const t = setTimeout(() => reject(/* @__PURE__ */ new Error(`${label}: exceeded ${ms}ms budget`)), ms);
+		p.then((v) => {
+			clearTimeout(t);
+			resolve(v);
+		}, (err) => {
+			clearTimeout(t);
+			reject(err);
+		});
+	});
+}
+function emptySnapshot() {
 	return {
-		limit: Math.max(1, Math.min(typeof rawLimit === "number" && Number.isFinite(rawLimit) ? Math.floor(rawLimit) : DEFAULT_GRAPH_QUERY_LIMIT, MAX_GRAPH_QUERY_LIMIT)),
-		offset: Math.max(0, typeof rawOffset === "number" && Number.isFinite(rawOffset) ? Math.floor(rawOffset) : 0)
+		version: 1,
+		topNodes: [],
+		topEdges: [],
+		topDegrees: {},
+		stats: {
+			totalNodes: 0,
+			totalEdges: 0,
+			nodesByType: {},
+			edgesByType: {}
+		},
+		updatedAt: (/* @__PURE__ */ new Date(0)).toISOString(),
+		dirty: true
 	};
 }
-function rankByDegree(nodes, edges) {
+async function readSnapshot(kv) {
+	try {
+		const snap = await kv.get(KV.graphSnapshot, SNAPSHOT_KEY);
+		if (snap && typeof snap === "object" && snap.version === 1) return snap;
+		return null;
+	} catch (err) {
+		logger.warn("Graph snapshot read failed", { error: err instanceof Error ? err.message : String(err) });
+		return null;
+	}
+}
+function buildSnapshotFromArrays(nodes, edges) {
+	const liveNodes = nodes.filter((n) => !n.stale);
+	const liveEdges = edges.filter((e) => !e.stale);
 	const degree = /* @__PURE__ */ new Map();
-	for (const edge of edges) {
-		degree.set(edge.sourceNodeId, (degree.get(edge.sourceNodeId) ?? 0) + 1);
-		degree.set(edge.targetNodeId, (degree.get(edge.targetNodeId) ?? 0) + 1);
+	for (const e of liveEdges) {
+		degree.set(e.sourceNodeId, (degree.get(e.sourceNodeId) ?? 0) + 1);
+		degree.set(e.targetNodeId, (degree.get(e.targetNodeId) ?? 0) + 1);
+	}
+	const ranked = [...liveNodes].sort((a, b) => (degree.get(b.id) ?? 0) - (degree.get(a.id) ?? 0)).slice(0, SNAPSHOT_TOP_NODES);
+	const rankedIds = new Set(ranked.map((n) => n.id));
+	const topEdges = liveEdges.filter((e) => rankedIds.has(e.sourceNodeId) && rankedIds.has(e.targetNodeId));
+	const topDegrees = {};
+	for (const n of ranked) topDegrees[n.id] = degree.get(n.id) ?? 0;
+	const nodesByType = {};
+	for (const n of liveNodes) nodesByType[n.type] = (nodesByType[n.type] || 0) + 1;
+	const edgesByType = {};
+	for (const e of liveEdges) edgesByType[e.type] = (edgesByType[e.type] || 0) + 1;
+	return {
+		version: 1,
+		topNodes: ranked,
+		topEdges,
+		topDegrees,
+		stats: {
+			totalNodes: liveNodes.length,
+			totalEdges: liveEdges.length,
+			nodesByType,
+			edgesByType
+		},
+		updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		dirty: false
+	};
+}
+function paginateFromSnapshot(snap, filterType, limit, offset) {
+	const filteredNodes = filterType ? snap.topNodes.filter((n) => n.type === filterType) : snap.topNodes;
+	const total = filterType ? snap.stats.nodesByType[filterType] ?? 0 : snap.stats.totalNodes;
+	const pageNodes = filteredNodes.slice(offset, offset + limit);
+	const pageIds = new Set(pageNodes.map((n) => n.id));
+	return {
+		nodes: pageNodes,
+		edges: snap.topEdges.filter((e) => pageIds.has(e.sourceNodeId) && pageIds.has(e.targetNodeId)),
+		depth: 0,
+		totalNodes: total,
+		totalEdges: snap.stats.totalEdges,
+		truncated: total > pageNodes.length,
+		limit,
+		offset,
+		fromSnapshot: true
+	};
+}
+const REBUILD_SAFE_NODE_CEILING = 25e3;
+function nameIndexKey(type, name) {
+	return `${type}|${name}`;
+}
+function edgeIndexKey(sourceNodeId, targetNodeId, type) {
+	return `${sourceNodeId}|${targetNodeId}|${type}`;
+}
+async function applyDegreeDelta(kv, snap, nodeId, delta) {
+	const prev = await kv.get(KV.graphNodeDegree, nodeId) ?? 0;
+	const next = Math.max(0, prev + delta);
+	await kv.set(KV.graphNodeDegree, nodeId, next);
+	if (snap.topNodes.findIndex((n) => n.id === nodeId) !== -1) {
+		snap.topDegrees[nodeId] = next;
+		snap.topNodes.sort((a, b) => (snap.topDegrees[b.id] ?? 0) - (snap.topDegrees[a.id] ?? 0));
+		return next;
+	}
+	if (snap.topNodes.length < SNAPSHOT_TOP_NODES) {
+		const node = await kv.get(KV.graphNodes, nodeId);
+		if (node && !node.stale) {
+			snap.topNodes.push(node);
+			snap.topDegrees[node.id] = next;
+			snap.topNodes.sort((a, b) => (snap.topDegrees[b.id] ?? 0) - (snap.topDegrees[a.id] ?? 0));
+		}
+		return next;
+	}
+	const tailEntry = snap.topNodes[snap.topNodes.length - 1];
+	if (!tailEntry) return next;
+	if (next > (snap.topDegrees[tailEntry.id] ?? 0)) {
+		const node = await kv.get(KV.graphNodes, nodeId);
+		if (node && !node.stale) {
+			const evicted = snap.topNodes.pop();
+			if (evicted) delete snap.topDegrees[evicted.id];
+			snap.topNodes.push(node);
+			snap.topDegrees[node.id] = next;
+			snap.topNodes.sort((a, b) => (snap.topDegrees[b.id] ?? 0) - (snap.topDegrees[a.id] ?? 0));
+		}
+	}
+	return next;
+}
+function snapshotPushEdgeIfBothInTop(snap, edge) {
+	const topIds = new Set(snap.topNodes.map((n) => n.id));
+	if (topIds.has(edge.sourceNodeId) && topIds.has(edge.targetNodeId)) {
+		if (!snap.topEdges.find((e) => e.id === edge.id)) snap.topEdges.push(edge);
 	}
-	return [...nodes].sort((a, b) => (degree.get(b.id) ?? 0) - (degree.get(a.id) ?? 0));
+}
+function mergeNode(existing, incoming, obsIds, capturedAt) {
+	return {
+		...existing,
+		sourceObservationIds: [...new Set([
+			...existing.sourceObservationIds,
+			...incoming.sourceObservationIds,
+			...obsIds
+		])],
+		properties: {
+			...existing.properties,
+			...incoming.properties
+		},
+		updatedAt: capturedAt
+	};
+}
+function mergeEdge(existing, obsIds) {
+	return {
+		...existing,
+		sourceObservationIds: [...new Set([...existing.sourceObservationIds, ...obsIds])]
+	};
+}
+function resolvePagination(rawLimit, rawOffset) {
+	return {
+		limit: Math.max(1, Math.min(typeof rawLimit === "number" && Number.isFinite(rawLimit) ? Math.floor(rawLimit) : DEFAULT_GRAPH_QUERY_LIMIT, MAX_GRAPH_QUERY_LIMIT)),
+		offset: Math.max(0, typeof rawOffset === "number" && Number.isFinite(rawOffset) ? Math.floor(rawOffset) : 0)
+	};
 }
 function paginate(nodes, allEdges, depth, limit, offset) {
 	const totalNodes = nodes.length;
@@ -7947,45 +8070,76 @@ function registerGraphFunction(sdk, kv, provider) {
 			const response = await provider.compress(GRAPH_EXTRACTION_SYSTEM, prompt);
 			const obsIds = data.observations.map((o) => o.id);
 			const { nodes, edges } = parseGraphXml(response, obsIds);
-			const existingNodes = await kv.list(KV.graphNodes);
-			const existingEdges = await kv.list(KV.graphEdges);
+			const snap = await readSnapshot(kv) ?? emptySnapshot();
+			const capturedAt = (/* @__PURE__ */ new Date()).toISOString();
+			let newNodeCount = 0;
+			let newEdgeCount = 0;
+			const newEdgesForTopCheck = [];
 			for (const node of nodes) {
-				const existing = existingNodes.find((n) => n.name === node.name && n.type === node.type);
+				const indexKey = nameIndexKey(node.type, node.name);
+				const existingId = await kv.get(KV.graphNameIndex, indexKey);
+				let existing = null;
+				if (existingId) {
+					existing = await kv.get(KV.graphNodes, existingId);
+					if (existing && snap.resetAt && typeof existing.createdAt === "string" && existing.createdAt < snap.resetAt) existing = null;
+				}
 				if (existing) {
-					const merged = {
-						...existing,
-						sourceObservationIds: [...new Set([...existing.sourceObservationIds, ...obsIds])],
-						properties: {
-							...existing.properties,
-							...node.properties
-						}
-					};
+					const merged = mergeNode(existing, node, obsIds, capturedAt);
 					await kv.set(KV.graphNodes, existing.id, merged);
-					const idx = existingNodes.findIndex((n) => n.id === existing.id);
-					if (idx !== -1) existingNodes[idx] = merged;
+					const topIdx = snap.topNodes.findIndex((n) => n.id === existing.id);
+					if (topIdx !== -1) snap.topNodes[topIdx] = merged;
 				} else {
 					await kv.set(KV.graphNodes, node.id, node);
-					existingNodes.push(node);
+					await kv.set(KV.graphNameIndex, indexKey, node.id);
+					await kv.set(KV.graphNodeDegree, node.id, 0);
+					snap.stats.totalNodes += 1;
+					snap.stats.nodesByType[node.type] = (snap.stats.nodesByType[node.type] ?? 0) + 1;
+					newNodeCount += 1;
+					if (snap.topNodes.length < SNAPSHOT_TOP_NODES) {
+						snap.topNodes.push(node);
+						snap.topDegrees[node.id] = 0;
+					}
 				}
 			}
 			for (const edge of edges) {
-				const edgeKey = `${edge.sourceNodeId}|${edge.targetNodeId}|${edge.type}`;
-				const existingEdge = existingEdges.find((e) => `${e.sourceNodeId}|${e.targetNodeId}|${e.type}` === edgeKey);
-				if (existingEdge) {
-					existingEdge.sourceObservationIds = [...new Set([...existingEdge.sourceObservationIds, ...obsIds])];
-					await kv.set(KV.graphEdges, existingEdge.id, existingEdge);
+				const eKey = edgeIndexKey(edge.sourceNodeId, edge.targetNodeId, edge.type);
+				const existingId = await kv.get(KV.graphEdgeKey, eKey);
+				let existing = null;
+				if (existingId) {
+					existing = await kv.get(KV.graphEdges, existingId);
+					if (existing && snap.resetAt && typeof existing.createdAt === "string" && existing.createdAt < snap.resetAt) existing = null;
+				}
+				if (existing) {
+					const merged = mergeEdge(existing, obsIds);
+					await kv.set(KV.graphEdges, existing.id, merged);
+					const topIdx = snap.topEdges.findIndex((e) => e.id === existing.id);
+					if (topIdx !== -1) snap.topEdges[topIdx] = merged;
 				} else {
 					await kv.set(KV.graphEdges, edge.id, edge);
-					existingEdges.push(edge);
+					await kv.set(KV.graphEdgeKey, eKey, edge.id);
+					snap.stats.totalEdges += 1;
+					snap.stats.edgesByType[edge.type] = (snap.stats.edgesByType[edge.type] ?? 0) + 1;
+					newEdgeCount += 1;
+					await applyDegreeDelta(kv, snap, edge.sourceNodeId, 1);
+					await applyDegreeDelta(kv, snap, edge.targetNodeId, 1);
+					newEdgesForTopCheck.push(edge);
 				}
 			}
+			for (const edge of newEdgesForTopCheck) snapshotPushEdgeIfBothInTop(snap, edge);
+			if (newNodeCount > 0 || newEdgeCount > 0) {
+				snap.updatedAt = capturedAt;
+				snap.dirty = false;
+				await kv.set(KV.graphSnapshot, SNAPSHOT_KEY, snap);
+			}
 			await recordAudit(kv, "observe", "mem::graph-extract", obsIds, {
 				nodesExtracted: nodes.length,
 				edgesExtracted: edges.length
 			});
 			logger.info("Graph extraction complete", {
 				nodes: nodes.length,
-				edges: edges.length
+				edges: edges.length,
+				newNodes: newNodeCount,
+				newEdges: newEdgeCount
 			});
 			return {
 				success: true,
@@ -8002,10 +8156,49 @@ function registerGraphFunction(sdk, kv, provider) {
 		}
 	});
 	sdk.registerFunction("mem::graph-query", async (data) => {
-		const allNodes = (await kv.list(KV.graphNodes)).filter((n) => !n.stale);
-		const allEdges = (await kv.list(KV.graphEdges)).filter((e) => !e.stale);
 		const maxDepth = Math.min(data.maxDepth || 3, 5);
 		const { limit, offset } = resolvePagination(data.limit, data.offset);
+		if (!data.query && !data.startNodeId) {
+			const snap = await readSnapshot(kv);
+			if (snap && snap.stats.totalNodes > 0) return paginateFromSnapshot(snap, data.nodeType, limit, offset);
+			return {
+				nodes: [],
+				edges: [],
+				depth: 0,
+				totalNodes: 0,
+				totalEdges: 0,
+				truncated: false,
+				limit,
+				offset,
+				warning: "No graph snapshot available. Either no graph has been extracted yet, or you are on a legacy corpus from a pre-#814 agentmemory build. Run POST /agentmemory/graph/snapshot-rebuild (safe up to ~25K nodes) or POST /agentmemory/graph/reset to wipe and let future extracts repopulate."
+			};
+		}
+		let allNodes;
+		let allEdges;
+		try {
+			const [rawNodes, rawEdges] = await withTimeout(Promise.all([kv.list(KV.graphNodes), kv.list(KV.graphEdges)]), LIVE_ENUMERATION_BUDGET_MS, "graph-query enumeration");
+			allNodes = rawNodes.filter((n) => !n.stale);
+			allEdges = rawEdges.filter((e) => !e.stale);
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			logger.warn("Graph query enumeration timed out, using snapshot", { error: msg });
+			const snap = await readSnapshot(kv);
+			if (snap) return {
+				...paginateFromSnapshot(snap, data.nodeType, limit, offset),
+				warning: "Live graph enumeration exceeded budget. Query / startNodeId paths degrade on >25K-node corpora until a per-node edge index lands. Result reflects top-degree snapshot, not the requested walk."
+			};
+			return {
+				nodes: [],
+				edges: [],
+				depth: 0,
+				totalNodes: 0,
+				totalEdges: 0,
+				truncated: false,
+				limit,
+				offset,
+				warning: "Graph enumeration exceeded budget and no snapshot is available."
+			};
+		}
 		if (data.query) {
 			const lower = data.query.toLowerCase();
 			return paginate(allNodes.filter((n) => n.name.toLowerCase().includes(lower) || Object.values(n.properties).some((v) => typeof v === "string" && v.toLowerCase().includes(lower))), allEdges, 0, limit, offset);
@@ -8042,22 +8235,116 @@ function registerGraphFunction(sdk, kv, provider) {
 			}
 			return paginate(resultNodes, resultEdges, maxDepth, limit, offset);
 		}
-		let filtered = allNodes;
-		if (data.nodeType) filtered = allNodes.filter((n) => n.type === data.nodeType);
-		return paginate(rankByDegree(filtered, allEdges), allEdges, 0, limit, offset);
+		return paginate([], [], 0, limit, offset);
 	});
 	sdk.registerFunction("mem::graph-stats", async () => {
-		const nodes = await kv.list(KV.graphNodes);
-		const edges = await kv.list(KV.graphEdges);
-		const nodesByType = {};
-		for (const n of nodes) nodesByType[n.type] = (nodesByType[n.type] || 0) + 1;
-		const edgesByType = {};
-		for (const e of edges) edgesByType[e.type] = (edgesByType[e.type] || 0) + 1;
+		const snap = await readSnapshot(kv);
+		if (snap) return {
+			...snap.stats,
+			fromSnapshot: true,
+			updatedAt: snap.updatedAt,
+			...snap.dirty ? { warning: "Snapshot is marked dirty (write was in-flight when read). Counts are eventually consistent." } : {}
+		};
 		return {
-			totalNodes: nodes.length,
-			totalEdges: edges.length,
-			nodesByType,
-			edgesByType
+			totalNodes: 0,
+			totalEdges: 0,
+			nodesByType: {},
+			edgesByType: {},
+			fromSnapshot: false,
+			warning: "No graph snapshot available. Run POST /agentmemory/graph/snapshot-rebuild (safe up to ~25K nodes) or POST /agentmemory/graph/reset to wipe and let future extracts repopulate."
+		};
+	});
+	sdk.registerFunction("mem::graph-snapshot-rebuild", async (data) => {
+		const started = Date.now();
+		const forceRebuild = data?.force === true;
+		try {
+			if (!await readSnapshot(kv) && !forceRebuild) {
+				logger.warn("Graph snapshot rebuild refused: no prior snapshot", { hint: "legacy corpus or empty store" });
+				return {
+					success: false,
+					legacyCorpus: true,
+					error: "No prior snapshot found. Rebuild would call kv.list on KV.graphNodes/Edges, which heartbeat-crashes the worker on corpora past the iii state response budget (~25K nodes). Either (a) call POST /agentmemory/graph/reset to drop into incremental-only mode and rebuild from new extracts, or (b) re-send with `force: true` if you're certain the corpus is small."
+				};
+			}
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			logger.warn("Graph snapshot pre-flight read failed", { error: msg });
+		}
+		try {
+			const [nodes, edges] = await withTimeout(Promise.all([kv.list(KV.graphNodes), kv.list(KV.graphEdges)]), LIVE_ENUMERATION_BUDGET_MS, "graph-snapshot-rebuild enumeration");
+			if (nodes.length > REBUILD_SAFE_NODE_CEILING) {
+				logger.warn("Graph snapshot rebuild aborted: corpus too large", {
+					totalNodes: nodes.length,
+					ceiling: REBUILD_SAFE_NODE_CEILING
+				});
+				return {
+					success: false,
+					tooLarge: true,
+					totalNodes: nodes.length,
+					ceiling: REBUILD_SAFE_NODE_CEILING,
+					error: `Corpus has ${nodes.length} graph nodes; safe-rebuild ceiling is ${REBUILD_SAFE_NODE_CEILING}. Run POST /agentmemory/graph/reset to wipe and let future extracts rebuild incrementally.`
+				};
+			}
+			const liveNodes = nodes.filter((n) => !n.stale);
+			const liveEdges = edges.filter((e) => !e.stale);
+			const degree = /* @__PURE__ */ new Map();
+			for (const e of liveEdges) {
+				degree.set(e.sourceNodeId, (degree.get(e.sourceNodeId) ?? 0) + 1);
+				degree.set(e.targetNodeId, (degree.get(e.targetNodeId) ?? 0) + 1);
+			}
+			const BATCH_SIZE = 100;
+			for (let i = 0; i < liveNodes.length; i += BATCH_SIZE) {
+				const batch = liveNodes.slice(i, i + BATCH_SIZE);
+				await Promise.all(batch.flatMap((n) => [kv.set(KV.graphNameIndex, nameIndexKey(n.type, n.name), n.id), kv.set(KV.graphNodeDegree, n.id, degree.get(n.id) ?? 0)]));
+			}
+			for (let i = 0; i < liveEdges.length; i += BATCH_SIZE) {
+				const batch = liveEdges.slice(i, i + BATCH_SIZE);
+				await Promise.all(batch.map((e) => kv.set(KV.graphEdgeKey, edgeIndexKey(e.sourceNodeId, e.targetNodeId, e.type), e.id)));
+			}
+			const snap = buildSnapshotFromArrays(nodes, edges);
+			await kv.set(KV.graphSnapshot, SNAPSHOT_KEY, snap);
+			const tookMs = Date.now() - started;
+			logger.info("Graph snapshot rebuilt", {
+				totalNodes: snap.stats.totalNodes,
+				totalEdges: snap.stats.totalEdges,
+				topNodes: snap.topNodes.length,
+				topEdges: snap.topEdges.length,
+				tookMs
+			});
+			return {
+				success: true,
+				...snap.stats,
+				topNodes: snap.topNodes.length,
+				topEdges: snap.topEdges.length,
+				updatedAt: snap.updatedAt,
+				tookMs
+			};
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			logger.error("Graph snapshot rebuild failed", { error: msg });
+			return {
+				success: false,
+				error: msg
+			};
+		}
+	});
+	sdk.registerFunction("mem::graph-reset", async () => {
+		const started = Date.now();
+		const resetSnapshot = {
+			...emptySnapshot(),
+			resetAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+		await kv.set(KV.graphSnapshot, SNAPSHOT_KEY, resetSnapshot);
+		const counts = { [KV.graphSnapshot]: 1 };
+		const tookMs = Date.now() - started;
+		logger.info("Graph state reset", {
+			counts,
+			tookMs
+		});
+		return {
+			success: true,
+			cleared: counts,
+			tookMs
 		};
 	});
 }
@@ -13880,7 +14167,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 Promise.resolve().then(() => image_refs_exports);
+		const { decrementImageRef } = await import("./image-refs-BKLmp_sD.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,
@@ -15348,11 +15635,15 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			status_code: 400,
 			body: { error: "budget must be a positive integer" }
 		};
+		const queryAgentId = typeof req.query_params?.["agentId"] === "string" ? req.query_params["agentId"] : void 0;
+		const bodyAgentId = typeof body.agentId === "string" && body.agentId.trim().length > 0 ? body.agentId.trim() : void 0;
 		const payload = {
 			sessionId,
 			project
 		};
 		if (budget !== void 0) payload.budget = budget;
+		const agentId = bodyAgentId ?? queryAgentId;
+		if (agentId !== void 0) payload.agentId = agentId;
 		return {
 			status_code: 200,
 			body: await sdk.trigger({
@@ -15372,6 +15663,7 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	});
 	sdk.registerFunction("api::search", async (req) => {
 		const body = req.body ?? {};
+		const queryAgentId = typeof req.query_params?.["agentId"] === "string" ? req.query_params["agentId"] : void 0;
 		if (typeof body.query !== "string" || !body.query.trim()) return {
 			status_code: 400,
 			body: { error: "query is required and must be a non-empty string" }
@@ -15400,13 +15692,15 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			status_code: 400,
 			body: { error: "token_budget must be a positive integer" }
 		};
+		const bodyAgentId = typeof body.agentId === "string" && body.agentId.trim().length > 0 ? body.agentId.trim() : void 0;
 		const payload = {
 			query: body.query.trim(),
 			limit: body.limit,
 			project: body.project,
 			cwd: body.cwd,
 			format: typeof body.format === "string" ? body.format.trim().toLowerCase() : void 0,
-			token_budget: body.token_budget
+			token_budget: body.token_budget,
+			agentId: bodyAgentId ?? queryAgentId
 		};
 		return {
 			status_code: 200,
@@ -15561,7 +15855,8 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 					function_id: "mem::context",
 					payload: {
 						sessionId,
-						project
+						project,
+						...agentId ? { agentId } : {}
 					}
 				})).context
 			}
@@ -15753,9 +16048,14 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 		const normalizedAgentId = typeof req.query_params?.["agentId"] === "string" ? req.query_params["agentId"].trim() : void 0;
 		const wildcardAgent = normalizedAgentId === "*";
 		const filterAgentId = wildcardAgent ? void 0 : (normalizedAgentId && !wildcardAgent ? normalizedAgentId : void 0) ?? (isAgentScopeIsolated() ? getAgentId() : void 0);
+		const filtered = filterAgentId ? sessions.filter((s) => s.agentId === filterAgentId) : sessions;
+		const summaries = await Promise.all(filtered.map((s) => kv.get(KV.summaries, s.id).catch(() => null)));
 		return {
 			status_code: 200,
-			body: { sessions: filterAgentId ? sessions.filter((s) => s.agentId === filterAgentId) : sessions }
+			body: { sessions: filtered.map((s, i) => summaries[i] ? {
+				...s,
+				summary: summaries[i]
+			} : s) }
 		};
 	});
 	sdk.registerTrigger({
@@ -16342,6 +16642,52 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			http_method: "GET"
 		}
 	});
+	sdk.registerFunction("api::graph-snapshot-rebuild", async (req) => {
+		const authErr = checkAuth(req, secret);
+		if (authErr) return authErr;
+		try {
+			return {
+				status_code: 200,
+				body: await sdk.trigger({
+					function_id: "mem::graph-snapshot-rebuild",
+					payload: {}
+				})
+			};
+		} catch {
+			return graphDisabledResponse();
+		}
+	});
+	sdk.registerTrigger({
+		type: "http",
+		function_id: "api::graph-snapshot-rebuild",
+		config: {
+			api_path: "/agentmemory/graph/snapshot-rebuild",
+			http_method: "POST"
+		}
+	});
+	sdk.registerFunction("api::graph-reset", async (req) => {
+		const authErr = checkAuth(req, secret);
+		if (authErr) return authErr;
+		try {
+			return {
+				status_code: 200,
+				body: await sdk.trigger({
+					function_id: "mem::graph-reset",
+					payload: {}
+				})
+			};
+		} catch {
+			return graphDisabledResponse();
+		}
+	});
+	sdk.registerTrigger({
+		type: "http",
+		function_id: "api::graph-reset",
+		config: {
+			api_path: "/agentmemory/graph/reset",
+			http_method: "POST"
+		}
+	});
 	sdk.registerFunction("api::graph-extract", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
@@ -18589,13 +18935,15 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 //#region src/triggers/events.ts
 function registerEventTriggers(sdk, kv) {
 	sdk.registerFunction("event::session::started", async (data) => {
+		const agentId = (typeof data.agentId === "string" && data.agentId.trim().length > 0 ? data.agentId.trim().slice(0, 128) : void 0) ?? getAgentId();
 		const session = {
 			id: data.sessionId,
 			project: data.project,
 			cwd: data.cwd,
 			startedAt: (/* @__PURE__ */ new Date()).toISOString(),
 			status: "active",
-			observationCount: 0
+			observationCount: 0,
+			...agentId ? { agentId } : {}
 		};
 		await kv.set(KV.sessions, data.sessionId, session);
 		return {
@@ -18604,7 +18952,8 @@ function registerEventTriggers(sdk, kv) {
 				function_id: "mem::context",
 				payload: {
 					sessionId: data.sessionId,
-					project: data.project
+					project: data.project,
+					...agentId ? { agentId } : {}
 				}
 			})).context
 		};
@@ -19885,13 +20234,15 @@ function registerMcpEndpoints(sdk, kv, secret) {
 						status_code: 400,
 						body: { error: "token_budget must be a positive integer" }
 					};
+					const recallAgentId = typeof args.agentId === "string" && args.agentId.trim().length > 0 ? args.agentId.trim() : void 0;
 					const result = await sdk.trigger({
 						function_id: "mem::search",
 						payload: {
 							query: args.query,
 							limit: typeof args.limit === "number" ? args.limit : 10,
 							format,
-							token_budget: tokenBudget
+							token_budget: tokenBudget,
+							agentId: recallAgentId
 						}
 					});
 					return {
@@ -21379,7 +21730,10 @@ function registerMcpEndpoints(sdk, kv, secret) {
 							limit: 10
 						}
 					}).catch(() => ({ results: [] }));
-					const relevant = (await kv.list(KV.memories)).filter((m) => m.isLatest).slice(0, 5);
+					const memories = await kv.list(KV.memories);
+					const isolated = isAgentScopeIsolated();
+					const activeAgentId = isolated ? getAgentId() : void 0;
+					const relevant = isolated && activeAgentId === void 0 ? [] : memories.filter((m) => m.isLatest).filter((m) => activeAgentId === void 0 || m.agentId === activeAgentId).slice(0, 5);
 					return {
 						status_code: 200,
 						body: { messages: [{
@@ -21633,10 +21987,10 @@ async function main() {
 	}
 	registerConsolidationPipelineFunction(sdk, kv, provider);
 	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).`);
+	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. Set AGENTMEMORY_AUTO_COMPRESS=false to disable.`);
+	else bootLog(`Auto-compress: OFF (default) — 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. Set AGENTMEMORY_INJECT_CONTEXT=false to disable.`);
+	else bootLog(`Context injection: OFF (default) — 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);
@@ -21743,14 +22097,14 @@ async function main() {
 			backfilled++;
 		}
 		if (backfilled > 0) {
-			bootLog(`Backfilled ${backfilled} memories into BM25 (legacy gap before #257)`);
+			bootLog(`Backfilled ${backfilled} memories into BM25 (legacy index gap)`);
 			indexPersistence.scheduleSave();
 		}
 	} catch (err) {
 		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: 126 endpoints at http://localhost:${config.restPort}/agentmemory/*`);
+	bootLog(`REST API: 128 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);
@@ -21825,6 +22179,6 @@ main().catch((err) => {
 	process.exit(1);
 });
 //#endregion
-export {};
+export { KV as i, touchImage as n, withKeyedLock as r, deleteImage as t };
 
 //# sourceMappingURL=index.mjs.map