@project-ava-supernova/core 0.2.71

package/dist/memory/consolidation.d.ts

@@ -0,0 +1,60 @@
+/**
+ * ══════════════════════════════════════════════════════════════════════
+ * Memory Consolidation — Layer 5 (4-Phase Cycle)
+ * ══════════════════════════════════════════════════════════════════════
+ *
+ * Structured consolidation that keeps Ava's memory sharp, not noisy.
+ *
+ * Phase 1: ORIENT  — scan recent sessions, understand what happened
+ * Phase 2: GATHER  — pull relevant patterns, decisions, corrections
+ * Phase 3: CONSOLIDATE — merge duplicates, resolve contradictions
+ * Phase 4: PRUNE   — remove noise, enforce 25KB cap per scope
+ *
+ * Triggers after 24 hours AND at least 5 sessions — doesn't waste
+ * cycles on a quick one-off interaction.
+ *
+ * A certain well-funded AI lab had a similar system called "autoDream"
+ * hidden behind a feature flag in code they accidentally published to
+ * npm. Ours ships in the open. No flags. No accidents. Just memory
+ * that actually works. Thanks for the validation, lads. 🫡
+ *
+ * ══════════════════════════════════════════════════════════════════════
+ */
+import type { MemoryManager } from './memory-manager.js';
+export interface ConsolidationReport {
+    phase: 'orient' | 'gather' | 'consolidate' | 'prune' | 'complete' | 'skipped';
+    merged: number;
+    contradictionsRemoved: number;
+    staleTagged: number;
+    pruned: number;
+    totalProcessed: number;
+    memorySizeBefore: number;
+    memorySizeAfter: number;
+    runAt: string;
+    reason?: string;
+}
+export interface ConsolidationState {
+    lastRunAt: string | null;
+    sessionsSinceLastRun: number;
+}
+/**
+ * Record a session — call this at the end of each meaningful interaction.
+ * The consolidation cycle triggers based on session count + time.
+ */
+export declare function recordSession(globalDir: string): Promise<void>;
+/**
+ * Check if consolidation should run based on dual trigger:
+ * - At least 24 hours since last run
+ * - At least 5 sessions since last run
+ */
+export declare function shouldConsolidate(globalDir: string): Promise<boolean>;
+/**
+ * Run the full 4-phase consolidation cycle.
+ *
+ * Phase 1: ORIENT  — load and assess current memory state
+ * Phase 2: GATHER  — identify merge candidates, contradictions, stale entries
+ * Phase 3: CONSOLIDATE — execute merges and contradiction resolution
+ * Phase 4: PRUNE   — enforce 25KB cap, archive old stale entries
+ */
+export declare function runConsolidation(memoryManager: MemoryManager, globalDir?: string): Promise<ConsolidationReport>;
+//# sourceMappingURL=consolidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation.d.ts","sourceRoot":"","sources":["../../src/memory/consolidation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAmBzD,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAyCD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIpE;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ3E;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,aAAa,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,mBAAmB,CAAC,CA0K9B"}

package/dist/memory/consolidation.js

@@ -0,0 +1,311 @@
+/**
+ * ══════════════════════════════════════════════════════════════════════
+ * Memory Consolidation — Layer 5 (4-Phase Cycle)
+ * ══════════════════════════════════════════════════════════════════════
+ *
+ * Structured consolidation that keeps Ava's memory sharp, not noisy.
+ *
+ * Phase 1: ORIENT  — scan recent sessions, understand what happened
+ * Phase 2: GATHER  — pull relevant patterns, decisions, corrections
+ * Phase 3: CONSOLIDATE — merge duplicates, resolve contradictions
+ * Phase 4: PRUNE   — remove noise, enforce 25KB cap per scope
+ *
+ * Triggers after 24 hours AND at least 5 sessions — doesn't waste
+ * cycles on a quick one-off interaction.
+ *
+ * A certain well-funded AI lab had a similar system called "autoDream"
+ * hidden behind a feature flag in code they accidentally published to
+ * npm. Ours ships in the open. No flags. No accidents. Just memory
+ * that actually works. Thanks for the validation, lads. 🫡
+ *
+ * ══════════════════════════════════════════════════════════════════════
+ */
+import { avaEvents } from '../dataset/emitter.js';
+import { TfIdfIndex } from './tfidf.js';
+import { logger } from '../core/logger.js';
+// ── Configuration ─────────────────────────────────────────────────────
+import { MAX_STORE_SIZE_BYTES as MAX_MEMORY_SIZE_BYTES, CONSOLIDATION_INTERVAL_HOURS, CONSOLIDATION_MIN_SESSIONS as MIN_SESSIONS_SINCE_LAST, MERGE_THRESHOLD as MERGE_SIMILARITY_THRESHOLD, STALE_DAYS, AUTO_ARCHIVE_DAYS, } from './config.js';
+const MIN_CONSOLIDATION_INTERVAL_MS = CONSOLIDATION_INTERVAL_HOURS * 60 * 60 * 1000;
+// ── Contradiction Patterns ────────────────────────────────────────────
+const CONTRADICTION_PAIRS = [
+    [/\bprefers?\s+tabs\b/i, /\bprefers?\s+spaces\b/i],
+    [/\bprefers?\s+single\s+quotes\b/i, /\bprefers?\s+double\s+quotes\b/i],
+    [/\bprefers?\s+semicolons\b/i, /\bno\s+semicolons\b/i],
+    [/\bprefers?\s+camelCase\b/i, /\bprefers?\s+snake_case\b/i],
+    [/\bprefers?\s+const\b/i, /\bprefers?\s+let\b/i],
+    [/\bprefers?\s+arrow\s+functions?\b/i, /\bprefers?\s+regular\s+functions?\b/i],
+    [/\bprefers?\s+async\/await\b/i, /\bprefers?\s+promises\b/i],
+    [/\bprefers?\s+type\b/i, /\bprefers?\s+interface\b/i],
+    [/\buse\s+npm\b/i, /\buse\s+(?:pnpm|yarn)\b/i],
+];
+// ── State Management ──────────────────────────────────────────────────
+const STATE_FILE = 'consolidation-state.json';
+async function loadState(globalDir) {
+    try {
+        const { readFile } = await import('node:fs/promises');
+        const { join } = await import('node:path');
+        const raw = await readFile(join(globalDir, STATE_FILE), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return { lastRunAt: null, sessionsSinceLastRun: 0 };
+    }
+}
+async function saveState(globalDir, state) {
+    try {
+        const { writeFile } = await import('node:fs/promises');
+        const { join } = await import('node:path');
+        await writeFile(join(globalDir, STATE_FILE), JSON.stringify(state, null, 2), 'utf-8');
+    }
+    catch { /* non-critical */ }
+}
+// ── Public API ────────────────────────────────────────────────────────
+/**
+ * Record a session — call this at the end of each meaningful interaction.
+ * The consolidation cycle triggers based on session count + time.
+ */
+export async function recordSession(globalDir) {
+    const state = await loadState(globalDir);
+    state.sessionsSinceLastRun++;
+    await saveState(globalDir, state);
+}
+/**
+ * Check if consolidation should run based on dual trigger:
+ * - At least 24 hours since last run
+ * - At least 5 sessions since last run
+ */
+export async function shouldConsolidate(globalDir) {
+    const state = await loadState(globalDir);
+    // Never run before — always consolidate
+    if (!state.lastRunAt)
+        return state.sessionsSinceLastRun >= MIN_SESSIONS_SINCE_LAST;
+    const timeSince = Date.now() - new Date(state.lastRunAt).getTime();
+    return timeSince >= MIN_CONSOLIDATION_INTERVAL_MS && state.sessionsSinceLastRun >= MIN_SESSIONS_SINCE_LAST;
+}
+/**
+ * Run the full 4-phase consolidation cycle.
+ *
+ * Phase 1: ORIENT  — load and assess current memory state
+ * Phase 2: GATHER  — identify merge candidates, contradictions, stale entries
+ * Phase 3: CONSOLIDATE — execute merges and contradiction resolution
+ * Phase 4: PRUNE   — enforce 25KB cap, archive old stale entries
+ */
+export async function runConsolidation(memoryManager, globalDir) {
+    const report = {
+        phase: 'orient',
+        merged: 0,
+        contradictionsRemoved: 0,
+        staleTagged: 0,
+        pruned: 0,
+        totalProcessed: 0,
+        memorySizeBefore: 0,
+        memorySizeAfter: 0,
+        runAt: new Date().toISOString(),
+    };
+    try {
+        for (const scope of ['global', 'project']) {
+            const entries = await memoryManager.getEntries(scope);
+            const active = entries.filter(e => !e.archived);
+            if (active.length < 2)
+                continue;
+            report.totalProcessed += active.length;
+            report.memorySizeBefore += measureSize(active);
+            // ── Phase 1: ORIENT ───────────────────────────────────────
+            report.phase = 'orient';
+            logger.debug(`[consolidation] Phase 1 ORIENT: ${active.length} active memories in ${scope} (${formatBytes(measureSize(active))})`);
+            const index = new TfIdfIndex();
+            for (const entry of active) {
+                index.addDocument(entry.id, entry.content);
+            }
+            const byCategory = new Map();
+            for (const entry of active) {
+                const list = byCategory.get(entry.category) ?? [];
+                list.push(entry);
+                byCategory.set(entry.category, list);
+            }
+            // ── Phase 2: GATHER ───────────────────────────────────────
+            report.phase = 'gather';
+            logger.debug(`[consolidation] Phase 2 GATHER: scanning ${byCategory.size} categories for duplicates and contradictions`);
+            // Identify merge candidates
+            const mergePairs = [];
+            const merged = new Set();
+            for (const [, categoryEntries] of byCategory) {
+                if (categoryEntries.length < 2)
+                    continue;
+                for (let i = 0; i < categoryEntries.length; i++) {
+                    const entry = categoryEntries[i];
+                    if (merged.has(entry.id))
+                        continue;
+                    const similar = index.findSimilar(entry.id, MERGE_SIMILARITY_THRESHOLD);
+                    for (const { id: similarId } of similar) {
+                        if (merged.has(similarId))
+                            continue;
+                        const other = categoryEntries.find(e => e.id === similarId);
+                        if (!other)
+                            continue;
+                        mergePairs.push([entry, other]);
+                        merged.add(similarId);
+                    }
+                }
+            }
+            // ── Phase 3: CONSOLIDATE ──────────────────────────────────
+            report.phase = 'consolidate';
+            logger.debug(`[consolidation] Phase 3 CONSOLIDATE: ${mergePairs.length} merge pairs, checking contradictions`);
+            // Execute merges
+            for (const [a, b] of mergePairs) {
+                const aTime = new Date(a.updatedAt).getTime();
+                const bTime = new Date(b.updatedAt).getTime();
+                const [keeper, older] = aTime >= bTime ? [a, b] : [b, a];
+                const mergedContent = mergeMemoryContent(keeper.content, older.content);
+                if (mergedContent !== keeper.content) {
+                    await memoryManager.updateEntry(scope, keeper.id, { content: mergedContent });
+                }
+                await memoryManager.deleteEntry(scope, older.id);
+                report.merged++;
+            }
+            // Resolve contradictions
+            const postMerge = (await memoryManager.getEntries(scope)).filter(e => !e.archived);
+            report.contradictionsRemoved += await resolveContradictions(postMerge, memoryManager, scope);
+            // Tag stale
+            const postContradiction = (await memoryManager.getEntries(scope)).filter(e => !e.archived);
+            report.staleTagged += await tagStaleMemories(postContradiction, memoryManager, scope);
+            // ── Phase 4: PRUNE ────────────────────────────────────────
+            report.phase = 'prune';
+            const postConsolidate = (await memoryManager.getEntries(scope)).filter(e => !e.archived);
+            const currentSize = measureSize(postConsolidate);
+            logger.debug(`[consolidation] Phase 4 PRUNE: ${postConsolidate.length} memories, ${formatBytes(currentSize)} (cap: ${formatBytes(MAX_MEMORY_SIZE_BYTES)})`);
+            // Auto-archive very old stale memories
+            for (const entry of postConsolidate) {
+                if (!entry.tags?.includes('stale'))
+                    continue;
+                const lastActivity = entry.lastRecalledAt ?? entry.updatedAt ?? entry.createdAt;
+                const daysSince = (Date.now() - new Date(lastActivity).getTime()) / (1000 * 60 * 60 * 24);
+                if (daysSince > AUTO_ARCHIVE_DAYS) {
+                    await memoryManager.archiveEntry(scope, entry.id);
+                    report.pruned++;
+                }
+            }
+            // If still over 25KB, prune least-recalled entries
+            if (currentSize > MAX_MEMORY_SIZE_BYTES) {
+                const remaining = (await memoryManager.getEntries(scope)).filter(e => !e.archived);
+                const sorted = [...remaining].sort((a, b) => {
+                    const aScore = (a.recallCount ?? 0) + (a.lastRecalledAt ? 1 : 0);
+                    const bScore = (b.recallCount ?? 0) + (b.lastRecalledAt ? 1 : 0);
+                    return aScore - bScore; // Least recalled first
+                });
+                let size = measureSize(sorted);
+                while (size > MAX_MEMORY_SIZE_BYTES && sorted.length > 5) {
+                    const victim = sorted.shift();
+                    await memoryManager.archiveEntry(scope, victim.id);
+                    size -= victim.content.length;
+                    report.pruned++;
+                }
+            }
+            // Measure final size
+            const final = (await memoryManager.getEntries(scope)).filter(e => !e.archived);
+            report.memorySizeAfter += measureSize(final);
+        }
+        report.phase = 'complete';
+        if (report.merged > 0 || report.contradictionsRemoved > 0 || report.pruned > 0) {
+            logger.info(`[consolidation] Complete: merged ${report.merged}, contradictions ${report.contradictionsRemoved}, ` +
+                `stale ${report.staleTagged}, pruned ${report.pruned} | ` +
+                `${formatBytes(report.memorySizeBefore)} → ${formatBytes(report.memorySizeAfter)}`);
+        }
+        // ── Dataset events ───────────────────────────────────────────────────
+        // Background memory consolidation is itself an Ava decision pass
+        // (which duplicates to merge, what to prune). Emit aggregated events
+        // so the dataset captures the outcome of each consolidation run
+        // alongside the per-entry memory_update / memory_save events that
+        // fire from inside the merge calls. Only emit when there's actually
+        // something to report — empty consolidations would be noise.
+        if (report.merged > 0 || report.contradictionsRemoved > 0) {
+            avaEvents.emit('memory_consolidation', {
+                count_before: Math.max(report.totalProcessed, 0),
+                count_after: Math.max(report.totalProcessed - report.merged - report.contradictionsRemoved, 0),
+                scope: 'global',
+            });
+        }
+        if (report.pruned > 0) {
+            avaEvents.emit('memory_forget', {
+                count_forgotten: report.pruned,
+                reason: 'age',
+            });
+        }
+        // Update state
+        if (globalDir) {
+            await saveState(globalDir, { lastRunAt: report.runAt, sessionsSinceLastRun: 0 });
+        }
+        return report;
+    }
+    catch (err) {
+        logger.debug(`[consolidation] Failed at phase ${report.phase}: ${err}`);
+        return report;
+    }
+}
+// ── Helpers ───────────────────────────────────────────────────────────
+function measureSize(entries) {
+    return entries.reduce((sum, e) => sum + e.content.length, 0);
+}
+function formatBytes(bytes) {
+    if (bytes >= 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${bytes}B`;
+}
+function mergeMemoryContent(primary, secondary) {
+    if (secondary.length < 10 || primary.toLowerCase().includes(secondary.toLowerCase())) {
+        return primary;
+    }
+    if (secondary.toLowerCase().includes(primary.toLowerCase())) {
+        return secondary;
+    }
+    const primaryWords = new Set(primary.toLowerCase().split(/\s+/));
+    const secondaryWords = secondary.split(/\s+/);
+    const uniqueWords = secondaryWords.filter(w => !primaryWords.has(w.toLowerCase()));
+    if (uniqueWords.length < secondaryWords.length * 0.2) {
+        return primary;
+    }
+    const supplement = secondary.length > 150 ? secondary.slice(0, 150) + '...' : secondary;
+    return `${primary} (also: ${supplement})`;
+}
+async function resolveContradictions(entries, memoryManager, scope) {
+    let removed = 0;
+    for (let i = 0; i < entries.length; i++) {
+        for (let j = i + 1; j < entries.length; j++) {
+            const a = entries[i];
+            const b = entries[j];
+            if (a.archived || b.archived)
+                continue;
+            const contradicts = CONTRADICTION_PAIRS.some(([patA, patB]) => (patA.test(a.content) && patB.test(b.content)) ||
+                (patB.test(a.content) && patA.test(b.content)));
+            if (contradicts) {
+                const aTime = new Date(a.updatedAt).getTime();
+                const bTime = new Date(b.updatedAt).getTime();
+                const [, loser] = aTime >= bTime ? [a, b] : [b, a];
+                await memoryManager.deleteEntry(scope, loser.id);
+                loser.archived = true;
+                removed++;
+                logger.debug(`[consolidation] Contradiction resolved: removed "${loser.content.slice(0, 60)}..."`);
+            }
+        }
+    }
+    return removed;
+}
+async function tagStaleMemories(entries, memoryManager, scope) {
+    const now = Date.now();
+    let tagged = 0;
+    for (const entry of entries) {
+        if (entry.archived || entry.tags?.includes('stale'))
+            continue;
+        const lastActivity = entry.lastRecalledAt ?? entry.updatedAt ?? entry.createdAt;
+        const daysSince = (now - new Date(lastActivity).getTime()) / (1000 * 60 * 60 * 24);
+        if (daysSince > STALE_DAYS) {
+            const existingTags = entry.tags ?? [];
+            await memoryManager.updateEntry(scope, entry.id, {
+                tags: [...existingTags, 'stale'],
+            });
+            tagged++;
+        }
+    }
+    return tagged;
+}
+//# sourceMappingURL=consolidation.js.map

package/dist/memory/consolidation.js.map

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

package/dist/memory/embedding-service.d.ts

@@ -0,0 +1,50 @@
+import type { Provider } from '../providers/types.js';
+export interface EmbeddingServiceOptions {
+    provider: Provider;
+    /** Embedding model id, e.g. 'nomic-embed-text'. */
+    model: string;
+    /** Per-call timeout (ms). A local embed should be fast; cap it so a hung
+     *  endpoint can't stall a background backfill. Default 10s. */
+    timeoutMs?: number;
+    /** Circuit-breaker cooldown (ms) after a failure — fast-fail to null during
+     *  this window so we don't hammer a down Ollama. Default 30s. */
+    cooldownMs?: number;
+}
+/**
+ * Thin wrapper over a provider's optional `createEmbedding`. Returns `null` on
+ * ANY failure (Ollama down, model missing, provider without embeddings) so
+ * callers degrade to TF-IDF — semantic recall is a quality boost, never a hard
+ * requirement. A circuit breaker keeps a down endpoint from stalling writes or
+ * the backfill: after one failure, subsequent calls fast-fail for `cooldownMs`.
+ */
+export declare class EmbeddingService {
+    private readonly provider;
+    private readonly model;
+    private readonly timeoutMs;
+    private readonly cooldownMs;
+    private downUntil;
+    constructor(opts: EmbeddingServiceOptions);
+    get embedModel(): string;
+    /** True if the breaker is currently open (endpoint recently failed). Callers
+     *  like the backfill can poll this to back off without issuing more calls. */
+    get tripped(): boolean;
+    /**
+     * Embed a single text. Returns the vector, or `null` if embeddings are
+     * unavailable / failed. Never throws.
+     */
+    embed(text: string, signal?: AbortSignal): Promise<number[] | null>;
+    private withTimeout;
+}
+/**
+ * Build an EmbeddingService from user preferences. Returns undefined when
+ * `useLocalEmbeddings` is off (the default) — so recall stays pure TF-IDF with
+ * no external dependency. When on, points a GenericProvider at the local
+ * Ollama (OpenAI-compatible) `/v1/embeddings` endpoint. Shared by every surface
+ * so the wiring is identical (CLI / extension / IDE sidecar).
+ */
+export declare function createEmbeddingServiceFromConfig(prefs?: {
+    useLocalEmbeddings?: boolean;
+    embeddingModel?: string;
+    embeddingBaseUrl?: string;
+}): EmbeddingService | undefined;
+//# sourceMappingURL=embedding-service.d.ts.map

package/dist/memory/embedding-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-service.d.ts","sourceRoot":"","sources":["../../src/memory/embedding-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAOtD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd;mEAC+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;qEACiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,SAAS,CAAK;gBAEV,IAAI,EAAE,uBAAuB;IAOzC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;kFAC8E;IAC9E,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;OAGG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;IAwBzE,OAAO,CAAC,WAAW;CAMpB;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,KAAK,CAAC,EAAE;IACvD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,GAAG,gBAAgB,GAAG,SAAS,CAU/B"}

package/dist/memory/embedding-service.js

@@ -0,0 +1,86 @@
+import { GenericProvider } from '../providers/generic/index.js';
+import { logger } from '../core/logger.js';
+const DEFAULT_EMBED_MODEL = 'nomic-embed-text';
+const DEFAULT_EMBED_BASE_URL = 'http://localhost:11434/v1'; // Ollama (OpenAI-compat)
+/**
+ * Thin wrapper over a provider's optional `createEmbedding`. Returns `null` on
+ * ANY failure (Ollama down, model missing, provider without embeddings) so
+ * callers degrade to TF-IDF — semantic recall is a quality boost, never a hard
+ * requirement. A circuit breaker keeps a down endpoint from stalling writes or
+ * the backfill: after one failure, subsequent calls fast-fail for `cooldownMs`.
+ */
+export class EmbeddingService {
+    provider;
+    model;
+    timeoutMs;
+    cooldownMs;
+    downUntil = 0; // epoch ms; while Date.now() < downUntil, fast-fail
+    constructor(opts) {
+        this.provider = opts.provider;
+        this.model = opts.model;
+        this.timeoutMs = opts.timeoutMs ?? 10_000;
+        this.cooldownMs = opts.cooldownMs ?? 30_000;
+    }
+    get embedModel() {
+        return this.model;
+    }
+    /** True if the breaker is currently open (endpoint recently failed). Callers
+     *  like the backfill can poll this to back off without issuing more calls. */
+    get tripped() {
+        return Date.now() < this.downUntil;
+    }
+    /**
+     * Embed a single text. Returns the vector, or `null` if embeddings are
+     * unavailable / failed. Never throws.
+     */
+    async embed(text, signal) {
+        if (!this.provider.createEmbedding)
+            return null;
+        const trimmed = text?.trim();
+        if (!trimmed)
+            return null;
+        if (Date.now() < this.downUntil)
+            return null; // breaker open — fast-fail
+        try {
+            const vec = await this.withTimeout(this.provider.createEmbedding(trimmed.slice(0, 8000), this.model, signal), this.timeoutMs);
+            if (!Array.isArray(vec) || vec.length === 0)
+                throw new Error('empty vector');
+            return vec;
+        }
+        catch (err) {
+            // Open the breaker so the next calls fast-fail instead of retrying a
+            // down endpoint. Log once per trip, at debug — never user-facing.
+            if (!this.tripped) {
+                logger.debug(`[embeddings] embed failed, degrading to TF-IDF for ${this.cooldownMs}ms: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            this.downUntil = Date.now() + this.cooldownMs;
+            return null;
+        }
+    }
+    withTimeout(p, ms) {
+        return Promise.race([
+            p,
+            new Promise((_, reject) => setTimeout(() => reject(new Error('embed timeout')), ms)),
+        ]);
+    }
+}
+/**
+ * Build an EmbeddingService from user preferences. Returns undefined when
+ * `useLocalEmbeddings` is off (the default) — so recall stays pure TF-IDF with
+ * no external dependency. When on, points a GenericProvider at the local
+ * Ollama (OpenAI-compatible) `/v1/embeddings` endpoint. Shared by every surface
+ * so the wiring is identical (CLI / extension / IDE sidecar).
+ */
+export function createEmbeddingServiceFromConfig(prefs) {
+    if (!prefs?.useLocalEmbeddings)
+        return undefined;
+    const provider = new GenericProvider({
+        apiKey: '',
+        baseUrl: prefs.embeddingBaseUrl ?? DEFAULT_EMBED_BASE_URL,
+    });
+    return new EmbeddingService({
+        provider,
+        model: prefs.embeddingModel ?? DEFAULT_EMBED_MODEL,
+    });
+}
+//# sourceMappingURL=embedding-service.js.map

package/dist/memory/embedding-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-service.js","sourceRoot":"","sources":["../../src/memory/embedding-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAC/C,MAAM,sBAAsB,GAAG,2BAA2B,CAAC,CAAC,yBAAyB;AAcrF;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACV,QAAQ,CAAW;IACnB,KAAK,CAAS;IACd,SAAS,CAAS;IAClB,UAAU,CAAS;IAC5B,SAAS,GAAG,CAAC,CAAC,CAAC,oDAAoD;IAE3E,YAAY,IAA6B;QACvC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC;IAC9C,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;kFAC8E;IAC9E,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,MAAoB;QAC5C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe;YAAE,OAAO,IAAI,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,CAAC,2BAA2B;QAEzE,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,WAAW,CAChC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,EACzE,IAAI,CAAC,SAAS,CACf,CAAC;YACF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;YAC7E,OAAO,GAAG,CAAC;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,qEAAqE;YACrE,kEAAkE;YAClE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,CAAC,KAAK,CAAC,sDAAsD,IAAI,CAAC,UAAU,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/I,CAAC;YACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,WAAW,CAAI,CAAa,EAAE,EAAU;QAC9C,OAAO,OAAO,CAAC,IAAI,CAAC;YAClB,CAAC;YACD,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;SACxF,CAAC,CAAC;IACL,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gCAAgC,CAAC,KAIhD;IACC,IAAI,CAAC,KAAK,EAAE,kBAAkB;QAAE,OAAO,SAAS,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC;QACnC,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,KAAK,CAAC,gBAAgB,IAAI,sBAAsB;KAC1D,CAAC,CAAC;IACH,OAAO,IAAI,gBAAgB,CAAC;QAC1B,QAAQ;QACR,KAAK,EAAE,KAAK,CAAC,cAAc,IAAI,mBAAmB;KACnD,CAAC,CAAC;AACL,CAAC"}

package/dist/memory/embedding-store.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Per-scope embedding store, persisted to `embeddings.json` ALONGSIDE (not
+ * inside) `graph.json`. Keeping vectors out of the graph means the 32MB graph
+ * isn't bloated to ~74MB and its frequent saves stay fast. Vectors are
+ * regenerable (the backfill rebuilds on corruption / model change), so a plain
+ * atomic write is enough — no locking.
+ */
+export declare class EmbeddingStore {
+    private readonly filePath;
+    private readonly tmpPath;
+    private readonly model;
+    private data;
+    private loaded;
+    private dirty;
+    private saveTimer;
+    constructor(memDir: string, model: string);
+    load(): Promise<void>;
+    has(nodeId: string): boolean;
+    get(nodeId: string): number[] | undefined;
+    set(nodeId: string, vec: number[]): void;
+    delete(nodeId: string): void;
+    /** Set of node ids that already have a vector — the backfill diffs against this. */
+    embeddedIds(): Set<string>;
+    get size(): number;
+    get dim(): number;
+    private scheduleSave;
+    save(): Promise<void>;
+    /** Flush any pending debounced write immediately (backfill batches, shutdown). */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=embedding-store.d.ts.map

package/dist/memory/embedding-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedding-store.d.ts","sourceRoot":"","sources":["../../src/memory/embedding-store.ts"],"names":[],"mappings":"AAkBA;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,IAAI,CAAkF;IAC9F,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAA8C;gBAEnD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAOnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB3B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAI5B,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS;IAIzC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAOxC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQ5B,oFAAoF;IACpF,WAAW,IAAI,GAAG,CAAC,MAAM,CAAC;IAI1B,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED,OAAO,CAAC,YAAY;IAWd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,kFAAkF;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}