@windagency/valora-plugin-memory-vault 1.0.0

package/dist/embeddings/llm-provider-embedder.js

@@ -0,0 +1,34 @@
+/**
+ * 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 class EmbedderNotSupportedError extends Error {
+	constructor(providerName) {
+		super(`LLM provider '${providerName}' does not implement embed(); cannot generate embeddings.`);
+		this.name = 'EmbedderNotSupportedError';
+	}
+}
+/**
+ * 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 class LlmProviderEmbedder {
+	provider;
+	constructor(provider) {
+		this.provider = provider;
+	}
+	async embed(req) {
+		if (!this.provider.embed) {
+			throw new EmbedderNotSupportedError(this.provider.name);
+		}
+		return this.provider.embed(req);
+	}
+}
+//# sourceMappingURL=llm-provider-embedder.js.map

package/dist/embeddings/llm-provider-embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-provider-embedder.js","sourceRoot":"","sources":["../../src/embeddings/llm-provider-embedder.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACnD,YAAY,YAAoB;QAC/B,KAAK,CAAC,iBAAiB,YAAY,2DAA2D,CAAC,CAAC;QAChG,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IACzC,CAAC;CACD;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IACF;IAA7B,YAA6B,QAAqB;QAArB,aAAQ,GAAR,QAAQ,CAAa;IAAG,CAAC;IAEtD,KAAK,CAAC,KAAK,CAAC,GAAqB;QAChC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC1B,MAAM,IAAI,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;CACD"}

package/dist/embeddings/resolve-embedder.d.ts

@@ -0,0 +1,27 @@
+import type { LLMProviderContract as LLMProvider, MemoryRetentionConfig } from '@windagency/valora-plugin-api';
+import type { EmbedderPort } from './embedder.port.js';
+/**
+ * Lookup function the host injects so the bundled vault does not depend on
+ * the host's `llm/registry` directly. The host wires this to its real
+ * provider registry at boot via the bootstrap glue.
+ */
+export interface ProviderLookup {
+	createProvider(_name: string, _config: Record<string, unknown>): LLMProvider;
+	getAvailableProviders(): string[];
+}
+/**
+ * Resolve an {@link EmbedderPort} for the memory subsystem from the configured
+ * embedding provider. Returns `undefined` when:
+ *   - Embeddings are not configured (`memory.embedding` absent).
+ *   - No provider lookup is supplied.
+ *   - The configured provider does not implement `embed?()`.
+ *   - The provider registry cannot construct the provider.
+ *
+ * Semantic recall falls back gracefully to the lexical path in any of these
+ * cases, so this resolver is intentionally forgiving.
+ */
+export declare function resolveEmbedder(
+	memoryConfig: MemoryRetentionConfig | undefined,
+	providerLookup?: ProviderLookup
+): Promise<EmbedderPort | undefined>;
+//# sourceMappingURL=resolve-embedder.d.ts.map

package/dist/embeddings/resolve-embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-embedder.d.ts","sourceRoot":"","sources":["../../src/embeddings/resolve-embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,IAAI,WAAW,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAI/G,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC;IAC7E,qBAAqB,IAAI,MAAM,EAAE,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC9B,YAAY,EAAE,qBAAqB,GAAG,SAAS,EAC/C,cAAc,CAAC,EAAE,cAAc,GAC7B,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAkBnC"}

package/dist/embeddings/resolve-embedder.js

@@ -0,0 +1,38 @@
+import { getLogger } from '@windagency/valora-runtime';
+import { LlmProviderEmbedder } from './llm-provider-embedder.js';
+/**
+ * Resolve an {@link EmbedderPort} for the memory subsystem from the configured
+ * embedding provider. Returns `undefined` when:
+ *   - Embeddings are not configured (`memory.embedding` absent).
+ *   - No provider lookup is supplied.
+ *   - The configured provider does not implement `embed?()`.
+ *   - The provider registry cannot construct the provider.
+ *
+ * Semantic recall falls back gracefully to the lexical path in any of these
+ * cases, so this resolver is intentionally forgiving.
+ */
+export function resolveEmbedder(memoryConfig, providerLookup) {
+	const embeddingConfig = memoryConfig?.embedding;
+	if (!embeddingConfig) return Promise.resolve(undefined);
+	if (providerLookup === undefined) return Promise.resolve(undefined);
+	try {
+		const requested = embeddingConfig.provider;
+		const providerName = requested === 'auto' ? selectAutoProvider(providerLookup.getAvailableProviders()) : requested;
+		if (providerName === undefined) return Promise.resolve(undefined);
+		const provider = providerLookup.createProvider(providerName, {});
+		if (typeof provider.embed !== 'function') return Promise.resolve(undefined);
+		return Promise.resolve(new LlmProviderEmbedder(provider));
+	} catch (err) {
+		getLogger().debug(`Memory embedder unavailable, falling back to lexical recall: ${String(err)}`);
+		return Promise.resolve(undefined);
+	}
+}
+const AUTO_PREFERENCE = ['ollama', 'openai', 'anthropic', 'google'];
+function selectAutoProvider(available) {
+	const lookup = new Set(available);
+	for (const candidate of AUTO_PREFERENCE) {
+		if (lookup.has(candidate)) return candidate;
+	}
+	return undefined;
+}
+//# sourceMappingURL=resolve-embedder.js.map

package/dist/embeddings/resolve-embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-embedder.js","sourceRoot":"","sources":["../../src/embeddings/resolve-embedder.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAIvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAYjE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC9B,YAA+C,EAC/C,cAA+B;IAE/B,MAAM,eAAe,GAAG,YAAY,EAAE,SAAS,CAAC;IAChD,IAAI,CAAC,eAAe;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEpE,IAAI,CAAC;QACJ,MAAM,SAAS,GAAG,eAAe,CAAC,QAAQ,CAAC;QAC3C,MAAM,YAAY,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,cAAc,CAAC,qBAAqB,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnH,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAElE,MAAM,QAAQ,GAAgB,cAAc,CAAC,cAAc,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QAC9E,IAAI,OAAO,QAAQ,CAAC,KAAK,KAAK,UAAU;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAE5E,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,SAAS,EAAE,CAAC,KAAK,CAAC,gEAAgE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjG,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;AACF,CAAC;AAED,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AAEpE,SAAS,kBAAkB,CAAC,SAAmB;IAC9C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAClC,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;IAC7C,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/embeddings/vector-store.d.ts

@@ -0,0 +1,35 @@
+export interface VectorStore {
+	append(id: string, vector: number[]): void;
+	compact(liveIds: Set<string>): void;
+	count(): number;
+	coverage(liveIds: Set<string>): number;
+	dim: number;
+	flush(): void;
+	has(id: string): boolean;
+	model: string;
+	read(id: string): Float32Array | null;
+}
+interface PersistedMeta {
+	dim: number;
+	model: string;
+}
+/**
+ * Read just the embedding model and dimension persisted on disk, without
+ * loading the binary vectors. Returns null when no index file exists yet.
+ *
+ * Callers use this to align with the on-disk model/dim before opening the
+ * store with `openVectorStore`, so they avoid the dim/model mismatch error.
+ */
+export declare function readVectorStoreMeta(dir: string): null | PersistedMeta;
+/**
+ * Open (or create) a vector store in a directory.
+ *
+ * If an existing index is present and its persisted `model` or `dim` differ
+ * from the caller's arguments, this function throws — preventing corrupt
+ * embeddings from being silently mixed. Callers should use
+ * {@link readVectorStoreMeta} to align with on-disk values, or run
+ * `valora memory reembed` to rebuild with a new model.
+ */
+export declare function openVectorStore(dir: string, model: string, dim: number): VectorStore;
+export {};
+//# sourceMappingURL=vector-store.d.ts.map

package/dist/embeddings/vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-store.d.ts","sourceRoot":"","sources":["../../src/embeddings/vector-store.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC3C,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,MAAM,CAAC;IAChB,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,IAAI,CAAC;IACd,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;CACtC;AAED,UAAU,aAAa;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACd;AA0BD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,CAUrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,WAAW,CAIpF"}

package/dist/embeddings/vector-store.js

@@ -0,0 +1,174 @@
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
+import * as path from 'node:path';
+import { atomicWriteBuffer, atomicWriteFile } from '../vault/file-format.js';
+const BIN_FILENAME = 'embeddings.bin';
+const INDEX_FILENAME = 'embeddings.index.json';
+/**
+ * Read just the embedding model and dimension persisted on disk, without
+ * loading the binary vectors. Returns null when no index file exists yet.
+ *
+ * Callers use this to align with the on-disk model/dim before opening the
+ * store with `openVectorStore`, so they avoid the dim/model mismatch error.
+ */
+export function readVectorStoreMeta(dir) {
+	const indexPath = path.join(dir, INDEX_FILENAME);
+	if (!existsSync(indexPath)) return null;
+	try {
+		const raw = JSON.parse(readFileSync(indexPath, 'utf-8'));
+		if (typeof raw.dim !== 'number' || typeof raw.model !== 'string') return null;
+		return { dim: raw.dim, model: raw.model };
+	} catch {
+		return null;
+	}
+}
+/**
+ * Open (or create) a vector store in a directory.
+ *
+ * If an existing index is present and its persisted `model` or `dim` differ
+ * from the caller's arguments, this function throws — preventing corrupt
+ * embeddings from being silently mixed. Callers should use
+ * {@link readVectorStoreMeta} to align with on-disk values, or run
+ * `valora memory reembed` to rebuild with a new model.
+ */
+export function openVectorStore(dir, model, dim) {
+	mkdirSync(dir, { recursive: true });
+	const state = initializeState(dir, model, dim);
+	return buildStoreApi(state);
+}
+function appendVector(state, id, vector) {
+	if (vector.length !== state.dim) {
+		throw new Error(`Vector for id='${id}' has length ${vector.length}, expected dim ${state.dim}.`);
+	}
+	const f32 = new Float32Array(vector);
+	const chunk = Buffer.from(f32.buffer, f32.byteOffset, f32.byteLength);
+	// Defer concatenation: appending to an array is O(1); a single Buffer.concat
+	// at consolidation time replaces what would otherwise be O(N²) allocation
+	// and copy across N appends.
+	state.pendingChunks.push(chunk);
+	state.offsets.set(id, state.nextOffset);
+	state.nextOffset += state.bytesPerVector;
+}
+function buildStoreApi(state) {
+	return {
+		append(id, vector) {
+			appendVector(state, id, vector);
+		},
+		compact(liveIds) {
+			compactState(state, liveIds);
+			flushState(state);
+		},
+		count: () => state.offsets.size,
+		coverage(liveIds) {
+			if (liveIds.size === 0) return 0;
+			let hit = 0;
+			for (const id of liveIds) if (state.offsets.has(id)) hit++;
+			return hit / liveIds.size;
+		},
+		get dim() {
+			return state.dim;
+		},
+		flush: () => flushState(state),
+		has: (id) => state.offsets.has(id),
+		get model() {
+			return state.model;
+		},
+		read: (id) => readVector(state, id)
+	};
+}
+function compactState(state, liveIds) {
+	consolidatePending(state);
+	const survivingChunks = [];
+	const newOffsets = new Map();
+	let newNext = 0;
+	for (const [id, offset] of state.offsets) {
+		if (!liveIds.has(id)) continue;
+		// subarray returns a view; allocate a fresh buffer so the new contiguous
+		// buffer does not alias the previous `state.buffer`.
+		const view = state.buffer.subarray(offset, offset + state.bytesPerVector);
+		const owned = Buffer.allocUnsafe(view.length);
+		view.copy(owned);
+		survivingChunks.push(owned);
+		newOffsets.set(id, newNext);
+		newNext += state.bytesPerVector;
+	}
+	// One concat, not N — the loop above does no allocation beyond per-vector copies.
+	state.buffer = survivingChunks.length === 0 ? Buffer.alloc(0) : Buffer.concat(survivingChunks);
+	state.offsets.clear();
+	for (const [id, off] of newOffsets) state.offsets.set(id, off);
+	state.nextOffset = newNext;
+}
+function consolidatePending(state) {
+	if (state.pendingChunks.length === 0) return;
+	state.buffer = Buffer.concat([state.buffer, ...state.pendingChunks]);
+	state.pendingChunks = [];
+}
+function flushState(state) {
+	consolidatePending(state);
+	mkdirSync(state.dir, { recursive: true });
+	atomicWriteBuffer(state.binPath, state.buffer);
+	const index = {
+		dim: state.dim,
+		entries: Object.fromEntries(state.offsets),
+		model: state.model
+	};
+	atomicWriteFile(state.indexPath, JSON.stringify(index, null, 2));
+}
+function initializeState(dir, model, dim) {
+	const binPath = path.join(dir, BIN_FILENAME);
+	const indexPath = path.join(dir, INDEX_FILENAME);
+	const persisted = readVectorStoreMeta(dir);
+	if (persisted !== null) {
+		if (persisted.model !== model || persisted.dim !== dim) {
+			throw new Error(
+				`Vector store at ${dir} was written with model='${persisted.model}' dim=${persisted.dim}, ` +
+					`but the caller requested model='${model}' dim=${dim}. ` +
+					`Run \`valora memory reembed\` to rebuild embeddings with the new model.`
+			);
+		}
+	}
+	const offsets = loadOffsets(indexPath);
+	const buffer = loadBuffer(binPath);
+	return {
+		binPath,
+		buffer,
+		bytesPerVector: dim * Float32Array.BYTES_PER_ELEMENT,
+		dim,
+		dir,
+		indexPath,
+		model,
+		nextOffset: buffer.length,
+		offsets,
+		pendingChunks: []
+	};
+}
+function loadBuffer(binPath) {
+	try {
+		return readFileSync(binPath);
+	} catch {
+		return Buffer.alloc(0);
+	}
+}
+function loadOffsets(indexPath) {
+	const offsets = new Map();
+	try {
+		const raw = JSON.parse(readFileSync(indexPath, 'utf-8'));
+		for (const [id, offset] of Object.entries(raw.entries)) {
+			offsets.set(id, offset);
+		}
+	} catch {
+		// no existing index — start empty
+	}
+	return offsets;
+}
+function readVector(state, id) {
+	const offset = state.offsets.get(id);
+	if (offset === undefined) return null;
+	consolidatePending(state);
+	// Copy bytes into a fresh ArrayBuffer so the returned Float32Array does not
+	// alias the internal buffer (which may be reallocated by future appends).
+	const slice = state.buffer.subarray(offset, offset + state.bytesPerVector);
+	const copy = Buffer.allocUnsafe(slice.length);
+	slice.copy(copy);
+	return new Float32Array(copy.buffer, copy.byteOffset, state.dim);
+}
+//# sourceMappingURL=vector-store.js.map

package/dist/embeddings/vector-store.js.map

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

package/dist/extraction-service.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Memory Extraction Service.
+ *
+ * Extracts episodic memory entries from feedback pipeline stage outputs.
+ * Called automatically after the `feedback` command completes successfully.
+ *
+ * Confidence assignment rules:
+ * - Error/failure → 'observed' (directly witnessed)
+ * - User feedback (satisfaction, pain points) → 'verified' (human confirmed)
+ * - Performance/bottleneck → 'observed'
+ * - Auto-detected patterns (agent improvements, workflow optimisations) → 'inferred'
+ */
+import type { MemoryEntry } from '@windagency/valora-plugin-api';
+import { MemoryManager } from './manager.js';
+export declare class MemoryExtractionService {
+	private readonly manager;
+	constructor(manager?: MemoryManager);
+	extractFromFeedbackOutputs(
+		stageOutputs: Array<{
+			outputs: Record<string, unknown>;
+			success: boolean;
+		}>,
+		sessionId: string,
+		agentRole: string
+	): Promise<MemoryEntry[]>;
+	private extractBottlenecks;
+	private extractErrorPatterns;
+	private extractPatterns;
+	private extractUserFeedback;
+}
+export declare function getMemoryExtraction(): MemoryExtractionService;
+export declare function resetMemoryExtraction(): void;
+//# sourceMappingURL=extraction-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extraction-service.d.ts","sourceRoot":"","sources":["../src/extraction-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AA4B7C,qBAAa,uBAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;gBAE5B,OAAO,CAAC,EAAE,aAAa;IAI7B,0BAA0B,CAC/B,YAAY,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,EAC3E,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,EAAE,CAAC;YAoBX,kBAAkB;YA8BlB,oBAAoB;YA8BpB,eAAe;YAuCf,mBAAmB;CA6CjC;AAqBD,wBAAgB,mBAAmB,IAAI,uBAAuB,CAG7D;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/extraction-service.js

@@ -0,0 +1,168 @@
+/**
+ * Memory Extraction Service.
+ *
+ * Extracts episodic memory entries from feedback pipeline stage outputs.
+ * Called automatically after the `feedback` command completes successfully.
+ *
+ * Confidence assignment rules:
+ * - Error/failure → 'observed' (directly witnessed)
+ * - User feedback (satisfaction, pain points) → 'verified' (human confirmed)
+ * - Performance/bottleneck → 'observed'
+ * - Auto-detected patterns (agent improvements, workflow optimisations) → 'inferred'
+ */
+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';
+export class MemoryExtractionService {
+	manager;
+	constructor(manager) {
+		this.manager = manager ?? new MemoryManager(buildDefaultVaultStore());
+	}
+	async extractFromFeedbackOutputs(stageOutputs, sessionId, agentRole) {
+		const merged = stageOutputs.filter((s) => s.success).reduce((acc, s) => ({ ...acc, ...s.outputs }), {});
+		// Extract relatedPaths from files_changed — normalise both the flat string[]
+		// and the object shape { created, modified, deleted, renamed } that the LLM produces.
+		const relatedPaths = normalisedFilesChanged(merged.files_changed);
+		// Call the four private extraction methods and collect all entries
+		const [errorEntries, feedbackEntries, bottleneckEntries, patternEntries] = await Promise.all([
+			this.extractErrorPatterns(merged, sessionId, agentRole, relatedPaths),
+			this.extractUserFeedback(merged, sessionId, agentRole, relatedPaths),
+			this.extractBottlenecks(merged, sessionId, agentRole, relatedPaths),
+			this.extractPatterns(merged, sessionId, agentRole, relatedPaths)
+		]);
+		return [...errorEntries, ...feedbackEntries, ...bottleneckEntries, ...patternEntries];
+	}
+	async extractBottlenecks(outputs, sessionId, agentRole, relatedPaths) {
+		if (!Array.isArray(outputs.bottlenecks_identified) || outputs.bottlenecks_identified.length === 0) {
+			return [];
+		}
+		const bottlenecks = outputs.bottlenecks_identified.slice(0, 3);
+		const entries = [];
+		for (const bottleneck of bottlenecks) {
+			const entry = await this.manager.create('episodic', {
+				agentRole,
+				confidence: 'observed',
+				content: `Performance bottleneck: ${JSON.stringify(bottleneck)}`,
+				isError: false,
+				relatedPaths,
+				sessionId,
+				source: { command: 'feedback', label: 'post-session-extraction' },
+				tags: ['performance', 'bottleneck', agentRole]
+			});
+			entries.push(entry);
+		}
+		return entries;
+	}
+	async extractErrorPatterns(outputs, sessionId, agentRole, relatedPaths) {
+		if (!Array.isArray(outputs.errors_encountered) || outputs.errors_encountered.length === 0) {
+			return [];
+		}
+		const errors = outputs.errors_encountered.slice(0, 5);
+		const entries = [];
+		for (const error of errors) {
+			const entry = await this.manager.create('episodic', {
+				agentRole,
+				confidence: 'observed',
+				content: `Error during ${agentRole}: ${JSON.stringify(error)}`,
+				isError: true,
+				relatedPaths,
+				sessionId,
+				source: { command: 'feedback', label: 'post-session-extraction' },
+				tags: ['error', agentRole, 'feedback']
+			});
+			entries.push(entry);
+		}
+		return entries;
+	}
+	async extractPatterns(outputs, sessionId, agentRole, relatedPaths) {
+		const entries = [];
+		if (Array.isArray(outputs.agent_improvements) && outputs.agent_improvements.length > 0) {
+			const entry = await this.manager.create('episodic', {
+				agentRole,
+				confidence: 'inferred',
+				content: `Agent improvement opportunity: ${JSON.stringify(outputs.agent_improvements)}`,
+				isError: false,
+				relatedPaths,
+				sessionId,
+				source: { command: 'feedback', label: 'post-session-extraction' },
+				tags: ['improvement', 'agent', agentRole]
+			});
+			entries.push(entry);
+		}
+		if (Array.isArray(outputs.workflow_optimizations) && outputs.workflow_optimizations.length > 0) {
+			const entry = await this.manager.create('episodic', {
+				agentRole,
+				confidence: 'inferred',
+				content: `Workflow optimization: ${JSON.stringify(outputs.workflow_optimizations)}`,
+				isError: false,
+				relatedPaths,
+				sessionId,
+				source: { command: 'feedback', label: 'post-session-extraction' },
+				tags: ['optimization', 'workflow']
+			});
+			entries.push(entry);
+		}
+		return entries;
+	}
+	async extractUserFeedback(outputs, sessionId, agentRole, relatedPaths) {
+		const entries = [];
+		const satisfactionScore = outputs.satisfaction_score;
+		const successHighlights = outputs.success_highlights;
+		const painPoints = outputs.pain_points;
+		if (
+			(satisfactionScore !== undefined && satisfactionScore >= 8) ||
+			(Array.isArray(successHighlights) && successHighlights.length > 0)
+		) {
+			const entry = await this.manager.create('episodic', {
+				agentRole,
+				confidence: 'verified',
+				content: `Session rated ${satisfactionScore}/10. ${outputs.feedback_comments ?? ''}`,
+				isError: false,
+				relatedPaths,
+				sessionId,
+				source: { command: 'feedback', label: 'post-session-extraction' },
+				tags: ['user-feedback', 'satisfaction', agentRole]
+			});
+			entries.push(entry);
+		}
+		if (Array.isArray(painPoints) && painPoints.length > 0) {
+			const entry = await this.manager.create('episodic', {
+				agentRole,
+				confidence: 'observed',
+				content: `Pain points: ${JSON.stringify(painPoints)}`,
+				isError: false,
+				relatedPaths,
+				sessionId,
+				source: { command: 'feedback', label: 'post-session-extraction' },
+				tags: ['pain-point', agentRole, 'feedback']
+			});
+			entries.push(entry);
+		}
+		return entries;
+	}
+}
+function buildDefaultVaultStore() {
+	const vaultDir = getDefaultVaultDir();
+	runAutoMigrationIfNeeded(getLegacyJsonDir(), vaultDir);
+	return new VaultStore(vaultDir);
+}
+function normalisedFilesChanged(raw) {
+	if (!raw) return [];
+	if (Array.isArray(raw)) return raw.map((f) => f.trim()).filter((f) => f.length > 0);
+	if (typeof raw === 'object') {
+		return [...(raw.created ?? []), ...(raw.modified ?? []), ...(raw.deleted ?? []), ...(raw.renamed ?? [])]
+			.map((f) => f.trim())
+			.filter((f) => f.length > 0);
+	}
+	return [];
+}
+let extractionInstance = null;
+export function getMemoryExtraction() {
+	extractionInstance ??= new MemoryExtractionService();
+	return extractionInstance;
+}
+export function resetMemoryExtraction() {
+	extractionInstance = null;
+}
+//# sourceMappingURL=extraction-service.js.map

package/dist/extraction-service.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Bundled vault memory backend for Valora.
+ *
+ * Registers `'vault'` as a memory provider via `api.memory.register(...)` —
+ * the same API any third-party memory plugin would use. The host bootstraps
+ * this package at startup; user plugins may override via
+ * `manifest.overrides: ['vault']`.
+ */
+import type { MemoryProviderDescriptor, PluginAPI } from '@windagency/valora-plugin-api';
+export declare const VAULT_DESCRIPTOR: MemoryProviderDescriptor;
+export declare function register(api: PluginAPI): void;
+export { parseVaultPluginConfig, VAULT_PLUGIN_CONFIG_SCHEMA, type VaultPluginConfig } from './config-schema.js';
+export {
+	type ConsolidationCompleteListener,
+	type ConsolidationServiceContext,
+	getMemoryConsolidation,
+	MemoryConsolidationService,
+	resetMemoryConsolidation
+} from './consolidation-service.js';
+export { centroidSummary, cosineClusters } from './consolidation/cluster.js';
+export { computeEffectiveHalfLife, computeStrength, shouldPrune } from './decay.js';
+export type { EmbedderPort } from './embeddings/embedder.port.js';
+export { EmbedderNotSupportedError, LlmProviderEmbedder } from './embeddings/llm-provider-embedder.js';
+export { type ProviderLookup, resolveEmbedder } from './embeddings/resolve-embedder.js';
+export { openVectorStore, readVectorStoreMeta, type VectorStore } from './embeddings/vector-store.js';
+export { getMemoryExtraction, MemoryExtractionService, resetMemoryExtraction } from './extraction-service.js';
+export { MemoryManager } from './manager.js';
+export { runAutoMigrationIfNeeded } from './migration/auto-migrate.js';
+export { migrateJsonToVault, type MigrationOptions, type MigrationResult } from './migration/json-to-vault.js';
+export { readVaultVersion, VAULT_SCHEMA_VERSION, writeVaultVersion } from './migration/vault-version.js';
+export { VaultMemoryProvider } from './vault-memory-provider.js';
+/** @deprecated retained for migration paths only — production code uses VaultStore. */
+export { MemoryStore } from './store.js';
+export { getDefaultVaultDir, getLegacyJsonDir } from './vault/default-vault-dir.js';
+export {
+	computeContentHash,
+	type ParsedMemoryFile,
+	parseMemoryFile,
+	serialiseMemoryFile
+} from './vault/file-format.js';
+export { openVaultStore, type VaultStats, VaultStore } from './vault/vault-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAIzF,eAAO,MAAM,gBAAgB,EAAE,wBAI9B,CAAC;AAEF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAE7C;AAKD,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEhH,OAAO,EACN,KAAK,6BAA6B,EAClC,KAAK,2BAA2B,EAChC,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACpF,YAAY,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACvG,OAAO,EAAE,KAAK,cAAc,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACtG,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC9G,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/G,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEzG,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,uFAAuF;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,EACN,kBAAkB,EAClB,KAAK,gBAAgB,EACrB,eAAe,EACf,mBAAmB,EACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}