@agentmemory/agentmemory 0.9.31 → 0.9.32

package/dist/{secret-store-D9GwO0xp.mjs → secret-store-iYXRcrO8.mjs}

@@ -66,53 +66,120 @@ function warnIfPremiumModel(env, envName, model) {
 	warnPremiumModelShown = true;
 	process.stderr.write(`[agentmemory] ${envName}=${model} is in the premium tier. Background compression on this model can cost $5+/day under active use. Cheaper alternatives with comparable quality for memory compression: deepseek/deepseek-v4-flash-0731, deepseek/deepseek-v4-pro, qwen/qwen3-coder. See README "Cost-aware model selection" for the full table. Set AGENTMEMORY_SUPPRESS_COST_WARNING=1 to silence.\n`);
 }
+const LLM_PROVIDER_NAMES = [
+	"anthropic",
+	"openai",
+	"gemini",
+	"openrouter",
+	"minimax"
+];
+const LLM_PROVIDER_KEYS = {
+	anthropic: ["ANTHROPIC_API_KEY"],
+	openai: ["OPENAI_API_KEY"],
+	gemini: ["GEMINI_API_KEY", "GOOGLE_API_KEY"],
+	openrouter: ["OPENROUTER_API_KEY"],
+	minimax: ["MINIMAX_API_KEY"]
+};
+const REMOTE_EMBEDDING_PROVIDER_KEYS = {
+	gemini: ["GEMINI_API_KEY"],
+	openai: ["OPENAI_API_KEY", "OPENAI_EMBEDDING_API_KEY"],
+	voyage: ["VOYAGE_API_KEY"],
+	cohere: ["COHERE_API_KEY"],
+	openrouter: ["OPENROUTER_API_KEY"]
+};
+function isLlmProviderName(value) {
+	return LLM_PROVIDER_NAMES.includes(value);
+}
+function selectedLlmProviderValue(env) {
+	return (env["AGENTMEMORY_LLM_PROVIDER"] || "").trim().toLowerCase();
+}
+function llmProviderHasKey(env, name) {
+	return LLM_PROVIDER_KEYS[name].some((k) => hasRealValue(env[k]));
+}
+function envFileLabel(path = ENV_FILE) {
+	const home = homedir();
+	return path.startsWith(`${home}/`) ? `~${path.slice(home.length)}` : path;
+}
+function llmOptInHint(env = getMergedEnv()) {
+	const selected = selectedLlmProviderValue(env);
+	if (selected) {
+		if (!isLlmProviderName(selected)) return `AGENTMEMORY_LLM_PROVIDER=${selected} is not a known provider. Use one of: ${LLM_PROVIDER_NAMES.join(", ")}.`;
+		if (!llmProviderHasKey(env, selected)) return `AGENTMEMORY_LLM_PROVIDER=${selected} is set, but ${LLM_PROVIDER_KEYS[selected].join(" or ")} is not. Add the key to ${envFileLabel()}.`;
+		return null;
+	}
+	if (env["AGENTMEMORY_ALLOW_AGENT_SDK"] === "true") return null;
+	const withKey = LLM_PROVIDER_NAMES.filter((name) => llmProviderHasKey(env, name));
+	if (withKey.length === 0) return null;
+	return `Found ${withKey.flatMap((name) => LLM_PROVIDER_KEYS[name].filter((k) => hasRealValue(env[k]))).join(", ")}, but agentmemory sends nothing to an LLM provider until you choose one for it. To turn on LLM summaries and compression, add AGENTMEMORY_LLM_PROVIDER=${withKey[0]} to ${envFileLabel()}.`;
+}
+function embeddingOptInHint(env = getMergedEnv()) {
+	const chosen = (env["EMBEDDING_PROVIDER"] || "").trim().toLowerCase();
+	if (chosen) {
+		const keys = REMOTE_EMBEDDING_PROVIDER_KEYS[chosen];
+		if (keys && !keys.some((k) => hasRealValue(env[k]))) return `EMBEDDING_PROVIDER=${chosen} is set, but ${keys.join(" or ")} is not. Add the key to ${envFileLabel()}, or set EMBEDDING_PROVIDER=local for on-device embeddings.`;
+		return null;
+	}
+	const withKey = Object.keys(REMOTE_EMBEDDING_PROVIDER_KEYS).filter((name) => REMOTE_EMBEDDING_PROVIDER_KEYS[name].some((k) => hasRealValue(env[k])));
+	if (withKey.length === 0) return null;
+	return `A ${withKey.join("/")} key is present, but cloud embeddings stay off until you choose them. Add EMBEDDING_PROVIDER=${withKey[0]} to ${envFileLabel()}, or EMBEDDING_PROVIDER=local for on-device embeddings.`;
+}
 function detectProvider(env) {
 	const maxTokens = parseInt(env["MAX_TOKENS"] || "4096", 10);
-	if (hasRealValue(env["OPENAI_API_KEY"]) && env["OPENAI_API_KEY_FOR_LLM"] !== "false") {
-		const model = env["OPENAI_MODEL"] || "gpt-5.6-luna";
-		warnIfPremiumModel(env, "OPENAI_MODEL", model);
-		return {
-			provider: "openai",
-			model,
-			maxTokens,
-			baseURL: env["OPENAI_BASE_URL"]
-		};
-	}
-	if (hasRealValue(env["MINIMAX_API_KEY"])) return {
-		provider: "minimax",
-		model: env["MINIMAX_MODEL"] || "MiniMax-M3",
+	const noop = {
+		provider: "noop",
+		model: "noop",
 		maxTokens
 	};
-	if (hasRealValue(env["ANTHROPIC_API_KEY"])) return {
-		provider: "anthropic",
-		model: env["ANTHROPIC_MODEL"] || "claude-sonnet-5",
-		maxTokens,
-		baseURL: env["ANTHROPIC_BASE_URL"]
-	};
-	if (hasRealValue(env["GEMINI_API_KEY"]) || hasRealValue(env["GOOGLE_API_KEY"])) {
-		if (!hasRealValue(env["GEMINI_API_KEY"]) && hasRealValue(env["GOOGLE_API_KEY"])) process.stderr.write("[agentmemory] GOOGLE_API_KEY detected — treating as GEMINI_API_KEY. Set GEMINI_API_KEY in ~/.agentmemory/.env to silence this warning.\n");
-		return {
-			provider: "gemini",
-			model: env["GEMINI_MODEL"] || "gemini-3.7-flash",
-			maxTokens
-		};
-	}
-	if (hasRealValue(env["OPENROUTER_API_KEY"])) {
-		const model = env["OPENROUTER_MODEL"] || "anthropic/claude-sonnet-5";
-		warnIfPremiumModel(env, "OPENROUTER_MODEL", model);
-		return {
-			provider: "openrouter",
-			model,
-			maxTokens
-		};
+	const selected = selectedLlmProviderValue(env);
+	if (selected) {
+		if (!isLlmProviderName(selected) || !llmProviderHasKey(env, selected)) {
+			writeProviderNoticeOnce(`[agentmemory] ${llmOptInHint(env)} Running zero-LLM.\n`);
+			return noop;
+		}
+		switch (selected) {
+			case "openai": {
+				const model = env["OPENAI_MODEL"] || "gpt-5.6-luna";
+				warnIfPremiumModel(env, "OPENAI_MODEL", model);
+				return {
+					provider: "openai",
+					model,
+					maxTokens,
+					baseURL: env["OPENAI_BASE_URL"]
+				};
+			}
+			case "minimax": return {
+				provider: "minimax",
+				model: env["MINIMAX_MODEL"] || "MiniMax-M3",
+				maxTokens
+			};
+			case "anthropic": return {
+				provider: "anthropic",
+				model: env["ANTHROPIC_MODEL"] || "claude-sonnet-5",
+				maxTokens,
+				baseURL: env["ANTHROPIC_BASE_URL"]
+			};
+			case "gemini":
+				if (!hasRealValue(env["GEMINI_API_KEY"])) process.stderr.write("[agentmemory] GOOGLE_API_KEY detected — treating as GEMINI_API_KEY. Set GEMINI_API_KEY in ~/.agentmemory/.env to silence this warning.\n");
+				return {
+					provider: "gemini",
+					model: env["GEMINI_MODEL"] || "gemini-3.7-flash",
+					maxTokens
+				};
+			case "openrouter": {
+				const model = env["OPENROUTER_MODEL"] || "anthropic/claude-sonnet-5";
+				warnIfPremiumModel(env, "OPENROUTER_MODEL", model);
+				return {
+					provider: "openrouter",
+					model,
+					maxTokens
+				};
+			}
+		}
 	}
 	if (!(env["AGENTMEMORY_ALLOW_AGENT_SDK"] === "true")) {
-		writeProviderNoticeOnce(pc.dim("[agentmemory] No LLM provider key set — running zero-LLM: no LLM compression or summaries; search uses BM25 plus any configured embedding provider. Set EMBEDDING_PROVIDER=local for on-device semantic embeddings if none is configured. 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
-		};
+		const hint = llmOptInHint(env);
+		writeProviderNoticeOnce(hint ? `[agentmemory] ${hint}\n` : pc.dim("[agentmemory] No LLM provider chosen, so agentmemory runs zero-LLM: no LLM compression or summaries, and no session content leaves this machine for an LLM. Search uses BM25 plus any embedding provider you set with EMBEDDING_PROVIDER (EMBEDDING_PROVIDER=local runs on-device). To turn on LLM summaries, set AGENTMEMORY_LLM_PROVIDER (anthropic, openai, gemini, openrouter or minimax) and that provider's key in ~/.agentmemory/.env.\n"));
+		return noop;
 	}
 	writeProviderNoticeOnce("[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 {
@@ -192,7 +259,9 @@ function getAuditMigrateMaxBytes() {
 	return safeParseInt(getMergedEnv()["AGENTMEMORY_AUDIT_MIGRATE_MAX_BYTES"], 32 * 1024 * 1024);
 }
 function detectLlmProviderKind(env = getMergedEnv()) {
-	if (hasRealValue(env["ANTHROPIC_API_KEY"]) || hasRealValue(env["GEMINI_API_KEY"]) || hasRealValue(env["GOOGLE_API_KEY"]) || hasRealValue(env["OPENROUTER_API_KEY"]) || hasRealValue(env["MINIMAX_API_KEY"]) || hasRealValue(env["OPENAI_API_KEY"]) && env["OPENAI_API_KEY_FOR_LLM"] !== "false" || env["AGENTMEMORY_ALLOW_AGENT_SDK"] === "true") return "llm";
+	const selected = selectedLlmProviderValue(env);
+	if (selected && isLlmProviderName(selected) && llmProviderHasKey(env, selected)) return "llm";
+	if (!selected && env["AGENTMEMORY_ALLOW_AGENT_SDK"] === "true") return "llm";
 	return "noop";
 }
 function describeLlmRoute(provider) {
@@ -218,15 +287,8 @@ function loadEmbeddingConfig() {
 	};
 }
 function detectEmbeddingProvider(env) {
-	const source = env ?? getMergedEnv();
-	const forced = source["EMBEDDING_PROVIDER"];
-	if (forced) return forced;
-	if (source["GEMINI_API_KEY"]) return "gemini";
-	if (source["OPENAI_API_KEY"] || source["OPENAI_EMBEDDING_API_KEY"]) return "openai";
-	if (source["VOYAGE_API_KEY"]) return "voyage";
-	if (source["COHERE_API_KEY"]) return "cohere";
-	if (source["OPENROUTER_API_KEY"]) return "openrouter";
-	return null;
+	const forced = ((env ?? getMergedEnv())["EMBEDDING_PROVIDER"] || "").trim();
+	return forced ? forced : null;
 }
 function loadClaudeBridgeConfig() {
 	const env = getMergedEnv();
@@ -458,10 +520,63 @@ function bootWarn(msg) {
 }
 //#endregion
 //#region src/version.ts
-const VERSION = "0.9.31";
+const VERSION = "0.9.32";
 const III_PINNED_VERSION = "0.25.0";
 //#endregion
 //#region src/mcp/tools-registry.ts
+const READ_ONLY_TOOLS = new Set([
+	"memory_recall",
+	"memory_file_history",
+	"memory_patterns",
+	"memory_sessions",
+	"memory_smart_search",
+	"memory_vision_search",
+	"memory_timeline",
+	"memory_export",
+	"memory_relations",
+	"memory_commit_lookup",
+	"memory_commits",
+	"memory_graph_query",
+	"memory_team_feed",
+	"memory_audit",
+	"memory_frontier",
+	"memory_next",
+	"memory_diagnose",
+	"memory_facet_query",
+	"memory_verify",
+	"memory_lesson_recall",
+	"memory_insight_list",
+	"memory_slot_list",
+	"memory_slot_get"
+]);
+const DESTRUCTIVE_TOOLS = new Set([
+	"memory_action_update",
+	"memory_compress_file",
+	"memory_claude_bridge_sync",
+	"memory_governance_delete",
+	"memory_heal",
+	"memory_lesson_delete",
+	"memory_obsidian_export",
+	"memory_slot_replace",
+	"memory_slot_delete"
+]);
+const IDEMPOTENT_WRITE_TOOLS = new Set([
+	"memory_governance_delete",
+	"memory_lesson_delete",
+	"memory_slot_replace",
+	"memory_slot_delete",
+	"memory_claude_bridge_sync"
+]);
+const OPEN_WORLD_TOOLS = new Set(["memory_mesh_sync"]);
+function toolAnnotations(name) {
+	const readOnly = READ_ONLY_TOOLS.has(name);
+	return {
+		readOnlyHint: readOnly,
+		destructiveHint: !readOnly && DESTRUCTIVE_TOOLS.has(name),
+		idempotentHint: readOnly || IDEMPOTENT_WRITE_TOOLS.has(name),
+		openWorldHint: OPEN_WORLD_TOOLS.has(name)
+	};
+}
 const CORE_TOOLS = [
 	{
 		name: "memory_recall",
@@ -1442,6 +1557,11 @@ const V070_TOOLS = [
 				tags: {
 					type: "string",
 					description: "Comma-separated tags"
+				},
+				sourceIds: {
+					type: "array",
+					items: { type: "string" },
+					description: "Ids of the session, memory, observation or crystal this lesson came from (max 50)"
 				}
 			},
 			required: ["content"]
@@ -1664,7 +1784,10 @@ function getAllTools() {
 		...V070_TOOLS,
 		...V073_TOOLS,
 		...V010_SLOTS_TOOLS
-	];
+	].map((tool) => ({
+		...tool,
+		annotations: toolAnnotations(tool.name)
+	}));
 }
 function getVisibleTools() {
 	if ((process.env["AGENTMEMORY_TOOLS"] || "all") === "core") return getAllTools().filter((t) => ESSENTIAL_TOOLS.has(t.name));
@@ -2080,12 +2203,20 @@ function matchesSearchLayer(obsId, sessionId, targetLayer = "all", layer) {
 }
 //#endregion
 //#region src/state/memory-utils.ts
+const MAX_DATE_MS = 864e13;
+function supersededAt(previous, now) {
+	const prior = previous ? Date.parse(previous) : NaN;
+	const current = Date.parse(now);
+	if (Number.isNaN(prior) || current > prior) return now;
+	return new Date(Math.min(prior + 1, MAX_DATE_MS)).toISOString();
+}
 function memoryToObservation(memory) {
 	return {
 		id: memory.id,
 		sessionId: memory.sessionIds?.[0] ?? "memory",
 		timestamp: memory.createdAt,
 		type: "decision",
+		memoryType: memory.type,
 		title: memory.title,
 		facts: [memory.content],
 		narrative: memory.content,
@@ -2109,6 +2240,13 @@ function lessonToObservation(l) {
 		importance: l.confidence
 	};
 }
+function observationEmbedText(record) {
+	return [
+		record.title,
+		...record.concepts || [],
+		record.narrative || ""
+	].filter((part) => part && part.trim()).join(" ").trim();
+}
 //#endregion
 //#region src/functions/recall-response.ts
 function estimateTokens(value) {
@@ -2137,6 +2275,7 @@ function formatResult(result, format) {
 		sessionId: result.sessionId,
 		title: observation.title,
 		type: observation.type,
+		...observation.memoryType !== void 0 && { memoryType: observation.memoryType },
 		score: result.score,
 		timestamp: observation.timestamp,
 		...result.layer !== void 0 && { layer: result.layer }
@@ -2157,6 +2296,7 @@ function clipResult(result, format, budget) {
 			sessionId: result.sessionId,
 			title: "",
 			type: observation.type,
+			...observation.memoryType !== void 0 && { memoryType: observation.memoryType },
 			score: result.score,
 			timestamp: observation.timestamp,
 			...layer,
@@ -2178,6 +2318,7 @@ function clipResult(result, format, budget) {
 			sessionId: result.sessionId,
 			title,
 			narrative,
+			...observation.memoryType !== void 0 && { memoryType: observation.memoryType },
 			score: result.score,
 			timestamp: observation.timestamp,
 			...layer,
@@ -2189,6 +2330,7 @@ function clipResult(result, format, budget) {
 				sessionId: observation.sessionId,
 				timestamp: observation.timestamp,
 				type: observation.type,
+				...observation.memoryType !== void 0 && { memoryType: observation.memoryType },
 				title,
 				facts: [],
 				narrative,
@@ -2444,6 +2586,6 @@ function bearerHeaders(baseUrl, env = process.env) {
 	return secret ? { Authorization: `Bearer ${secret}` } : {};
 }
 //#endregion
-export { getVectorBucketSize as $, engineFlushWaitMs as A, getConsolidationCooldownMs as B, III_PINNED_VERSION as C, logger as D, bootWarn as E, describeLlmRoute as F, getFollowupWindowSeconds as G, getConsolidationIntervalMs as H, detectEmbeddingProvider as I, getSessionSweepStaleHours as J, getIndexSaveIntervalMs as K, detectLlmProviderKind as L, redactCredentialUrls as M, runtimeConfigPath as N, setBootVerbose as O, MAX_IMPORT_OBS_PER_SESSION as P, getVectorBackfillMax as Q, getAgentId as R, getVisibleTools as S, bootLog as T, getEnvVar as U, getConsolidationDecayDays as V, getFinalizeIdleMs as W, getStateBackend as X, getStandalonePersistPath as Y, getStateSaveIntervalMs as Z, safeAudit as _, secretFilePath as a, isDropStaleIndexEnabled as at, ESSENTIAL_TOOLS as b, memoryToObservation as c, isSessionSweepEnabled as ct, isSearchResultLayer as d, loadConfig as dt, hydrateProcessEnvFromFile as et, matchesSearchLayer as f, loadEmbeddingConfig as ft, runAuditRetentionSweep as g, parseEnvContent as gt, recordAudit as h, loadTeamConfig as ht, resolveClientSecret as i, isContextInjectionEnabled as it, engineStateConfigPaths as j, captureDurableAfterMs as k, getSearchResultLayer as l, isVectorBackfillAllEnabled as lt, queryAudit as m, loadSnapshotConfig as mt, ensureServerSecret as n, isAutoCompressEnabled as nt, buildRecallResponse as o, isGraphCompactOnBootEnabled as ot, AUDIT_MIGRATION_STATE_KEY as p, loadFallbackConfig as pt, getRedisUrl as q, explicitSecret as r, isConsolidationEnabled as rt, lessonToObservation as s, isGraphExtractionEnabled as st, bearerHeaders as t, isAgentScopeIsolated as tt, isSearchLayer as u, loadClaudeBridgeConfig as ut, setAuditRecordedListener as v, VERSION as w, getAllTools as x, startAuditMigration as y, getAuditRetentionMonths as z };
+export { getStandalonePersistPath as $, setBootVerbose as A, detectLlmProviderKind as B, getAllTools as C, bootLog as D, VERSION as E, runtimeConfigPath as F, getConsolidationDecayDays as G, getAgentId as H, LLM_PROVIDER_KEYS as I, getFinalizeIdleMs as J, getConsolidationIntervalMs as K, MAX_IMPORT_OBS_PER_SESSION as L, engineFlushWaitMs as M, engineStateConfigPaths as N, bootWarn as O, redactCredentialUrls as P, getSessionSweepStaleHours as Q, describeLlmRoute as R, ESSENTIAL_TOOLS as S, III_PINNED_VERSION as T, getAuditRetentionMonths as U, embeddingOptInHint as V, getConsolidationCooldownMs as W, getIndexSaveIntervalMs as X, getFollowupWindowSeconds as Y, getRedisUrl as Z, recordAudit as _, loadEmbeddingConfig as _t, secretFilePath as a, isAgentScopeIsolated as at, setAuditRecordedListener as b, loadTeamConfig as bt, memoryToObservation as c, isContextInjectionEnabled as ct, getSearchResultLayer as d, isGraphExtractionEnabled as dt, getStateBackend as et, isSearchLayer as f, isSessionSweepEnabled as ft, queryAudit as g, loadConfig as gt, AUDIT_MIGRATION_STATE_KEY as h, loadClaudeBridgeConfig as ht, resolveClientSecret as i, hydrateProcessEnvFromFile as it, captureDurableAfterMs as j, logger as k, observationEmbedText as l, isDropStaleIndexEnabled as lt, matchesSearchLayer as m, llmOptInHint as mt, ensureServerSecret as n, getVectorBackfillMax as nt, buildRecallResponse as o, isAutoCompressEnabled as ot, isSearchResultLayer as p, isVectorBackfillAllEnabled as pt, getEnvVar as q, explicitSecret as r, getVectorBucketSize as rt, lessonToObservation as s, isConsolidationEnabled as st, bearerHeaders as t, getStateSaveIntervalMs as tt, supersededAt as u, isGraphCompactOnBootEnabled as ut, runAuditRetentionSweep as v, loadFallbackConfig as vt, getVisibleTools as w, startAuditMigration as x, parseEnvContent as xt, safeAudit as y, loadSnapshotConfig as yt, detectEmbeddingProvider as z };
 
-//# sourceMappingURL=secret-store-D9GwO0xp.mjs.map
+//# sourceMappingURL=secret-store-iYXRcrO8.mjs.map