@windagency/valora-plugin-memory-vault 1.0.0

package/dist/config-schema.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Vault-specific configuration schema.
+ *
+ * All vault-tuning knobs live under `plugins.memory-vault.*`; the host's
+ * `memory.*` block owns only `{enabled, provider}`. This schema is the
+ * bundled vault's own source of truth, read from the raw plugin namespace
+ * via `parseVaultPluginConfig()`.
+ */
+import { z } from 'zod';
+export declare const VAULT_PLUGIN_CONFIG_SCHEMA: z.ZodObject<
+	{
+		decision_half_life_days: z.ZodDefault<z.ZodNumber>;
+		embedding: z.ZodOptional<
+			z.ZodObject<
+				{
+					batch_size: z.ZodDefault<z.ZodNumber>;
+					dim: z.ZodDefault<z.ZodNumber>;
+					model: z.ZodDefault<z.ZodString>;
+					provider: z.ZodDefault<z.ZodString>;
+				},
+				'strip',
+				z.ZodTypeAny,
+				{
+					batch_size: number;
+					dim: number;
+					model: string;
+					provider: string;
+				},
+				{
+					batch_size?: number | undefined;
+					dim?: number | undefined;
+					model?: string | undefined;
+					provider?: string | undefined;
+				}
+			>
+		>;
+		episodic_half_life_days: z.ZodDefault<z.ZodNumber>;
+		error_half_life_multiplier: z.ZodDefault<z.ZodNumber>;
+		injection_strength_threshold: z.ZodDefault<z.ZodNumber>;
+		injection_token_budget: z.ZodDefault<z.ZodNumber>;
+		max_entries_per_store: z.ZodDefault<z.ZodNumber>;
+		prune_threshold: z.ZodDefault<z.ZodNumber>;
+		recall: z.ZodOptional<
+			z.ZodObject<
+				{
+					co_access_increment: z.ZodDefault<z.ZodNumber>;
+					seed_k: z.ZodDefault<z.ZodNumber>;
+					walk_decay: z.ZodDefault<z.ZodNumber>;
+					walk_depth: z.ZodDefault<z.ZodNumber>;
+				},
+				'strip',
+				z.ZodTypeAny,
+				{
+					co_access_increment: number;
+					seed_k: number;
+					walk_decay: number;
+					walk_depth: number;
+				},
+				{
+					co_access_increment?: number | undefined;
+					seed_k?: number | undefined;
+					walk_decay?: number | undefined;
+					walk_depth?: number | undefined;
+				}
+			>
+		>;
+		retrieval_boost_days: z.ZodDefault<z.ZodNumber>;
+		semantic_half_life_days: z.ZodDefault<z.ZodNumber>;
+	},
+	'strip',
+	z.ZodTypeAny,
+	{
+		decision_half_life_days: number;
+		episodic_half_life_days: number;
+		error_half_life_multiplier: number;
+		injection_strength_threshold: number;
+		injection_token_budget: number;
+		max_entries_per_store: number;
+		prune_threshold: number;
+		retrieval_boost_days: number;
+		semantic_half_life_days: number;
+		embedding?:
+			| {
+					batch_size: number;
+					dim: number;
+					model: string;
+					provider: string;
+			  }
+			| undefined;
+		recall?:
+			| {
+					co_access_increment: number;
+					seed_k: number;
+					walk_decay: number;
+					walk_depth: number;
+			  }
+			| undefined;
+	},
+	{
+		decision_half_life_days?: number | undefined;
+		embedding?:
+			| {
+					batch_size?: number | undefined;
+					dim?: number | undefined;
+					model?: string | undefined;
+					provider?: string | undefined;
+			  }
+			| undefined;
+		episodic_half_life_days?: number | undefined;
+		error_half_life_multiplier?: number | undefined;
+		injection_strength_threshold?: number | undefined;
+		injection_token_budget?: number | undefined;
+		max_entries_per_store?: number | undefined;
+		prune_threshold?: number | undefined;
+		recall?:
+			| {
+					co_access_increment?: number | undefined;
+					seed_k?: number | undefined;
+					walk_decay?: number | undefined;
+					walk_depth?: number | undefined;
+			  }
+			| undefined;
+		retrieval_boost_days?: number | undefined;
+		semantic_half_life_days?: number | undefined;
+	}
+>;
+export type VaultPluginConfig = z.infer<typeof VAULT_PLUGIN_CONFIG_SCHEMA>;
+/**
+ * Parse the raw `plugins['memory-vault']` subtree into a fully-defaulted
+ * {@link VaultPluginConfig}. Returns the all-defaults config when the
+ * subtree is missing or empty.
+ */
+export declare function parseVaultPluginConfig(raw: unknown): VaultPluginConfig;
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../src/config-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmCxB,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYrC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,iBAAiB,CAEtE"}

package/dist/config-schema.js

@@ -0,0 +1,61 @@
+/**
+ * Vault-specific configuration schema.
+ *
+ * All vault-tuning knobs live under `plugins.memory-vault.*`; the host's
+ * `memory.*` block owns only `{enabled, provider}`. This schema is the
+ * bundled vault's own source of truth, read from the raw plugin namespace
+ * via `parseVaultPluginConfig()`.
+ */
+import { z } from 'zod';
+import {
+	DEFAULT_MEMORY_DECISION_HALF_LIFE_DAYS,
+	DEFAULT_MEMORY_EMBED_BATCH_SIZE,
+	DEFAULT_MEMORY_EMBED_DIM,
+	DEFAULT_MEMORY_EMBED_MODEL,
+	DEFAULT_MEMORY_EPISODIC_HALF_LIFE_DAYS,
+	DEFAULT_MEMORY_ERROR_HALF_LIFE_MULTIPLIER,
+	DEFAULT_MEMORY_INJECTION_STRENGTH_THRESHOLD,
+	DEFAULT_MEMORY_INJECTION_TOKEN_BUDGET,
+	DEFAULT_MEMORY_MAX_ENTRIES_PER_STORE,
+	DEFAULT_MEMORY_PRUNE_THRESHOLD,
+	DEFAULT_MEMORY_RECALL_CO_ACCESS_INCREMENT,
+	DEFAULT_MEMORY_RECALL_SEED_K,
+	DEFAULT_MEMORY_RECALL_WALK_DECAY,
+	DEFAULT_MEMORY_RECALL_WALK_DEPTH,
+	DEFAULT_MEMORY_RETRIEVAL_BOOST_DAYS,
+	DEFAULT_MEMORY_SEMANTIC_HALF_LIFE_DAYS
+} from './constants.js';
+const VAULT_EMBEDDING_SCHEMA = z.object({
+	batch_size: z.number().min(1).max(256).default(DEFAULT_MEMORY_EMBED_BATCH_SIZE),
+	dim: z.number().min(1).default(DEFAULT_MEMORY_EMBED_DIM),
+	model: z.string().default(DEFAULT_MEMORY_EMBED_MODEL),
+	provider: z.string().default('auto')
+});
+const VAULT_RECALL_SCHEMA = z.object({
+	co_access_increment: z.number().min(0).default(DEFAULT_MEMORY_RECALL_CO_ACCESS_INCREMENT),
+	seed_k: z.number().min(1).max(100).default(DEFAULT_MEMORY_RECALL_SEED_K),
+	walk_decay: z.number().min(0).max(1).default(DEFAULT_MEMORY_RECALL_WALK_DECAY),
+	walk_depth: z.number().min(0).max(10).default(DEFAULT_MEMORY_RECALL_WALK_DEPTH)
+});
+export const VAULT_PLUGIN_CONFIG_SCHEMA = z.object({
+	decision_half_life_days: z.number().min(1).max(365).default(DEFAULT_MEMORY_DECISION_HALF_LIFE_DAYS),
+	embedding: VAULT_EMBEDDING_SCHEMA.optional(),
+	episodic_half_life_days: z.number().min(1).max(365).default(DEFAULT_MEMORY_EPISODIC_HALF_LIFE_DAYS),
+	error_half_life_multiplier: z.number().min(1).max(10).default(DEFAULT_MEMORY_ERROR_HALF_LIFE_MULTIPLIER),
+	injection_strength_threshold: z.number().min(0).max(1).default(DEFAULT_MEMORY_INJECTION_STRENGTH_THRESHOLD),
+	injection_token_budget: z.number().min(100).max(10000).default(DEFAULT_MEMORY_INJECTION_TOKEN_BUDGET),
+	max_entries_per_store: z.number().min(10).max(10000).default(DEFAULT_MEMORY_MAX_ENTRIES_PER_STORE),
+	prune_threshold: z.number().min(0).max(1).default(DEFAULT_MEMORY_PRUNE_THRESHOLD),
+	recall: VAULT_RECALL_SCHEMA.optional(),
+	retrieval_boost_days: z.number().min(0).max(30).default(DEFAULT_MEMORY_RETRIEVAL_BOOST_DAYS),
+	semantic_half_life_days: z.number().min(1).max(365).default(DEFAULT_MEMORY_SEMANTIC_HALF_LIFE_DAYS)
+});
+/**
+ * Parse the raw `plugins['memory-vault']` subtree into a fully-defaulted
+ * {@link VaultPluginConfig}. Returns the all-defaults config when the
+ * subtree is missing or empty.
+ */
+export function parseVaultPluginConfig(raw) {
+	return VAULT_PLUGIN_CONFIG_SCHEMA.parse(raw ?? {});
+}
+//# sourceMappingURL=config-schema.js.map

package/dist/config-schema.js.map

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

package/dist/consolidation/cluster.d.ts

@@ -0,0 +1,17 @@
+import type { MemoryEntry } from '@windagency/valora-plugin-api';
+import type { VectorStore } from '../embeddings/vector-store.js';
+export declare function centroidSummary(cluster: MemoryEntry[]): string;
+/**
+ * Cluster entries whose embedding cosine similarity meets `threshold`.
+ *
+ * The implementation is order-independent: it sorts the input by `entry.id`
+ * before clustering, performs a Union-Find pass over all pairwise comparisons,
+ * and emits clusters of size ≥ 2 in deterministic order. The same logical
+ * input always produces the same output (audit finding H12).
+ */
+export declare function cosineClusters(
+	entries: MemoryEntry[],
+	vectorStore: VectorStore,
+	threshold: number
+): MemoryEntry[][];
+//# sourceMappingURL=cluster.d.ts.map

package/dist/consolidation/cluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.d.ts","sourceRoot":"","sources":["../../src/consolidation/cluster.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAcjE,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAE9D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,EAAE,CAanH"}

package/dist/consolidation/cluster.js

@@ -0,0 +1,59 @@
+import { cosineSimilarity } from '../retrieval/cosine-ann.js';
+export function centroidSummary(cluster) {
+	return cluster.reduce((longest, e) => (e.content.length > longest.content.length ? e : longest)).content;
+}
+/**
+ * Cluster entries whose embedding cosine similarity meets `threshold`.
+ *
+ * The implementation is order-independent: it sorts the input by `entry.id`
+ * before clustering, performs a Union-Find pass over all pairwise comparisons,
+ * and emits clusters of size ≥ 2 in deterministic order. The same logical
+ * input always produces the same output (audit finding H12).
+ */
+export function cosineClusters(entries, vectorStore, threshold) {
+	const vectored = collectVectored(entries, vectorStore);
+	if (vectored.length === 0) return [];
+	const parent = new Array(vectored.length).fill(0).map((_, i) => i);
+	for (let i = 0; i < vectored.length; i++) {
+		for (let j = i + 1; j < vectored.length; j++) {
+			const score = cosineSimilarity(vectored[i].vec, vectored[j].vec);
+			if (score >= threshold) union(parent, i, j);
+		}
+	}
+	return collectClusters(parent, vectored);
+}
+function collectClusters(parent, vectored) {
+	const groups = new Map();
+	for (let i = 0; i < vectored.length; i++) {
+		const root = find(parent, i);
+		const list = groups.get(root) ?? [];
+		list.push(vectored[i].entry);
+		groups.set(root, list);
+	}
+	return [...groups.values()].filter((m) => m.length >= 2);
+}
+function collectVectored(entries, vectorStore) {
+	const vectored = [];
+	for (const entry of entries) {
+		const vec = vectorStore.read(entry.id);
+		if (vec !== null) vectored.push({ entry, vec });
+	}
+	// Byte-order sort — locale-independent and deterministic across environments.
+	vectored.sort((a, b) => (a.entry.id < b.entry.id ? -1 : a.entry.id > b.entry.id ? 1 : 0));
+	return vectored;
+}
+function find(parent, i) {
+	while (parent[i] !== i) {
+		parent[i] = parent[parent[i]];
+		i = parent[i];
+	}
+	return i;
+}
+function union(parent, a, b) {
+	const ra = find(parent, a);
+	const rb = find(parent, b);
+	if (ra === rb) return;
+	if (ra < rb) parent[rb] = ra;
+	else parent[ra] = rb;
+}
+//# sourceMappingURL=cluster.js.map

package/dist/consolidation/cluster.js.map

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

package/dist/consolidation-service.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 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 type { ConsolidationOptions, ConsolidationResult, MemoryStorePort } from '@windagency/valora-plugin-api';
+import type { EmbedderPort } from './embeddings/embedder.port.js';
+import { type ProviderLookup } from './embeddings/resolve-embedder.js';
+export type { ConsolidationOptions, ConsolidationResult };
+/**
+ * Optional callback invoked after consolidation finishes. The host wires
+ * this to its `pipeline-emitter` so the existing observability surface
+ * remains. When omitted (e.g. plugin-direct usage or tests), no event is
+ * emitted.
+ */
+export type ConsolidationCompleteListener = (_result: ConsolidationResult) => void;
+/**
+ * Optional context the host supplies so the package does not depend on
+ * `config/loader` or `output/pipeline-emitter`. When absent, the service
+ * uses a sensible 30-day default for the semantic half-life and emits
+ * no completion event.
+ */
+export interface ConsolidationServiceContext {
+	/** Listener for consolidation-complete events (host wires to pipeline-emitter). */
+	onComplete?: ConsolidationCompleteListener;
+	/** Provider lookup so cosine consolidation can resolve an embedder. */
+	providerLookup?: ProviderLookup;
+	/** Override the semantic half-life used for cosine-merged entries. */
+	semanticHalfLifeDays?: number;
+}
+export declare class MemoryConsolidationService {
+	private readonly context;
+	private readonly embedder?;
+	private readonly manager;
+	private readonly store;
+	constructor(store?: MemoryStorePort, embedder?: EmbedderPort, context?: ConsolidationServiceContext);
+	/**
+	 * 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 create(context?: ConsolidationServiceContext): Promise<MemoryConsolidationService>;
+	consolidate(options?: ConsolidationOptions): Promise<ConsolidationResult>;
+	private autoPromoteEntries;
+	private buildCluster;
+	private mergeCluster;
+	private readSemanticHalfLifeOrDefault;
+	/** Groups episodic entries by their primary tag; entries with no tags are excluded. */
+	private buildTagGroups;
+	private mergeClusterCosine;
+	private mergeCosine;
+	private mergeEpisodicEntries;
+	private mergeJaccard;
+	private runGitInvalidation;
+}
+/**
+ * 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 declare function getMemoryConsolidation(): Promise<MemoryConsolidationService>;
+export declare function resetMemoryConsolidation(): void;
+//# sourceMappingURL=consolidation-service.d.ts.map

package/dist/consolidation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation-service.d.ts","sourceRoot":"","sources":["../src/consolidation-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACX,oBAAoB,EACpB,mBAAmB,EAGnB,eAAe,EACf,MAAM,+BAA+B,CAAC;AAIvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAGlE,OAAO,EAAE,KAAK,cAAc,EAAmB,MAAM,kCAAkC,CAAC;AAOxF,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;AAE1D;;;;;GAKG;AAEH,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;AAEnF;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC3C,mFAAmF;IACnF,UAAU,CAAC,EAAE,6BAA6B,CAAC;IAC3C,uEAAuE;IACvE,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,sEAAsE;IACtE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAgDD,qBAAa,0BAA0B;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;gBAE5B,KAAK,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,OAAO,GAAE,2BAAgC;IAOvG;;;;;;;;OAQG;WACU,MAAM,CAAC,OAAO,GAAE,2BAAgC,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAU7F,WAAW,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAoDrE,kBAAkB;IAgBhC,OAAO,CAAC,YAAY;YAmBN,YAAY;IAoC1B,OAAO,CAAC,6BAA6B;IAIrC,uFAAuF;IACvF,OAAO,CAAC,cAAc;YAWR,kBAAkB;YA0ClB,WAAW;YA0BX,oBAAoB;YASpB,YAAY;YA2BZ,kBAAkB;CA6DhC;AAsBD;;;;;GAKG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,0BAA0B,CAAC,CAOlF;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C"}