@agentmemory/agentmemory 0.9.31 → 0.9.32

package/dist/{src-DaMtDzt_.mjs → src-C23nMpda.mjs}

@@ -1,6 +1,6 @@
-import { a as KV, c as jaccardSimilarity, i as withKeyedLocks, n as isKeyedLockHeld, o as fingerprintId, r as withKeyedLock, s as generateId, t as afterKeyedLock } from "./keyed-mutex-DCUh7PG-.mjs";
-import { $ as getVectorBucketSize, B as getConsolidationCooldownMs, C as III_PINNED_VERSION, D as logger, E as bootWarn, F as describeLlmRoute, G as getFollowupWindowSeconds, H as getConsolidationIntervalMs, I as detectEmbeddingProvider, J as getSessionSweepStaleHours, K as getIndexSaveIntervalMs, L as detectLlmProviderKind, N as runtimeConfigPath, P as MAX_IMPORT_OBS_PER_SESSION, Q as getVectorBackfillMax, R as getAgentId, S as getVisibleTools, T as bootLog, U as getEnvVar, V as getConsolidationDecayDays, W as getFinalizeIdleMs, X as getStateBackend, _ as safeAudit, a as secretFilePath, at as isDropStaleIndexEnabled, c as memoryToObservation, ct as isSessionSweepEnabled, dt as loadConfig, et as hydrateProcessEnvFromFile, f as matchesSearchLayer, ft as loadEmbeddingConfig, g as runAuditRetentionSweep, h as recordAudit, ht as loadTeamConfig, it as isContextInjectionEnabled, j as engineStateConfigPaths, k as captureDurableAfterMs, l as getSearchResultLayer, lt as isVectorBackfillAllEnabled, m as queryAudit, mt as loadSnapshotConfig, n as ensureServerSecret, nt as isAutoCompressEnabled, ot as isGraphCompactOnBootEnabled, p as AUDIT_MIGRATION_STATE_KEY, pt as loadFallbackConfig, r as explicitSecret, rt as isConsolidationEnabled, s as lessonToObservation, st as isGraphExtractionEnabled, tt as isAgentScopeIsolated, u as isSearchLayer, ut as loadClaudeBridgeConfig, v as setAuditRecordedListener, w as VERSION, x as getAllTools, y as startAuditMigration, z as getAuditRetentionMonths } from "./secret-store-D9GwO0xp.mjs";
-import { $ as normalizeAccessLog, A as getVectorBackfillState, At as withGraphSnapshotUnknownMutation, B as scheduleIndexSave, Bt as resolveGraphScope, C as findUnindexedObservations, Ct as initializeGraphIndex, D as getKeywordRebuildEpoch, Dt as recoverGraphIndex, E as getIndexPersistenceStatus, Et as reconcileGraphIndexRecord, F as isMemoryIndexReady, Ft as isLegacyGraphState, G as setVectorBackfillState, Gt as retainSent, H as setHybridRanker, Ht as drainSpool, I as markKeywordRebuildPending, It as notifyGraphGenerationChange, J as vectorIndexRemove, Jt as spoolSummary, K as setVectorIndex, Kt as spoolDir, L as rankMemoryIds, Lt as pinGraphState, M as indexRecords, Mt as noteGraphSnapshotWrite, N as isBm25RebuildIncomplete, Nt as withoutGraphRecovery, O as getPendingVectorBackfillCount, Ot as withGraphIndexMutation, P as isKeywordRebuildInProgress, Pt as getGraphGeneration, Q as emptyAccessLog, Qt as withWriteScrubbing, R as rebuildKeywordIndex, Rt as pinGraphStateGeneration, S as backfillVectorBacklog, St as graphEdgeLookupKey, T as getEmbeddingProvider, Tt as normalizeGraphIndexText, U as setIndexPersistence, V as setEmbeddingProvider, Vt as setGraphGenerationListener, W as setPendingVectorBackfillCount, Wt as reconcileSent, X as withoutObservationSource, Xt as scrubRecord, Y as rawFromObservationSource, Yt as registerPrivacyFunction, Z as deleteAccessLog, Zt as stripPrivateData, _ as getLiveEventsStats, a as markCompressionDispatchFailed, an as runtimeMetadataPath, at as markLlmFunctions, b as validateOutput, bt as finishGraphIndexBuild, c as isValidEventId, ct as singleFlight, d as budgetLiveObservationSource, dt as runGraphCompactOnBoot, en as SHUTDOWN_FLUSH_TIMEOUT_MS, et as recordAccessBatch, f as SAFE_PAYLOAD_BYTES, ft as setGraphCompactBootDisabled, g as emitLiveEvent, gt as registerGraphFunction, h as payloadByteLength, ht as persistGraphDelta, i as compressionRaw, in as settleWithin, it as evaluateStatus, j as getVectorIndex, jt as ensureGraphConsistency, k as getSearchIndex, kt as withGraphSnapshotIndexBarrier, l as buildSyntheticCompression, lt as GRAPH_COMPACT_BOOT_DELAY_MS, m as oversizedPayloadError, mt as boundSources, n as compressionInFlight, o as needsCompression, ot as prefersHtml, p as checkPayloadFrameSize, pt as COMPACT_SCOPES, q as vectorIndexAddGuarded, qt as spoolPolicy, r as registerCompressFunction, rn as runStartupCleanup, rt as UNINDEXED_SCAN_REUSE_MS, s as pendingCompression, st as renderStatusHtml, t as parseCompressionScope, tn as SHUTDOWN_HARD_EXIT_MS, tt as SearchIndex, u as budgetImportedObservationSources, ut as getGraphCompactBootStatus, v as liveEvents, vt as GraphIndexError, w as flushIndexSave, wt as mutateIndexedGraphRecord, x as SummaryOutputSchema, xt as getGraphIndexStatus, y as scoreSummary, yt as createGraphIndexReader, z as registerSearchFunction, zt as replaceGraphGeneration } from "./compression-recovery-CnhLQC6N.mjs";
+import { a as KV, c as jaccardSimilarity, i as withKeyedLocks, n as isKeyedLockHeld, o as fingerprintId, r as withKeyedLock, s as generateId, t as afterKeyedLock, u as segmentCjk } from "./keyed-mutex-DCUh7PG-.mjs";
+import { B as detectLlmProviderKind, C as getAllTools, D as bootLog, E as VERSION, F as runtimeConfigPath, G as getConsolidationDecayDays, H as getAgentId, J as getFinalizeIdleMs, K as getConsolidationIntervalMs, L as MAX_IMPORT_OBS_PER_SESSION, N as engineStateConfigPaths, O as bootWarn, Q as getSessionSweepStaleHours, R as describeLlmRoute, T as III_PINNED_VERSION, U as getAuditRetentionMonths, V as embeddingOptInHint, W as getConsolidationCooldownMs, X as getIndexSaveIntervalMs, Y as getFollowupWindowSeconds, _ as recordAudit, _t as loadEmbeddingConfig, a as secretFilePath, at as isAgentScopeIsolated, b as setAuditRecordedListener, bt as loadTeamConfig, c as memoryToObservation, ct as isContextInjectionEnabled, d as getSearchResultLayer, dt as isGraphExtractionEnabled, et as getStateBackend, f as isSearchLayer, ft as isSessionSweepEnabled, g as queryAudit, gt as loadConfig, h as AUDIT_MIGRATION_STATE_KEY, ht as loadClaudeBridgeConfig, it as hydrateProcessEnvFromFile, j as captureDurableAfterMs, k as logger, l as observationEmbedText, lt as isDropStaleIndexEnabled, m as matchesSearchLayer, mt as llmOptInHint, n as ensureServerSecret, nt as getVectorBackfillMax, ot as isAutoCompressEnabled, pt as isVectorBackfillAllEnabled, q as getEnvVar, r as explicitSecret, rt as getVectorBucketSize, s as lessonToObservation, st as isConsolidationEnabled, u as supersededAt, ut as isGraphCompactOnBootEnabled, v as runAuditRetentionSweep, vt as loadFallbackConfig, w as getVisibleTools, x as startAuditMigration, y as safeAudit, yt as loadSnapshotConfig, z as detectEmbeddingProvider } from "./secret-store-iYXRcrO8.mjs";
+import { $ as normalizeAccessLog, A as getVectorBackfillState, At as withGraphSnapshotUnknownMutation, B as scheduleIndexSave, Bt as resolveGraphScope, C as findUnindexedObservations, Ct as initializeGraphIndex, D as getKeywordRebuildEpoch, Dt as recoverGraphIndex, E as getIndexPersistenceStatus, Et as reconcileGraphIndexRecord, F as isMemoryIndexReady, Ft as isLegacyGraphState, G as setVectorBackfillState, Gt as retainSent, H as setHybridRanker, Ht as drainSpool, I as markKeywordRebuildPending, It as notifyGraphGenerationChange, J as vectorIndexRemove, Jt as spoolSummary, K as setVectorIndex, Kt as spoolDir, L as rankMemoryIds, Lt as pinGraphState, M as indexRecords, Mt as noteGraphSnapshotWrite, N as isBm25RebuildIncomplete, Nt as withoutGraphRecovery, O as getPendingVectorBackfillCount, Ot as withGraphIndexMutation, P as isKeywordRebuildInProgress, Pt as getGraphGeneration, Q as emptyAccessLog, Qt as withWriteScrubbing, R as rebuildKeywordIndex, Rt as pinGraphStateGeneration, S as backfillVectorBacklog, St as graphEdgeLookupKey, T as getEmbeddingProvider, Tt as normalizeGraphIndexText, U as setIndexPersistence, V as setEmbeddingProvider, Vt as setGraphGenerationListener, W as setPendingVectorBackfillCount, Wt as reconcileSent, X as withoutObservationSource, Xt as scrubRecord, Y as rawFromObservationSource, Yt as registerPrivacyFunction, Z as deleteAccessLog, Zt as stripPrivateData, _ as getLiveEventsStats, a as markCompressionDispatchFailed, an as runtimeMetadataPath, at as markLlmFunctions, b as validateOutput, bt as finishGraphIndexBuild, c as isValidEventId, ct as singleFlight, d as budgetLiveObservationSource, dt as runGraphCompactOnBoot, en as SHUTDOWN_FLUSH_TIMEOUT_MS, et as recordAccessBatch, f as SAFE_PAYLOAD_BYTES, ft as setGraphCompactBootDisabled, g as emitLiveEvent, gt as registerGraphFunction, h as payloadByteLength, ht as persistGraphDelta, i as compressionRaw, in as settleWithin, it as evaluateStatus, j as getVectorIndex, jt as ensureGraphConsistency, k as getSearchIndex, kt as withGraphSnapshotIndexBarrier, l as buildSyntheticCompression, lt as GRAPH_COMPACT_BOOT_DELAY_MS, m as oversizedPayloadError, mt as boundSources, n as compressionInFlight, o as needsCompression, ot as prefersHtml, p as checkPayloadFrameSize, pt as COMPACT_SCOPES, q as vectorIndexAddGuarded, qt as spoolPolicy, r as registerCompressFunction, rn as runStartupCleanup, rt as UNINDEXED_SCAN_REUSE_MS, s as pendingCompression, st as renderStatusHtml, t as parseCompressionScope, tn as SHUTDOWN_HARD_EXIT_MS, tt as SearchIndex, u as budgetImportedObservationSources, ut as getGraphCompactBootStatus, v as liveEvents, vt as GraphIndexError, w as flushIndexSave, wt as mutateIndexedGraphRecord, x as SummaryOutputSchema, xt as getGraphIndexStatus, y as scoreSummary, yt as createGraphIndexReader, z as registerSearchFunction, zt as replaceGraphGeneration } from "./compression-recovery-CZh63Jmz.mjs";
 import { a as saveImageToDisk, i as isManagedImagePath, n as deleteImage, r as getMaxBytes, t as IMAGES_DIR } from "./image-store-BsN4vyjr.mjs";
 import { a as pageAfterCursor, c as sortByKeyDesc, i as matchesText, n as parseSearchExpansionIds, o as pageByOffset, r as encodeCursor, s as parseListQuery, t as parseSessionArguments } from "./session-arguments-zxsbbd8y.mjs";
 import { execFile, execFileSync, execSync } from "node:child_process";
@@ -408,9 +408,11 @@ var OpenAIProvider = class {
 				throw new Error(`OpenAI API error (${response.status}): ${text}`);
 			}
 			const data = await response.json();
-			const message = data.choices?.[0]?.message;
+			const choice = data.choices?.[0];
+			const message = choice?.message;
 			const content = message?.content;
-			if (content) return content;
+			if (content?.trim()) return content;
+			if (choice?.finish_reason === "length") throw new Error(`OpenAI response hit max_tokens (${this.maxTokens}) before any content. Raise MAX_TOKENS or lower OPENAI_REASONING_EFFORT.`);
 			const reasoning = message?.reasoning ?? message?.reasoning_content;
 			if (reasoning) return reasoning;
 			throw new Error(`OpenAI returned unexpected response: ${JSON.stringify(data).slice(0, 200)}`);
@@ -1218,8 +1220,84 @@ var StateKV = class {
 		if (this.backend !== "redis" || !Array.isArray(values)) return values;
 		return orderLikeInsertion(values);
 	}
+	async listGroups() {
+		const groups = (await this.sdk.trigger({
+			function_id: "state::list_groups",
+			payload: {}
+		}))?.groups;
+		if (!Array.isArray(groups) || !groups.every((group) => typeof group === "string")) throw new Error("state::list_groups returned an unexpected shape");
+		return groups;
+	}
 };
 //#endregion
+//#region src/state/state-readiness.ts
+const STATE_READY_TIMEOUT_MS = 12e4;
+const STATE_READY_INTERVAL_MS = 100;
+const PROBE_TIMEOUT_MS = 1e4;
+const READINESS_PROBE_KEY = "__agentmemory_state_readiness__";
+function errorMessage$3(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+function isRetryableProbeError(error) {
+	const code = error?.code;
+	if (code === "function_not_found" || code === "invocation_timeout" || code === "timeout") return true;
+	return /Function state::(?:get|list) not found|timed out|timeout|ETIMEDOUT/i.test(errorMessage$3(error));
+}
+async function waitForStateReady(sdk, options = {}) {
+	const scope = options.scope ?? KV.config;
+	const timeoutMs = options.timeoutMs ?? STATE_READY_TIMEOUT_MS;
+	const intervalMs = options.intervalMs ?? STATE_READY_INTERVAL_MS;
+	const now = options.now ?? (() => performance.now());
+	const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+	const startedAt = now();
+	let attempts = 0;
+	let lastError;
+	const probeTimeoutMs = () => Math.min(PROBE_TIMEOUT_MS, Math.max(1, timeoutMs - (now() - startedAt)));
+	for (;;) {
+		attempts += 1;
+		try {
+			await sdk.trigger({
+				function_id: "state::list",
+				payload: { scope },
+				timeoutMs: probeTimeoutMs()
+			});
+			await sdk.trigger({
+				function_id: "state::get",
+				payload: {
+					scope,
+					key: READINESS_PROBE_KEY
+				},
+				timeoutMs: probeTimeoutMs()
+			});
+			return {
+				ready: true,
+				waitedMs: Math.round(now() - startedAt),
+				attempts
+			};
+		} catch (error) {
+			lastError = errorMessage$3(error);
+			if (!isRetryableProbeError(error)) return {
+				ready: false,
+				waitedMs: Math.round(now() - startedAt),
+				attempts,
+				error: lastError
+			};
+			if (attempts === 1) options.onWaiting?.(lastError);
+		}
+		const elapsed = now() - startedAt;
+		if (elapsed >= timeoutMs) return {
+			ready: false,
+			waitedMs: Math.round(elapsed),
+			attempts,
+			error: lastError
+		};
+		await sleep(Math.min(intervalMs, timeoutMs - elapsed));
+	}
+}
+function assertStateReady(readiness) {
+	if (!readiness.ready) throw new Error(`State worker did not become ready within ${readiness.waitedMs}ms: ${readiness.error ?? "timeout"}`);
+}
+//#endregion
 //#region src/state/vector-index.ts
 function float32ToBase64(arr) {
 	return Buffer.from(arr.buffer, arr.byteOffset, arr.byteLength).toString("base64");
@@ -1982,10 +2060,12 @@ function registerQueryExpansionFunction(sdk, provider) {
 		}
 	});
 }
+const CJK_RUN = /[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]+/gu;
 function extractEntitiesFromQuery(query) {
 	const entities = [];
 	const quoted = query.match(/"([^"]+)"/g);
 	if (quoted) for (const q of quoted) entities.push(q.replace(/"/g, ""));
+	for (const run of query.matchAll(CJK_RUN)) for (const seg of segmentCjk(run[0])) if (seg.trim().length >= 2) entities.push(seg.trim());
 	const capitalized = query.match(/\b[A-Z][a-zA-Z0-9_.-]+\b/g);
 	if (capitalized) {
 		const stopWords = new Set([
@@ -2128,8 +2208,8 @@ var HybridSearch = class {
 		this.rerankEnabled = rerankEnabled;
 		this.graphRetrieval = new GraphRetrieval(kv, (id) => this.bm25.layerOf(id), (id) => this.bm25.sessionOf(id));
 	}
-	async search(query, limit = 20, targetLayer = "all", authorizeGraph) {
-		return this.tripleStreamSearch(query, limit, targetLayer, this.graphRetrieval.createQuery(authorizeGraph));
+	async search(query, limit = 20, targetLayer = "all", authorizeGraph, request) {
+		return this.tripleStreamSearch(query, limit, targetLayer, this.graphRetrieval.createQuery(authorizeGraph), void 0, true, request);
 	}
 	async searchWithExpansion(query, limit, expansion, targetLayer = "all", authorizeGraph) {
 		const allQueries = [
@@ -2149,13 +2229,25 @@ var HybridSearch = class {
 		const combined = Array.from(merged.values()).sort((a, b) => b.combinedScore - a.combinedScore || (a.observation.id < b.observation.id ? -1 : a.observation.id > b.observation.id ? 1 : 0));
 		return this.rerankResults(query, combined, limit);
 	}
-	async tripleStreamSearch(query, limit, targetLayer, graphQuery, entityHints, applyReranking = true) {
+	async tripleStreamSearch(query, limit, targetLayer, graphQuery, entityHints, applyReranking = true, request) {
 		const retrievalLimit = this.rerankEnabled ? Math.max(limit, 20) : limit;
 		const bm25Results = this.bm25.search(query, retrievalLimit * 2, targetLayer);
 		let vectorResults = [];
 		let queryEmbedding = null;
 		if (this.vector && this.embeddingProvider && this.vector.size > 0) try {
-			queryEmbedding = await this.embeddingProvider.embed(query);
+			if (request) {
+				if (!request.embedding || request.embedding.query !== query) request.embedding = {
+					query,
+					value: this.embeddingProvider.embed(query)
+				};
+				const embedding = request.embedding;
+				try {
+					queryEmbedding = await embedding.value;
+				} catch (error) {
+					if (request.embedding === embedding) request.embedding = void 0;
+					throw error;
+				}
+			} else queryEmbedding = await this.embeddingProvider.embed(query);
 			vectorResults = this.vector.search(queryEmbedding, retrievalLimit * 2, targetLayer, (id) => this.bm25.layerOf(id));
 		} catch {}
 		const entities = entityHints && entityHints.length > 0 ? entityHints : extractEntitiesFromQuery(query);
@@ -2230,6 +2322,7 @@ var HybridSearch = class {
 			graphContext: s.graphContext,
 			combinedScore
 		}));
+		if (request) request.candidateCount = combined.length;
 		const retrievalDepth = Math.max(limit, 20);
 		const diversified = this.diversifyBySession(combined, retrievalDepth);
 		const enriched = await this.enrichResults(diversified, retrievalDepth);
@@ -2333,6 +2426,10 @@ const PENDING_LOG_SAVE_THRESHOLD = 500;
 const EARLY_SAVE_MIN_GAP_MS = 5e3;
 const BACKFILL_MARKER_KEY = "vectors:backfill";
 const MEMORY_ID_PREFIX = "mem_";
+const LEGACY_SHARD_SCOPE_PREFIXES = [`${KV.bm25Index}:bm25:`, `${KV.bm25Index}:vectors:`];
+const LEGACY_SHARD_KEY = "data";
+const LEGACY_SHARD_SUFFIX = /^((?:[0-9a-z]+-[0-9a-f]{32})|(?:idx_[0-9a-z]+_[0-9a-f]{12})):\d{5}$/;
+const ORPHAN_SWEEP_KEY = "legacy:sweep";
 function auditIndexPersistEnabled() {
 	const raw = process.env.AGENTMEMORY_AUDIT_INDEX_PERSIST;
 	if (!raw) return false;
@@ -2367,6 +2464,11 @@ function isValidShardDescriptor(shard) {
 	const candidate = shard;
 	return typeof candidate.scope === "string" && candidate.scope.length > 0 && typeof candidate.key === "string" && candidate.key.length > 0 && Number.isInteger(candidate.chars) && candidate.chars >= 0;
 }
+function legacyShardGeneration(scope) {
+	const prefix = LEGACY_SHARD_SCOPE_PREFIXES.find((candidate) => scope.startsWith(candidate));
+	if (!prefix) return void 0;
+	return LEGACY_SHARD_SUFFIX.exec(scope.slice(prefix.length))?.[1] ?? null;
+}
 function isPersistedVector(row) {
 	if (!row || typeof row !== "object") return false;
 	const candidate = row;
@@ -2737,7 +2839,7 @@ var IndexPersistence = class {
 	}
 	async load() {
 		if (!this.vector) {
-			await this.removeLegacyBm25Snapshot();
+			await this.finishLegacyCleanup();
 			return {
 				vector: null,
 				state: "none",
@@ -2765,7 +2867,7 @@ var IndexPersistence = class {
 			this.hasVectorCheckpoint = loaded.size > 0;
 			this.checkpointBackfillSince = meta.backfillSince;
 			await this.removeLegacyVectorSnapshotIfPresent();
-			await this.removeLegacyBm25Snapshot();
+			await this.finishLegacyCleanup();
 			const expectedCount = Number.isInteger(meta.count) ? meta.count : void 0;
 			this.vectorCountShortfall = expectedCount !== void 0 && loaded.size < expectedCount ? {
 				expected: expectedCount,
@@ -2951,7 +3053,7 @@ var IndexPersistence = class {
 			savedAt: null
 		};
 		if (!(manifest.value != null || typeof legacyKey.value === "string" && legacyKey.value.length > 0)) {
-			await this.removeLegacyBm25Snapshot();
+			await this.finishLegacyCleanup();
 			return {
 				vector: null,
 				state: "none",
@@ -2984,7 +3086,7 @@ var IndexPersistence = class {
 			};
 		}
 		await this.removeLegacyVectorSnapshot(manifest.value);
-		await this.removeLegacyBm25Snapshot();
+		await this.finishLegacyCleanup();
 		await this.auditIndexPersistence("migrate", [statePath(KV.bm25Index, VECTOR_META_KEY)], {
 			vectors: legacy.size,
 			buckets: this.bucketCountInUse()
@@ -3024,6 +3126,71 @@ var IndexPersistence = class {
 		if (manifest != null) await this.deleteKey(KV.bm25Index, LEGACY_BM25_MANIFEST_KEY, "legacy_bm25_cleanup");
 		if (legacy != null) await this.deleteKey(KV.bm25Index, LEGACY_BM25_KEY, "legacy_bm25_cleanup");
 	}
+	async finishLegacyCleanup() {
+		await this.removeLegacyBm25Snapshot();
+		await this.sweepOrphanedGenerations();
+	}
+	async sweepOrphanedGenerations() {
+		try {
+			if (await this.kv.get(KV.bm25Index, ORPHAN_SWEEP_KEY) != null) return;
+			const candidates = /* @__PURE__ */ new Map();
+			for (const scope of await this.kv.listGroups()) {
+				const generation = legacyShardGeneration(scope);
+				if (generation === void 0) continue;
+				if (generation === null) {
+					logger.warn("index persistence: orphan sweep skipped, unrecognized legacy shard scope", { scope });
+					return;
+				}
+				candidates.set(scope, generation);
+			}
+			const named = await this.namedLegacyGenerations();
+			if (!named) return;
+			const orphans = [...candidates].filter(([, generation]) => !named.has(generation));
+			const failures = await inBatches(orphans, WRITE_CONCURRENCY, async ([scope]) => {
+				if (!await this.deleteKey(scope, LEGACY_SHARD_KEY, "orphan_generation_sweep")) throw new Error(scope);
+			});
+			const summary = {
+				generations: new Set(orphans.map(([, generation]) => generation)).size,
+				shards: orphans.length,
+				failed: failures.length
+			};
+			if (failures.length > 0) {
+				logger.warn("index persistence: orphan sweep left shards behind; the next boot retries", summary);
+				return;
+			}
+			if (candidates.size > orphans.length) {
+				if (orphans.length > 0) logger.info("index persistence: swept orphaned legacy index generations", summary);
+				return;
+			}
+			await this.kv.set(KV.bm25Index, ORPHAN_SWEEP_KEY, {
+				v: 1,
+				at: new Date(this.now()).toISOString(),
+				...summary
+			});
+			await this.auditIndexPersistence("sweep", [statePath(KV.bm25Index, ORPHAN_SWEEP_KEY)], summary);
+			logger.info("index persistence: swept orphaned legacy index generations", summary);
+		} catch (err) {
+			logger.warn("index persistence: orphan sweep failed; the next boot retries", { message: errorMessage$2(err) });
+		}
+	}
+	async namedLegacyGenerations() {
+		const named = /* @__PURE__ */ new Set();
+		for (const [key, label] of [[LEGACY_BM25_MANIFEST_KEY, "bm25"], [LEGACY_VECTOR_MANIFEST_KEY, "vector"]]) {
+			const read = await this.readIndexValue(KV.bm25Index, key, label, "manifest");
+			if (!read.ok) return null;
+			const manifest = read.value;
+			if (manifest == null) continue;
+			const generations = typeof manifest === "object" && Array.isArray(manifest.shards) ? manifest.shards.filter((shard) => typeof shard?.scope === "string" && shard.scope.length > 0).map((shard) => legacyShardGeneration(shard.scope)) : [];
+			if (typeof manifest === "object" && typeof manifest.generation === "string") generations.push(manifest.generation);
+			const usable = generations.filter((generation) => !!generation);
+			for (const generation of usable) named.add(generation);
+			if (usable.length === 0) {
+				logger.warn("index persistence: orphan sweep skipped, a legacy manifest names no generation", { key });
+				return null;
+			}
+		}
+		return named;
+	}
 	logFailure(err) {
 		const now = this.now();
 		if (now - this.lastFailureLogAt < FAILURE_LOG_THROTTLE_MS) return;
@@ -3058,9 +3225,12 @@ var IndexPersistence = class {
 			result,
 			error
 		});
+		return error === void 0;
 	}
 	async deleteShards(shards, reason) {
-		await inBatches(shards, WRITE_CONCURRENCY, (shard) => this.deleteKey(shard.scope, shard.key, reason));
+		await inBatches(shards, WRITE_CONCURRENCY, async (shard) => {
+			await this.deleteKey(shard.scope, shard.key, reason);
+		});
 	}
 	async loadShardedData(legacyKey, manifestKey, label) {
 		const manifest = await this.readIndexValue(KV.bm25Index, manifestKey, label, "manifest");
@@ -3618,7 +3788,7 @@ async function restoreIndexEntries(obs) {
 		scheduleIndexSave();
 	}
 	const vectors = getVectorIndex();
-	if (vectors && !vectors.has(obs.id)) await vectorIndexAddGuarded(obs.id, obs.sessionId, obs.title + " " + (obs.narrative || ""), {
+	if (vectors && !vectors.has(obs.id)) await vectorIndexAddGuarded(obs.id, obs.sessionId, observationEmbedText(obs), {
 		kind: "synthetic",
 		logId: obs.id
 	});
@@ -3840,7 +4010,7 @@ function registerObserveFunction(sdk, kv, dedupMap, maxObservationsPerSession) {
 			}
 			getSearchIndex().add(synthetic);
 			scheduleIndexSave();
-			await vectorIndexAddGuarded(synthetic.id, synthetic.sessionId, synthetic.title + " " + (synthetic.narrative || ""), {
+			await vectorIndexAddGuarded(synthetic.id, synthetic.sessionId, observationEmbedText(synthetic), {
 				kind: "synthetic",
 				logId: synthetic.id
 			});
@@ -5650,7 +5820,7 @@ function registerSummarizeFunction(sdk, kv, provider, metricsStore) {
 			return {
 				success: false,
 				error: "no_provider",
-				reason: "No LLM provider key set; Summarize is a no-op. Set ANTHROPIC_API_KEY (or GEMINI/OPENROUTER/MINIMAX) in ~/.agentmemory/.env to enable."
+				reason: "No LLM provider chosen; Summarize is a no-op. Set AGENTMEMORY_LLM_PROVIDER and that provider's key in ~/.agentmemory/.env to enable."
 			};
 		}
 		const boundedProvider = {
@@ -6261,6 +6431,7 @@ function registerConsolidateFunction(sdk, kv, provider) {
 				const existingMatch = existingMemories.find((m) => m.title.toLowerCase() === parsed.title.toLowerCase() && (!scopedProject || !m.project || m.project === scopedProject));
 				if (existingMatch) {
 					existingMatch.isLatest = false;
+					existingMatch.updatedAt = supersededAt(existingMatch.updatedAt, now);
 					await kv.set(KV.memories, existingMatch.id, existingMatch);
 					await recordAudit(kv, "evolve", "mem::consolidate", [existingMatch.id], {
 						action: "mark_non_latest",
@@ -6459,25 +6630,52 @@ function registerPatternsFunction(sdk, kv) {
 }
 //#endregion
 //#region src/functions/facets.ts
-async function deleteFacetsForTargets(kv, targetIds) {
+async function targetLiveness(kv, id) {
+	let observation = false;
+	if (id.startsWith("obs_")) {
+		const sessionId = await lookupObservationSession(kv, id);
+		observation = !!sessionId && !!await kv.get(KV.observations(sessionId), id);
+	}
+	if (id.startsWith("lsn_") || id.startsWith("lesson_")) {
+		const lesson = await kv.get(KV.lessons, id);
+		if (lesson && !lesson.deleted) return {
+			observation,
+			record: true
+		};
+	}
+	const [mem, sem] = await Promise.all([kv.get(KV.memories, id), kv.get(KV.semantic, id)]);
+	return {
+		observation,
+		record: !!(mem || sem)
+	};
+}
+function facetTargetLive(facet, liveness) {
+	if (!liveness) return false;
+	if (facet.targetType === "observation") return liveness.observation;
+	return liveness.record || liveness.observation;
+}
+async function deleteFacetsForTargets(kv, targetIds, options) {
 	const ids = new Set(targetIds);
 	ids.delete("");
 	if (ids.size === 0) return;
+	const targetTypes = new Set(options?.targetTypes ?? ["memory"]);
 	try {
-		const live = /* @__PURE__ */ new Set();
+		const live = /* @__PURE__ */ new Map();
 		await Promise.all([...ids].map(async (id) => {
 			for (let attempt = 0; attempt < 2; attempt++) try {
-				const [mem, sem] = await Promise.all([kv.get(KV.memories, id), kv.get(KV.semantic, id)]);
-				if (mem || sem) live.add(id);
+				live.set(id, await targetLiveness(kv, id));
 				return;
 			} catch {
 				if (attempt === 1) {
-					live.add(id);
+					live.set(id, {
+						observation: true,
+						record: true
+					});
 					logger.warn("Facet cleanup skipped unverifiable target", { targetId: id });
 				}
 			}
 		}));
-		const matches = (await kv.list(KV.facets)).filter((f) => ids.has(f.targetId) && !live.has(f.targetId) && f.targetType === "memory");
+		const matches = (await kv.list(KV.facets)).filter((f) => ids.has(f.targetId) && targetTypes.has(f.targetType) && !facetTargetLive(f, live.get(f.targetId)));
 		await Promise.all(matches.map((f) => kv.delete(KV.facets, f.id)));
 	} catch (err) {
 		logger.warn("Facet cleanup failed", {
@@ -6753,6 +6951,7 @@ function registerRememberFunction(sdk, kv) {
 			if (data.ttlDays && typeof data.ttlDays === "number" && data.ttlDays > 0) memory.forgetAfter = new Date(Date.now() + data.ttlDays * 864e5).toISOString();
 			if (supersededMemory) {
 				supersededMemory.isLatest = false;
+				supersededMemory.updatedAt = supersededAt(supersededMemory.updatedAt, now);
 				await kv.set(KV.memories, supersededMemory.id, supersededMemory);
 				try {
 					getSearchIndex().remove(supersededMemory.id);
@@ -6775,7 +6974,11 @@ function registerRememberFunction(sdk, kv) {
 				nearMatch
 			};
 		});
-		await vectorIndexAddGuarded(memory.id, memory.sessionIds?.[0] ?? "memory", memory.title + " " + memory.content, {
+		await vectorIndexAddGuarded(memory.id, memory.sessionIds?.[0] ?? "memory", observationEmbedText({
+			title: memory.title,
+			narrative: memory.content,
+			concepts: memory.concepts
+		}), {
 			kind: "memory",
 			logId: memory.id
 		}, (embedding, isCurrent) => withKeyedLock("mem:remember", async () => {
@@ -6917,6 +7120,7 @@ function registerRememberFunction(sdk, kv) {
 				}
 			});
 		}
+		if (deletedObservationIds.length > 0) await deleteFacetsForTargets(kv, deletedObservationIds, { targetTypes: ["memory", "observation"] });
 		if (deleted > 0 || indexCleaned) await flushIndexSave();
 		if (deleted > 0 || failures.length > 0) await recordAudit(kv, "forget", "mem::forget", [...deletedMemoryIds, ...deletedObservationIds], {
 			sessionId: data.sessionId,
@@ -7357,6 +7561,7 @@ function registerRelationsFunction(sdk, kv) {
 				isLatest: true
 			};
 			existing.isLatest = false;
+			existing.updatedAt = supersededAt(existing.updatedAt, now);
 			await kv.set(KV.memories, existing.id, existing);
 			try {
 				getSearchIndex().remove(existing.id);
@@ -7377,7 +7582,11 @@ function registerRelationsFunction(sdk, kv) {
 					error: err instanceof Error ? err.message : String(err)
 				});
 			}
-			await vectorIndexAddGuarded(evolved.id, evolved.sessionIds?.[0] ?? "memory", evolved.title + " " + evolved.content, {
+			await vectorIndexAddGuarded(evolved.id, evolved.sessionIds?.[0] ?? "memory", observationEmbedText({
+				title: evolved.title,
+				narrative: evolved.content,
+				concepts: evolved.concepts
+			}), {
 				kind: "memory",
 				logId: evolved.id
 			});
@@ -7620,6 +7829,7 @@ function getFollowupStats() {
 	};
 }
 const LESSON_CONTENT_PREVIEW_CHARS = 240;
+const SCOPED_RETRY_CANDIDATES = 1e3;
 function registerSmartSearchFunction(sdk, kv, searchFn) {
 	sdk.registerFunction("mem::smart-search", async (data) => {
 		if (data.targetLayer !== void 0 && !isSearchLayer(data.targetLayer)) throw new Error("mem::smart-search: targetLayer must be one of 'all', 'memory', or 'observation'");
@@ -7696,16 +7906,32 @@ function registerSmartSearchFunction(sdk, kv, searchFn) {
 			return (await read(KV.sessions, sessionId))?.project === project;
 		};
 		const [hybridResults, lessons] = await Promise.all([searchFn(data.query, overFetchLimit, targetLayer, authorizeGraph), includeLessons ? recallLessons(sdk, data.query, lessonLimit, project) : Promise.resolve([])]);
-		const layerResults = hybridResults.filter((result) => matchesSearchLayer(result.observation.id, result.sessionId, targetLayer, result.layer ?? getSearchIndex().layerOf(result.observation.id)));
-		const projectResults = matchesProject ? await filterProjectResults(layerResults, (result) => matchesProject(result.observation.id, result.sessionId)) : layerResults;
-		const compact = (filterAgentId ? projectResults.filter((r) => r.observation.agentId === filterAgentId).slice(0, limit) : projectResults.slice(0, limit)).map((r) => ({
-			obsId: r.observation.id,
-			layer: r.layer ?? getSearchIndex().layerOf(r.observation.id) ?? getSearchResultLayer(r.observation.id, r.sessionId),
-			sessionId: r.sessionId,
-			title: r.observation.title,
-			type: r.observation.type,
-			score: r.combinedScore,
-			timestamp: r.observation.timestamp
+		const scopeResults = async (results) => {
+			const layerResults = results.filter((result) => matchesSearchLayer(result.observation.id, result.sessionId, targetLayer, result.layer ?? getSearchIndex().layerOf(result.observation.id)));
+			const projectResults = matchesProject ? await filterProjectResults(layerResults, (result) => matchesProject(result.observation.id, result.sessionId)) : layerResults;
+			return filterAgentId ? projectResults.filter((r) => r.observation.agentId === filterAgentId).slice(0, limit) : projectResults.slice(0, limit);
+		};
+		let filteredHybrid = await scopeResults(hybridResults);
+		if ((filterAgentId || project) && filteredHybrid.length < limit && getSearchIndex().size > overFetchLimit) try {
+			const deeper = await scopeResults(await searchFn(data.query, SCOPED_RETRY_CANDIDATES, targetLayer, authorizeGraph));
+			const seen = new Set(deeper.map((result) => result.observation.id));
+			filteredHybrid = [...deeper, ...filteredHybrid.filter((result) => !seen.has(result.observation.id))].slice(0, limit);
+		} catch (err) {
+			logger.warn("Smart search deeper scoped ranking failed; keeping first-pass results", { error: err instanceof Error ? err.message : String(err) });
+		}
+		const compact = await Promise.all(filteredHybrid.map(async (r) => {
+			const layer = r.layer ?? getSearchIndex().layerOf(r.observation.id) ?? getSearchResultLayer(r.observation.id, r.sessionId);
+			const memoryType = layer === "memory" ? (await kv.get(KV.memories, r.observation.id).catch(() => null))?.type ?? r.observation.memoryType : void 0;
+			return {
+				obsId: r.observation.id,
+				layer,
+				sessionId: r.sessionId,
+				title: r.observation.title,
+				type: r.observation.type,
+				...memoryType !== void 0 && { memoryType },
+				score: r.combinedScore,
+				timestamp: r.observation.timestamp
+			};
 		}));
 		recordAccessBatch(kv, compact.map((r) => r.obsId));
 		if (data.sessionId && typeof data.sessionId === "string" && data.source !== "viewer" && compact.length > 0) {
@@ -7906,6 +8132,7 @@ function registerRecentSearchesSweepFunction(sdk, kv) {
 const HOUR_MS = 3600 * 1e3;
 function isStaleActive(session, cutoff) {
 	if (!session || session.status !== "active") return false;
+	if (typeof session.id !== "string" || session.id.length === 0) return false;
 	const freshness = session.updatedAt ?? session.startedAt;
 	if (!freshness) return false;
 	const ts = new Date(freshness).getTime();
@@ -8201,6 +8428,7 @@ function registerAutoForgetFunction(sdk, kv) {
 				if (!dryRun) {
 					const older = new Date(memA.createdAt).getTime() < new Date(memB.createdAt).getTime() ? memA : memB;
 					older.isLatest = false;
+					older.updatedAt = supersededAt(older.updatedAt, (/* @__PURE__ */ new Date()).toISOString());
 					await kv.set(KV.memories, older.id, older);
 					await recordAudit(kv, "forget", "mem::auto-forget", [older.id], {
 						resource: "memory",
@@ -8723,6 +8951,7 @@ function registerLessonsFunctions(sdk, kv) {
 		lessonRecords.delete(lesson.id);
 		if (lessonIndex) lessonIndex.remove(lesson.id);
 		noteLessonMutation();
+		await deleteFacetsForTargets(kv, [lesson.id]);
 		try {
 			await recordAudit(kv, "lesson_delete", "mem::lesson-delete", [lesson.id]);
 		} catch {}
@@ -8768,11 +8997,14 @@ function registerLessonsFunctions(sdk, kv) {
 			}
 		}
 		await Promise.all(dirty.map((l) => kv.set(KV.lessons, l.id, l)));
+		const softDeletedIds = [];
 		for (const l of dirty) if (l.deleted) {
+			softDeletedIds.push(l.id);
 			lessonRecords.delete(l.id);
 			if (lessonIndex) lessonIndex.remove(l.id);
 		} else lessonRecords.set(l.id, l);
 		if (dirty.length > 0) noteLessonMutation();
+		if (softDeletedIds.length > 0) await deleteFacetsForTargets(kv, softDeletedIds);
 		await Promise.all(auditEvents.map((event) => recordAudit(kv, "lesson_strengthen", "mem::lesson-decay-sweep", [event.id], {
 			action: event.action,
 			actor: "system",
@@ -9021,7 +9253,8 @@ function registerExportImportFunction(sdk, state) {
 			"0.9.28",
 			"0.9.29",
 			"0.9.30",
-			"0.9.31"
+			"0.9.31",
+			"0.9.32"
 		]).has(importData.version)) return {
 			success: false,
 			error: `Unsupported export version: ${importData.version}`
@@ -10399,7 +10632,7 @@ function registerConsolidationPipelineFunction(sdk, kv, provider) {
 		if (!data?.force && !isConsolidationEnabled()) return {
 			success: false,
 			skipped: 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, or AGENTMEMORY_ALLOW_AGENT_SDK=true). OPENAI_BASE_URL alone only points an OpenAI key at another server; it is not a provider."
+			reason: "Consolidation disabled: set CONSOLIDATION_ENABLED=true or choose an LLM provider (AGENTMEMORY_LLM_PROVIDER=anthropic, openai, gemini, openrouter or minimax with that provider's key, or AGENTMEMORY_ALLOW_AGENT_SDK=true). A provider key alone does not turn on LLM use."
 		};
 		const tier = data?.tier || "all";
 		const decayDays = getConsolidationDecayDays();
@@ -18382,7 +18615,9 @@ function createStatusReporter(sdk, kv, deps) {
 			llmRoute: describeLlmRoute(config.provider),
 			functionMetrics: functionMetrics ?? [],
 			provider: detectLlmProviderKind(),
+			providerHint: llmOptInHint(),
 			embeddingProvider: describeEmbeddingProvider(),
+			embeddingHint: embeddingOptInHint(),
 			flags: buildConfigFlags(),
 			index: {
 				bm25Documents: idx.size,
@@ -18527,13 +18762,18 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 	sdk.registerFunction("api::config-flags", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
+		const providerKind = detectLlmProviderKind();
+		const embeddingProvider = describeEmbeddingProvider();
+		const flags = buildConfigFlags();
 		return {
 			status_code: 200,
 			body: {
 				version: VERSION,
-				provider: detectLlmProviderKind(),
-				embeddingProvider: describeEmbeddingProvider(),
-				flags: buildConfigFlags()
+				provider: providerKind,
+				providerHint: llmOptInHint(),
+				embeddingProvider,
+				embeddingHint: embeddingOptInHint(),
+				flags
 			}
 		};
 	});
@@ -22384,6 +22624,45 @@ function registerApiTriggers(sdk, kv, secret, metricsStore, provider) {
 			http_method: "POST"
 		}
 	});
+	sdk.registerFunction("api::lesson-get", async (req) => {
+		const denied = checkAuth(req, secret);
+		if (denied) return denied;
+		const body = req.body;
+		const lessonId = typeof body?.lessonId === "string" ? body.lessonId.trim() : "";
+		if (!lessonId) return {
+			status_code: 400,
+			body: { error: "lessonId is required" }
+		};
+		if (body.project !== void 0 && typeof body.project !== "string") return {
+			status_code: 400,
+			body: { error: "project must be a string" }
+		};
+		const project = typeof body.project === "string" ? body.project.trim() : "";
+		const lesson = await kv.get(KV.lessons, lessonId);
+		if (!lesson || lesson.deleted) return {
+			status_code: 404,
+			body: { error: "lesson not found" }
+		};
+		if (lesson.project !== void 0 && lesson.project !== project) return {
+			status_code: 404,
+			body: { error: "lesson not found" }
+		};
+		return {
+			status_code: 200,
+			body: {
+				success: true,
+				lesson
+			}
+		};
+	});
+	sdk.registerTrigger({
+		type: "http",
+		function_id: "api::lesson-get",
+		config: {
+			api_path: "/agentmemory/lessons/get",
+			http_method: "POST"
+		}
+	});
 	sdk.registerFunction("api::lesson-strengthen", async (req) => {
 		const denied = checkAuth(req, secret);
 		if (denied) return denied;
@@ -23162,13 +23441,18 @@ function parseCsvList(value) {
 	if (Array.isArray(value)) return value.map((v) => typeof v === "string" ? v.trim() : "").filter(Boolean);
 	return [];
 }
+const SLOT_TOOL_NAMES = new Set(getAllTools().filter((t) => t.name.startsWith("memory_slot_")).map((t) => t.name));
+function isSlotTool(name) {
+	return SLOT_TOOL_NAMES.has(name);
+}
 function registerMcpEndpoints(sdk, kv, secret) {
+	const slotsEnabled = isSlotsEnabled();
 	sdk.registerFunction("mcp::tools::list", async (req) => {
 		const authErr = checkAuth(req, secret);
 		if (authErr) return authErr;
 		return {
 			status_code: 200,
-			body: { tools: getVisibleTools() }
+			body: { tools: getVisibleTools().filter((t) => slotsEnabled || !isSlotTool(t.name)) }
 		};
 	});
 	sdk.registerTrigger({
@@ -23187,6 +23471,7 @@ function registerMcpEndpoints(sdk, kv, secret) {
 			body: { error: "name is required" }
 		};
 		const { name, arguments: args = {} } = req.body;
+		if (isSlotTool(name) && !slotsEnabled) return slotsDisabledResponse();
 		try {
 			switch (name) {
 				case "memory_recall": {
@@ -24208,6 +24493,11 @@ function registerMcpEndpoints(sdk, kv, secret) {
 						body: { error: "content is required" }
 					};
 					const lessonTags = typeof args.tags === "string" && args.tags.trim() ? args.tags.split(",").map((t) => t.trim()).filter(Boolean) : [];
+					const lessonSourceIds = normalizeLessonSourceIds(args.sourceIds);
+					if (!lessonSourceIds) return {
+						status_code: 400,
+						body: { error: `sourceIds must be an array of at most 50 ids (session, memory, observation or crystal ids) without spaces` }
+					};
 					const lessonSaveResult = await sdk.trigger({
 						function_id: "mem::lesson-save",
 						payload: {
@@ -24216,7 +24506,8 @@ function registerMcpEndpoints(sdk, kv, secret) {
 							confidence: args.confidence,
 							project: args.project,
 							tags: lessonTags,
-							source: "manual"
+							source: "manual",
+							sourceIds: lessonSourceIds
 						}
 					});
 					return {
@@ -24638,24 +24929,16 @@ function registerMcpEndpoints(sdk, kv, secret) {
 				};
 			}
 			if (uri === "agentmemory://graph/stats") try {
-				const graphState = await pinGraphState(kv);
-				const nodes = await graphState.list(KV.graphNodes);
-				const edges = await graphState.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 stats = await sdk.trigger({
+					function_id: "mem::graph-stats",
+					payload: {}
+				});
 				return {
 					status_code: 200,
 					body: { contents: [{
 						uri,
 						mimeType: "application/json",
-						text: JSON.stringify({
-							totalNodes: nodes.length,
-							totalEdges: edges.length,
-							nodesByType,
-							edgesByType
-						})
+						text: JSON.stringify(stats)
 					}] }
 				};
 			} catch {
@@ -24665,8 +24948,15 @@ function registerMcpEndpoints(sdk, kv, secret) {
 						uri,
 						mimeType: "application/json",
 						text: JSON.stringify({
-							totalNodes: 0,
-							totalEdges: 0
+							totalNodes: null,
+							totalEdges: null,
+							nodesByType: {},
+							edgesByType: {},
+							fromSnapshot: false,
+							fromIndex: false,
+							available: false,
+							coverage: "unknown",
+							warning: "Graph stats are unavailable. Check agentmemory graph-index status."
 						})
 					}] }
 				};
@@ -24948,14 +25238,18 @@ async function main() {
 	const config = loadConfig();
 	const embeddingConfig = loadEmbeddingConfig();
 	const fallbackConfig = loadFallbackConfig();
-	const provider = fallbackConfig.providers.length > 0 ? createFallbackProvider(config.provider, fallbackConfig) : createProvider(config.provider);
+	const provider = fallbackConfig.providers.length > 0 && config.provider.provider !== "noop" ? createFallbackProvider(config.provider, fallbackConfig) : createProvider(config.provider);
 	const embeddingProvider = createEmbeddingProvider();
 	const imageEmbeddingProvider = createImageEmbeddingProvider();
 	bootLog(`Starting worker v${VERSION}...`);
 	bootLog(`Engine: ${config.engineUrl}`);
 	bootLog(`Provider: ${config.provider.provider} (${config.provider.model})`);
 	if (embeddingProvider) bootLog(`Embedding provider: ${embeddingProvider.name} (${embeddingProvider.dimensions} dims)`);
-	else bootLog(`Embedding provider: none (BM25-only mode)`);
+	else {
+		bootLog(`Embedding provider: none (BM25-only mode)`);
+		const embeddingHint = embeddingOptInHint();
+		if (embeddingHint) bootLog(embeddingHint);
+	}
 	if (imageEmbeddingProvider) bootLog(`Image embedding provider: ${imageEmbeddingProvider.name} (${imageEmbeddingProvider.dimensions} dims) — vision-search active`);
 	bootLog(`REST API: http://localhost:${config.restPort}/agentmemory/*`);
 	const sdk = withWriteScrubbing(registerWorker(config.engineUrl, {
@@ -24978,6 +25272,9 @@ async function main() {
 		stateBackend = getStateBackend();
 	} catch {}
 	const kv = new StateKV(sdk, { backend: stateBackend });
+	const stateReadiness = await waitForStateReady(sdk, { onWaiting: (error) => bootWarn(`Waiting for the state worker to register state::get and state::list (${error})`) });
+	assertStateReady(stateReadiness);
+	if (stateReadiness.attempts > 1) bootLog(`State worker ready after ${stateReadiness.waitedMs}ms (${stateReadiness.attempts} attempts)`);
 	const secret = resolveWorkerSecret();
 	const metricsStore = new MetricsStore(kv);
 	const dedupMap = new DedupMap();
@@ -25082,7 +25379,7 @@ async function main() {
 	const bm25Index = getSearchIndex();
 	const graphWeight = parseFloat(getEnvVar("AGENTMEMORY_GRAPH_WEIGHT") || "0.3");
 	const hybridSearch = new HybridSearch(bm25Index, vectorIndex, embeddingProvider, kv, embeddingConfig.bm25Weight, embeddingConfig.vectorWeight, graphWeight);
-	const hybridRanker = (query, limit, targetLayer, authorizeGraph) => hybridSearch.search(query, limit, targetLayer, authorizeGraph);
+	const hybridRanker = (query, limit, targetLayer, authorizeGraph, request) => hybridSearch.search(query, limit, targetLayer, authorizeGraph, request);
 	registerSmartSearchFunction(sdk, kv, hybridRanker);
 	setHybridRanker(hybridRanker);
 	registerRecentSearchesSweepFunction(sdk, kv);
@@ -25180,7 +25477,7 @@ async function main() {
 		console.warn(`[agentmemory] Failed to rebuild the BM25 index:`, err);
 	}
 	bootLog(`Ready. ${embeddingProvider ? "Triple-stream (BM25+Vector+Graph)" : "BM25+Graph"} search active.`);
-	bootLog(`REST API: 146 endpoints at http://localhost:${config.restPort}/agentmemory/*`);
+	bootLog(`REST API: 147 endpoints at http://localhost:${config.restPort}/agentmemory/*`);
 	bootLog(`MCP surface (opt-in via \`npx @agentmemory/mcp\`): ${getAllTools().length} tools · 6 resources · 3 prompts`);
 	(async () => {
 		try {
@@ -25340,4 +25637,4 @@ main().catch(async (err) => {
 //#endregion
 export {};
 
-//# sourceMappingURL=src-DaMtDzt_.mjs.map
+//# sourceMappingURL=src-C23nMpda.mjs.map