@windagency/valora-plugin-memory-vault 1.0.0

package/dist/consolidation-service.js

@@ -0,0 +1,373 @@
+/**
+ * Memory Consolidation Service.
+ *
+ * Orchestrates the full consolidation cycle for the agent memory system:
+ * 1. Prune decayed entries below the strength threshold
+ * 2. Run git-based invalidation to weaken memories referencing changed files
+ * 3. Detect similar episodic entries and merge them into semantic patterns
+ * 4. Auto-promote high-access verified entries to semantic store
+ *
+ * Designed to be called from the `valora consolidate` CLI command
+ * or as a post-feedback automatic maintenance step.
+ */
+import { generateMemoryId, SafeExecutor } from '@windagency/valora-runtime';
+import { centroidSummary, cosineClusters } from './consolidation/cluster.js';
+import { resolveEmbedder } from './embeddings/resolve-embedder.js';
+import { openVectorStore, readVectorStoreMeta } from './embeddings/vector-store.js';
+import { MemoryManager } from './manager.js';
+import { runAutoMigrationIfNeeded } from './migration/auto-migrate.js';
+import { getDefaultVaultDir, getLegacyJsonDir } from './vault/default-vault-dir.js';
+import { VaultStore } from './vault/vault-store.js';
+/** Compute Jaccard similarity between two tag sets. */
+function jaccardSimilarity(a, b) {
+	const setA = new Set(a);
+	const setB = new Set(b);
+	const intersection = [...setA].filter((t) => setB.has(t)).length;
+	const union = new Set([...a, ...b]).size;
+	return union === 0 ? 0 : intersection / union;
+}
+/** Parse `git log --name-only --format=COMMIT:%H %s --since=<date>` output. */
+function parseGitLogOutput(output) {
+	const commits = [];
+	let current = null;
+	for (const line of output.split('\n')) {
+		const trimmed = line.trim();
+		if (trimmed.startsWith('COMMIT:')) {
+			if (current !== null) {
+				commits.push(current);
+			}
+			// Format: "COMMIT:<hash> <message>"
+			const rest = trimmed.slice('COMMIT:'.length);
+			const spaceIndex = rest.indexOf(' ');
+			const hash = spaceIndex === -1 ? rest : rest.slice(0, spaceIndex);
+			const message = spaceIndex === -1 ? '' : rest.slice(spaceIndex + 1);
+			current = { changedFiles: [], hash, message };
+		} else if (trimmed.length > 0 && current !== null) {
+			current.changedFiles.push(trimmed);
+		}
+	}
+	if (current !== null) {
+		commits.push(current);
+	}
+	return commits;
+}
+const COSINE_CLUSTER_THRESHOLD = 0.82;
+export class MemoryConsolidationService {
+	context;
+	embedder;
+	manager;
+	store;
+	constructor(store, embedder, context = {}) {
+		this.store = store ?? buildDefaultVaultStore();
+		this.embedder = embedder;
+		this.context = context;
+		this.manager = new MemoryManager(this.store, undefined, embedder);
+	}
+	/**
+	 * Build a service with the embedder resolved from the host-provided
+	 * `providerLookup`. Used by the singleton helper and the CLI entry
+	 * points so cosine consolidation fires automatically when a provider
+	 * with `embed?()` is available.
+	 *
+	 * Without a provider lookup, the service is constructed embedder-less
+	 * and falls back to the Jaccard merge path.
+	 */
+	static async create(context = {}) {
+		let embedder;
+		try {
+			embedder = await resolveEmbedder(undefined, context.providerLookup);
+		} catch {
+			embedder = undefined;
+		}
+		return new MemoryConsolidationService(undefined, embedder, context);
+	}
+	async consolidate(options = {}) {
+		const startMs = Date.now();
+		const { dryRun = false, pruneOnly = false } = options;
+		let pruned = 0;
+		let gitInvalidated = 0;
+		let staleMarked = 0;
+		let merged = 0;
+		let promoted = 0;
+		// Step 1: Prune decayed entries
+		if (!dryRun) {
+			pruned = await this.manager.prune();
+		}
+		// Step 2: Git-based invalidation
+		const gitResult = await this.runGitInvalidation(options.since);
+		gitInvalidated = gitResult.invalidated;
+		staleMarked = gitResult.staleMarked;
+		// Step 3: Detect similar episodic entries and merge (skip if pruneOnly)
+		if (!pruneOnly) {
+			merged = await this.mergeEpisodicEntries(dryRun);
+		}
+		// Step 4: Auto-promote high-value episodic entries (skip if pruneOnly)
+		if (!pruneOnly) {
+			promoted = await this.autoPromoteEntries(dryRun);
+		}
+		// Step 5: Update consolidation timestamp
+		if (!dryRun) {
+			await this.store.setLastConsolidatedAt(new Date().toISOString());
+		}
+		await this.manager.flush();
+		const durationMs = Date.now() - startMs;
+		// Step 6: Emit event via the host-provided listener (no-op when absent).
+		const result = {
+			durationMs,
+			gitInvalidated,
+			merged,
+			promoted,
+			pruned,
+			staleMarked
+		};
+		this.context.onComplete?.(result);
+		return result;
+	}
+	async autoPromoteEntries(dryRun) {
+		const entries = await this.store.getEntries('episodic');
+		let promotedCount = 0;
+		for (const entry of entries) {
+			if (entry.accessCount >= 5 && entry.confidence === 'verified' && entry.supersededBy === undefined) {
+				if (!dryRun) {
+					await this.manager.promote(entry.id, entry.content, entry.tags);
+				}
+				promotedCount++;
+			}
+		}
+		return promotedCount;
+	}
+	buildCluster(entryI, group, startIdx, visited) {
+		const cluster = [entryI];
+		for (let j = startIdx + 1; j < group.length; j++) {
+			if (visited.has(j)) continue;
+			const entryJ = group[j];
+			if (entryJ === undefined) continue;
+			if (jaccardSimilarity(entryI.tags, entryJ.tags) >= 0.6) {
+				cluster.push(entryJ);
+				visited.add(j);
+			}
+		}
+		return cluster;
+	}
+	async mergeCluster(cluster, dryRun) {
+		const primaryEntry = cluster[0];
+		if (primaryEntry === undefined) return false;
+		const combinedContent = cluster.map((e) => e.content).join('\n\n');
+		const combinedTags = [...new Set(cluster.flatMap((e) => e.tags))];
+		const bestConfidence = cluster.reduce(
+			(best, e) => (confidenceRank(e.confidence) > confidenceRank(best) ? e.confidence : best),
+			primaryEntry.confidence
+		);
+		if (!dryRun) {
+			if (bestConfidence !== primaryEntry.confidence) {
+				await this.manager.update('episodic', primaryEntry.id, { confidence: bestConfidence });
+			}
+			const promoted = await this.manager.promote(primaryEntry.id, combinedContent, combinedTags);
+			// Persist `decays_from` edges for the rest of the cluster. A single
+			// appendEntryWithLinks call writes all edges at once — per-member
+			// calls would overwrite the file each iteration, losing all but the
+			// last edge (H14). The supersedes edge for the primary was already
+			// written by promote(); include it again here to survive the overwrite.
+			const vault = this.store instanceof VaultStore ? this.store : undefined;
+			if (vault !== undefined && cluster.length > 1) {
+				const allEdges = [
+					{ fromId: promoted.id, kind: 'supersedes', toId: primaryEntry.id },
+					...cluster.slice(1).map((m) => ({ fromId: promoted.id, kind: 'decays_from', toId: m.id }))
+				];
+				await vault.appendEntryWithLinks('semantic', promoted, allEdges);
+			}
+			for (const entry of cluster.slice(1)) {
+				await this.manager.delete('episodic', entry.id);
+			}
+		}
+		return true;
+	}
+	readSemanticHalfLifeOrDefault() {
+		return this.context.semanticHalfLifeDays ?? 30;
+	}
+	/** Groups episodic entries by their primary tag; entries with no tags are excluded. */
+	buildTagGroups(entries) {
+		const groups = new Map();
+		for (const entry of entries) {
+			if (entry.tags.length === 0) continue;
+			const primaryTag = entry.tags[0];
+			if (!groups.has(primaryTag)) groups.set(primaryTag, []);
+			groups.get(primaryTag).push(entry);
+		}
+		return groups;
+	}
+	async mergeClusterCosine(cluster, vaultStore) {
+		const now = new Date().toISOString();
+		const id = generateMemoryId();
+		const content = centroidSummary(cluster);
+		const tags = [...new Set(cluster.flatMap((e) => e.tags))];
+		const bestConfidence = cluster.reduce(
+			(best, e) => (confidenceRank(e.confidence) > confidenceRank(best) ? e.confidence : best),
+			cluster[0].confidence
+		);
+		// Half-life from injected config so cosine and Jaccard paths agree (H13).
+		// Falls back to the default constant when config has not been loaded
+		// (e.g. unit/integration tests that bypass the loader).
+		const semanticHalfLife = this.readSemanticHalfLifeOrDefault();
+		const newEntry = {
+			accessCount: 0,
+			agentRole: cluster[0].agentRole,
+			category: 'semantic',
+			confidence: bestConfidence,
+			content,
+			createdAt: now,
+			halfLifeDays: semanticHalfLife,
+			id,
+			isError: false,
+			lastAccessedAt: now,
+			relatedPaths: [...new Set(cluster.flatMap((e) => e.relatedPaths))],
+			sessionId: cluster[0].sessionId,
+			source: cluster[0].source,
+			tags,
+			updatedAt: now
+		};
+		const links = cluster.map((m) => ({ fromId: id, kind: 'decays_from', toId: m.id }));
+		await vaultStore.appendEntryWithLinks('semantic', newEntry, links);
+		// Mark all cluster members as stale
+		for (const member of cluster) {
+			await vaultStore.updateEntry('episodic', member.id, { confidence: 'stale', supersededBy: id });
+		}
+	}
+	async mergeCosine(dryRun) {
+		const vaultStore = this.store;
+		const vaultDir = vaultStore.getVaultDir();
+		// Cosine consolidation requires existing on-disk embeddings; align with
+		// the persisted model/dim so the strict mismatch guard does not throw.
+		const meta = readVectorStoreMeta(vaultDir);
+		if (meta === null) return 0;
+		const entries = await vaultStore.getEntries('episodic');
+		const vs = openVectorStore(vaultDir, meta.model, meta.dim);
+		const clusters = cosineClusters(entries, vs, COSINE_CLUSTER_THRESHOLD);
+		let mergedCount = 0;
+		for (const cluster of clusters) {
+			if (dryRun) {
+				mergedCount++;
+				continue;
+			}
+			await this.mergeClusterCosine(cluster, vaultStore);
+			mergedCount++;
+		}
+		return mergedCount;
+	}
+	async mergeEpisodicEntries(dryRun) {
+		if (this.embedder && this.store instanceof VaultStore) {
+			const cosineMerged = await this.mergeCosine(dryRun);
+			if (cosineMerged > 0) return cosineMerged;
+			// No embeddings on disk — fall back to Jaccard so consolidation still runs.
+		}
+		return this.mergeJaccard(dryRun);
+	}
+	async mergeJaccard(dryRun) {
+		const entries = await this.store.getEntries('episodic');
+		const groups = this.buildTagGroups(entries);
+		let mergedCount = 0;
+		for (const [, group] of groups) {
+			if (group.length < 2) continue;
+			const visited = new Set();
+			for (let i = 0; i < group.length; i++) {
+				if (visited.has(i)) continue;
+				const entryI = group[i];
+				if (entryI === undefined) continue;
+				visited.add(i);
+				const cluster = this.buildCluster(entryI, group, i, visited);
+				if (cluster.length < 2) continue;
+				if (await this.mergeCluster(cluster, dryRun)) {
+					mergedCount++;
+				}
+			}
+		}
+		return mergedCount;
+	}
+	async runGitInvalidation(sinceOverride) {
+		// Get last consolidated timestamp from episodic metadata
+		let sinceDate;
+		if (sinceOverride !== undefined) {
+			sinceDate = sinceOverride;
+		} else {
+			const metadata = await this.store.getMetadata('episodic');
+			if (metadata.lastConsolidatedAt !== undefined) {
+				sinceDate = metadata.lastConsolidatedAt;
+			} else {
+				// Default: 7 days ago
+				const sevenDaysAgo = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
+				sinceDate = sevenDaysAgo.toISOString();
+			}
+		}
+		let gitOutput = '';
+		try {
+			const result = await SafeExecutor.executeGit([
+				'log',
+				'--name-only',
+				`--format=COMMIT:%H %s`,
+				`--since=${sinceDate}`
+			]);
+			gitOutput = result.stdout;
+		} catch {
+			// Git not available or not in a git repo — skip invalidation gracefully
+			return { invalidated: 0, staleMarked: 0 };
+		}
+		const commits = parseGitLogOutput(gitOutput);
+		const allChangedFiles = new Set();
+		const staleFiles = new Set();
+		const revertPattern = /\b(revert|remove|delete|migrate\s+from)\b/i;
+		for (const commit of commits) {
+			for (const file of commit.changedFiles) {
+				allChangedFiles.add(file);
+			}
+			if (revertPattern.test(commit.message)) {
+				for (const file of commit.changedFiles) {
+					staleFiles.add(file);
+				}
+			}
+		}
+		let invalidated = 0;
+		let staleMarkedCount = 0;
+		if (allChangedFiles.size > 0) {
+			invalidated = await this.manager.invalidateByPaths([...allChangedFiles]);
+		}
+		if (staleFiles.size > 0) {
+			staleMarkedCount = await this.manager.markStaleByPaths([...staleFiles]);
+		}
+		return { invalidated, staleMarked: staleMarkedCount };
+	}
+}
+function buildDefaultVaultStore() {
+	const vaultDir = getDefaultVaultDir();
+	runAutoMigrationIfNeeded(getLegacyJsonDir(), vaultDir);
+	return new VaultStore(vaultDir);
+}
+const CONFIDENCE_RANK = {
+	inferred: 1,
+	observed: 2,
+	stale: 0,
+	verified: 3
+};
+function confidenceRank(confidence) {
+	return CONFIDENCE_RANK[confidence];
+}
+let consolidationInstance = null;
+let consolidationPromise = null;
+/**
+ * Returns the shared {@link MemoryConsolidationService} for this process,
+ * resolving the configured embedder on first use so cosine consolidation can
+ * fire when a provider implements `embed?()`. Subsequent calls return the same
+ * instance without re-resolving.
+ */
+export async function getMemoryConsolidation() {
+	if (consolidationInstance !== null) return consolidationInstance;
+	consolidationPromise ??= MemoryConsolidationService.create().then((service) => {
+		consolidationInstance = service;
+		return service;
+	});
+	return consolidationPromise;
+}
+export function resetMemoryConsolidation() {
+	consolidationInstance = null;
+	consolidationPromise = null;
+}
+//# sourceMappingURL=consolidation-service.js.map

package/dist/consolidation-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation-service.js","sourceRoot":"","sources":["../src/consolidation-service.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Memory-domain constants for the bundled vault implementation.
+ *
+ * These are the defaults the vault uses when configuration omits them. The
+ * host's `config/constants` re-exports these for back-compat with the Zod
+ * memory schema and any other host code that referenced them.
+ */
+export declare const MS_PER_DAY: number;
+export declare const MEMORY_STORE_VERSION = 1;
+export declare const MEMORY_HALF_LIFE_CAP_MULTIPLIER = 10;
+export declare const MEMORY_PERSIST_DEBOUNCE_MS = 2000;
+export declare const DEFAULT_MEMORY_ENABLED = true;
+export declare const DEFAULT_MEMORY_BACKEND: 'vault';
+export declare const DEFAULT_MEMORY_EPISODIC_HALF_LIFE_DAYS = 7;
+export declare const DEFAULT_MEMORY_SEMANTIC_HALF_LIFE_DAYS = 30;
+export declare const DEFAULT_MEMORY_DECISION_HALF_LIFE_DAYS = 21;
+export declare const DEFAULT_MEMORY_RETRIEVAL_BOOST_DAYS = 2;
+export declare const DEFAULT_MEMORY_PRUNE_THRESHOLD = 0.05;
+export declare const DEFAULT_MEMORY_MAX_ENTRIES_PER_STORE = 500;
+export declare const DEFAULT_MEMORY_ERROR_HALF_LIFE_MULTIPLIER = 2;
+export declare const DEFAULT_MEMORY_INJECTION_TOKEN_BUDGET = 2000;
+export declare const DEFAULT_MEMORY_INJECTION_STRENGTH_THRESHOLD = 0.2;
+export declare const DEFAULT_MEMORY_EMBED_MODEL = 'nomic-embed-text';
+export declare const DEFAULT_MEMORY_EMBED_DIM = 768;
+export declare const DEFAULT_MEMORY_EMBED_BATCH_SIZE = 32;
+export declare const DEFAULT_MEMORY_RECALL_SEED_K = 12;
+export declare const DEFAULT_MEMORY_RECALL_WALK_DEPTH = 2;
+export declare const DEFAULT_MEMORY_RECALL_WALK_DECAY = 0.6;
+export declare const DEFAULT_MEMORY_RECALL_CO_ACCESS_INCREMENT = 1;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,UAAU,QAAsB,CAAC;AAE9C,eAAO,MAAM,oBAAoB,IAAI,CAAC;AACtC,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAE/C,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAC3C,eAAO,MAAM,sBAAsB,EAAG,OAAgB,CAAC;AAEvD,eAAO,MAAM,sCAAsC,IAAI,CAAC;AACxD,eAAO,MAAM,sCAAsC,KAAK,CAAC;AACzD,eAAO,MAAM,sCAAsC,KAAK,CAAC;AACzD,eAAO,MAAM,mCAAmC,IAAI,CAAC;AACrD,eAAO,MAAM,8BAA8B,OAAO,CAAC;AACnD,eAAO,MAAM,oCAAoC,MAAM,CAAC;AACxD,eAAO,MAAM,yCAAyC,IAAI,CAAC;AAE3D,eAAO,MAAM,qCAAqC,OAAO,CAAC;AAC1D,eAAO,MAAM,2CAA2C,MAAM,CAAC;AAE/D,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAC7D,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAClD,eAAO,MAAM,gCAAgC,MAAM,CAAC;AACpD,eAAO,MAAM,yCAAyC,IAAI,CAAC"}

package/dist/constants.js

@@ -0,0 +1,30 @@
+/**
+ * Memory-domain constants for the bundled vault implementation.
+ *
+ * These are the defaults the vault uses when configuration omits them. The
+ * host's `config/constants` re-exports these for back-compat with the Zod
+ * memory schema and any other host code that referenced them.
+ */
+export const MS_PER_DAY = 24 * 60 * 60 * 1000;
+export const MEMORY_STORE_VERSION = 1;
+export const MEMORY_HALF_LIFE_CAP_MULTIPLIER = 10;
+export const MEMORY_PERSIST_DEBOUNCE_MS = 2000;
+export const DEFAULT_MEMORY_ENABLED = true;
+export const DEFAULT_MEMORY_BACKEND = 'vault';
+export const DEFAULT_MEMORY_EPISODIC_HALF_LIFE_DAYS = 7;
+export const DEFAULT_MEMORY_SEMANTIC_HALF_LIFE_DAYS = 30;
+export const DEFAULT_MEMORY_DECISION_HALF_LIFE_DAYS = 21;
+export const DEFAULT_MEMORY_RETRIEVAL_BOOST_DAYS = 2;
+export const DEFAULT_MEMORY_PRUNE_THRESHOLD = 0.05;
+export const DEFAULT_MEMORY_MAX_ENTRIES_PER_STORE = 500;
+export const DEFAULT_MEMORY_ERROR_HALF_LIFE_MULTIPLIER = 2;
+export const DEFAULT_MEMORY_INJECTION_TOKEN_BUDGET = 2000;
+export const DEFAULT_MEMORY_INJECTION_STRENGTH_THRESHOLD = 0.2;
+export const DEFAULT_MEMORY_EMBED_MODEL = 'nomic-embed-text';
+export const DEFAULT_MEMORY_EMBED_DIM = 768;
+export const DEFAULT_MEMORY_EMBED_BATCH_SIZE = 32;
+export const DEFAULT_MEMORY_RECALL_SEED_K = 12;
+export const DEFAULT_MEMORY_RECALL_WALK_DEPTH = 2;
+export const DEFAULT_MEMORY_RECALL_WALK_DECAY = 0.6;
+export const DEFAULT_MEMORY_RECALL_CO_ACCESS_INCREMENT = 1;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AACtC,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAClD,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAE/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAC3C,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAgB,CAAC;AAEvD,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC;AACxD,MAAM,CAAC,MAAM,sCAAsC,GAAG,EAAE,CAAC;AACzD,MAAM,CAAC,MAAM,sCAAsC,GAAG,EAAE,CAAC;AACzD,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC;AACrD,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,CAAC;AACnD,MAAM,CAAC,MAAM,oCAAoC,GAAG,GAAG,CAAC;AACxD,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,qCAAqC,GAAG,IAAI,CAAC;AAC1D,MAAM,CAAC,MAAM,2CAA2C,GAAG,GAAG,CAAC;AAE/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,kBAAkB,CAAC;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAC5C,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAElD,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAC/C,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC;AAClD,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,CAAC;AACpD,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC,CAAC"}

package/dist/decay.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Memory decay computation.
+ *
+ * Implements exponential decay: strength = 0.5^(elapsed_days / halfLifeDays)
+ * Biologically inspired by the Ebbinghaus forgetting curve.
+ *
+ * All functions are pure with no side effects, making them easily testable
+ * and safe to call during hot paths (e.g. query filtering).
+ */
+/**
+ * Compute current memory strength using exponential decay.
+ *
+ * Strength ranges from (0, 1] — it approaches 0 asymptotically but
+ * never reaches it. A strength of 1.0 means "just created/accessed".
+ *
+ * @param referenceAt - ISO 8601 timestamp to measure elapsed time from
+ * @param halfLifeDays - Number of days for strength to halve
+ * @param now - Current time in milliseconds (injectable for testing, defaults to Date.now())
+ * @returns Strength in range (0, 1]
+ */
+export declare function computeStrength(referenceAt: string, halfLifeDays: number, now?: number): number;
+/**
+ * Compute the effective half-life for a memory entry.
+ *
+ * The base half-life is extended by:
+ * - Error multiplier: error memories decay more slowly to preserve hard lessons
+ * - Retrieval boost: each access adds boostDays to the half-life (spaced repetition)
+ *
+ * @param baseHalfLifeDays - The category's default half-life in days
+ * @param accessCount - Number of times the entry has been retrieved
+ * @param isError - Whether the entry records an error (gets errorMultiplier × halfLife)
+ * @param retrievalBoostDays - Days added to half-life per retrieval
+ * @param errorMultiplier - Multiplier applied to base half-life for error entries
+ * @returns Effective half-life in days
+ */
+export declare function computeEffectiveHalfLife(
+	baseHalfLifeDays: number,
+	accessCount: number,
+	isError: boolean,
+	retrievalBoostDays: number,
+	errorMultiplier: number
+): number;
+/**
+ * Determine whether a memory entry should be pruned based on its strength.
+ *
+ * @param strength - Current computed strength (0-1)
+ * @param threshold - Minimum strength to retain the entry
+ * @returns true if the entry should be removed
+ */
+export declare function shouldPrune(strength: number, threshold: number): boolean;
+//# sourceMappingURL=decay.d.ts.map

package/dist/decay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decay.d.ts","sourceRoot":"","sources":["../src/decay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,MAAM,CAInG;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACvC,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,kBAAkB,EAAE,MAAM,EAC1B,eAAe,EAAE,MAAM,GACrB,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAExE"}

package/dist/decay.js

@@ -0,0 +1,59 @@
+/**
+ * Memory decay computation.
+ *
+ * Implements exponential decay: strength = 0.5^(elapsed_days / halfLifeDays)
+ * Biologically inspired by the Ebbinghaus forgetting curve.
+ *
+ * All functions are pure with no side effects, making them easily testable
+ * and safe to call during hot paths (e.g. query filtering).
+ */
+// Inlined to keep this leaf module self-contained at the package boundary.
+// The host's `config/constants` exposes the same value; if other parts of
+// this package end up needing it too, lift it into a shared
+// `./constants.ts` and re-export it from the host for back-compat.
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+/**
+ * Compute current memory strength using exponential decay.
+ *
+ * Strength ranges from (0, 1] — it approaches 0 asymptotically but
+ * never reaches it. A strength of 1.0 means "just created/accessed".
+ *
+ * @param referenceAt - ISO 8601 timestamp to measure elapsed time from
+ * @param halfLifeDays - Number of days for strength to halve
+ * @param now - Current time in milliseconds (injectable for testing, defaults to Date.now())
+ * @returns Strength in range (0, 1]
+ */
+export function computeStrength(referenceAt, halfLifeDays, now = Date.now()) {
+	const elapsedMs = now - new Date(referenceAt).getTime();
+	const elapsedDays = elapsedMs / MS_PER_DAY;
+	return Math.pow(0.5, elapsedDays / halfLifeDays);
+}
+/**
+ * Compute the effective half-life for a memory entry.
+ *
+ * The base half-life is extended by:
+ * - Error multiplier: error memories decay more slowly to preserve hard lessons
+ * - Retrieval boost: each access adds boostDays to the half-life (spaced repetition)
+ *
+ * @param baseHalfLifeDays - The category's default half-life in days
+ * @param accessCount - Number of times the entry has been retrieved
+ * @param isError - Whether the entry records an error (gets errorMultiplier × halfLife)
+ * @param retrievalBoostDays - Days added to half-life per retrieval
+ * @param errorMultiplier - Multiplier applied to base half-life for error entries
+ * @returns Effective half-life in days
+ */
+export function computeEffectiveHalfLife(baseHalfLifeDays, accessCount, isError, retrievalBoostDays, errorMultiplier) {
+	const base = isError ? baseHalfLifeDays * errorMultiplier : baseHalfLifeDays;
+	return base + accessCount * retrievalBoostDays;
+}
+/**
+ * Determine whether a memory entry should be pruned based on its strength.
+ *
+ * @param strength - Current computed strength (0-1)
+ * @param threshold - Minimum strength to retain the entry
+ * @returns true if the entry should be removed
+ */
+export function shouldPrune(strength, threshold) {
+	return strength < threshold;
+}
+//# sourceMappingURL=decay.js.map

package/dist/decay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decay.js","sourceRoot":"","sources":["../src/decay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2EAA2E;AAC3E,0EAA0E;AAC1E,4DAA4D;AAC5D,mEAAmE;AACnE,MAAM,UAAU,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB,EAAE,YAAoB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IAC1F,MAAM,SAAS,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,CAAC;IACxD,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACvC,gBAAwB,EACxB,WAAmB,EACnB,OAAgB,EAChB,kBAA0B,EAC1B,eAAuB;IAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,gBAAgB,GAAG,eAAe,CAAC,CAAC,CAAC,gBAAgB,CAAC;IAC7E,OAAO,IAAI,GAAG,WAAW,GAAG,kBAAkB,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB,EAAE,SAAiB;IAC9D,OAAO,QAAQ,GAAG,SAAS,CAAC;AAC7B,CAAC"}

package/dist/embeddings/embedder.port.d.ts

@@ -0,0 +1,9 @@
+import type {
+	PluginEmbeddingRequest as EmbeddingRequest,
+	PluginEmbeddingResult as EmbeddingResult
+} from '@windagency/valora-plugin-api';
+export type { EmbeddingRequest, EmbeddingResult };
+export interface EmbedderPort {
+	embed(req: EmbeddingRequest): Promise<EmbeddingResult>;
+}
+//# sourceMappingURL=embedder.port.d.ts.map

package/dist/embeddings/embedder.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.port.d.ts","sourceRoot":"","sources":["../../src/embeddings/embedder.port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,sBAAsB,IAAI,gBAAgB,EAC1C,qBAAqB,IAAI,eAAe,EACxC,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;AAElD,MAAM,WAAW,YAAY;IAC5B,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACvD"}

package/dist/embeddings/embedder.port.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embedder.port.js.map

package/dist/embeddings/embedder.port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.port.js","sourceRoot":"","sources":["../../src/embeddings/embedder.port.ts"],"names":[],"mappings":""}

package/dist/embeddings/llm-provider-embedder.d.ts

@@ -0,0 +1,26 @@
+import type { LLMProviderContract as LLMProvider } from '@windagency/valora-plugin-api';
+import type { EmbedderPort, EmbeddingRequest, EmbeddingResult } from './embedder.port.js';
+/**
+ * Thrown when the wrapped {@link LLMProvider} does not implement the optional
+ * `embed?()` method. ADR-013 §4 mandates graceful degradation: callers should
+ * detect this error and fall back to the lexical recall path rather than fail
+ * the entire pipeline.
+ */
+export declare class EmbedderNotSupportedError extends Error {
+	constructor(providerName: string);
+}
+/**
+ * Adapter that exposes an {@link LLMProvider}'s optional `embed?()` method
+ * through the {@link EmbedderPort} contract used by the memory subsystem.
+ *
+ * Per ADR-013 §4 and CODE-QUALITY-GUIDELINES.md (Adapter Pattern, Appendix B),
+ * memory must reach embedders only via this port — never via direct LLM-SDK
+ * imports — so swapping providers (Ollama, OpenAI, Anthropic) is a one-line
+ * change in DI wiring.
+ */
+export declare class LlmProviderEmbedder implements EmbedderPort {
+	private readonly provider;
+	constructor(provider: LLMProvider);
+	embed(req: EmbeddingRequest): Promise<EmbeddingResult>;
+}
+//# sourceMappingURL=llm-provider-embedder.d.ts.map

package/dist/embeddings/llm-provider-embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-embedder.d.ts","sourceRoot":"","sources":["../../src/embeddings/llm-provider-embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAExF,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1F;;;;;GAKG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACvC,YAAY,EAAE,MAAM;CAIhC;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,WAAW;IAE5C,KAAK,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC;CAM5D"}