@theihtisham/agent-shadow-brain 5.1.1 → 6.0.0

package/dist/brain/dream-engine.js

@@ -0,0 +1,273 @@
+// src/brain/dream-engine.ts — Dream Engine (background reflection)
+// v6.0.0 — Hive Mind Edition
+//
+// LLMs are always reactive. Shadow Brain is the first dev tool with a
+// REFLECTIVE IDLE LOOP. When no agent is active for `idleThresholdMs`, the
+// Dream Engine wakes up and:
+//   - Re-reads recent decisions with fresh context
+//   - Runs counterfactual analysis ("what if X instead of Y?")
+//   - Strengthens validated patterns, weakens falsified ones
+//   - Drops "dream insights" into the brain, flagged for next session
+//
+// Uses Local LLM (Ollama) by default — 100% local, free, offline-capable.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+import { getGlobalBrain } from './global-brain.js';
+import { getLocalLLM } from './local-llm.js';
+import { getModelRegistry } from './model-registry.js';
+import { generateJson, z } from './json-output.js';
+const DREAMS_PATH = path.join(os.homedir(), '.shadow-brain', 'dreams.json');
+const DEFAULT_CONFIG = {
+    enabled: true,
+    idleThresholdMs: 5 * 60 * 1000,
+    maxDreamsPerCycle: 5,
+    useLocalLLM: true,
+    dreamIntervalMs: 10 * 60 * 1000,
+};
+function emptyStats() {
+    return {
+        totalDreams: 0,
+        byType: { revisit: 0, counterfactual: 0, consolidation: 0, contradiction: 0, 'pattern-discovery': 0 },
+        avgConfidence: 0,
+        actionableCount: 0,
+        acknowledgedCount: 0,
+        lastDreamAt: null,
+        totalDreamTimeMs: 0,
+    };
+}
+export class DreamEngine {
+    constructor(opts = {}) {
+        this.dreams = new Map();
+        this.stats = emptyStats();
+        this.lastActivityAt = Date.now();
+        this.cycleTimer = null;
+        this.initialized = false;
+        this.brain = getGlobalBrain();
+        this.llm = getLocalLLM();
+        this.config = { ...DEFAULT_CONFIG, ...opts };
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(path.dirname(DREAMS_PATH), { recursive: true });
+        await this.brain.init();
+        if (fs.existsSync(DREAMS_PATH)) {
+            try {
+                const raw = fs.readFileSync(DREAMS_PATH, 'utf-8');
+                const parsed = JSON.parse(raw);
+                for (const d of parsed.dreams ?? []) {
+                    this.dreams.set(d.id, { ...d, generatedAt: new Date(d.generatedAt) });
+                }
+                if (parsed.stats) {
+                    this.stats = {
+                        ...emptyStats(),
+                        ...parsed.stats,
+                        lastDreamAt: parsed.stats.lastDreamAt ? new Date(parsed.stats.lastDreamAt) : null,
+                    };
+                }
+                this.lastActivityAt = parsed.lastActivityAt ?? Date.now();
+            }
+            catch {
+                /* corrupt — fresh */
+            }
+        }
+        this.initialized = true;
+    }
+    /** Record that SOMETHING happened (agent activity). Resets idle timer. */
+    noteActivity() {
+        this.lastActivityAt = Date.now();
+    }
+    /** Start background reflection loop. Safe to call once; no-op if already running. */
+    async start() {
+        await this.init();
+        if (!this.config.enabled)
+            return;
+        if (this.cycleTimer)
+            return;
+        this.cycleTimer = setInterval(() => this.tick().catch(() => { }), this.config.dreamIntervalMs);
+        // Avoid preventing the process from exiting
+        this.cycleTimer.unref?.();
+    }
+    async stop() {
+        if (this.cycleTimer)
+            clearInterval(this.cycleTimer);
+        this.cycleTimer = null;
+        await this.persist();
+    }
+    /** Run a single reflection pass. Exposed for tests + manual triggering. */
+    async dreamOnce() {
+        await this.init();
+        const since = Date.now() - this.config.idleThresholdMs;
+        if (Date.now() - this.lastActivityAt < this.config.idleThresholdMs) {
+            return []; // not idle yet
+        }
+        const start = Date.now();
+        const recent = this.brain.recall({ limit: 40 });
+        if (recent.length < 3)
+            return [];
+        void since;
+        const newDreams = [];
+        const available = await this.llm.isAvailable();
+        for (const type of ['revisit', 'counterfactual', 'consolidation', 'contradiction', 'pattern-discovery']) {
+            if (newDreams.length >= this.config.maxDreamsPerCycle)
+                break;
+            const dream = await this.generate(type, recent, available);
+            if (dream) {
+                this.dreams.set(dream.id, dream);
+                this.stats.totalDreams++;
+                this.stats.byType[type]++;
+                if (dream.actOnNextSession)
+                    this.stats.actionableCount++;
+                const n = this.stats.totalDreams;
+                this.stats.avgConfidence = this.stats.avgConfidence + (dream.confidence - this.stats.avgConfidence) / n;
+                newDreams.push(dream);
+            }
+        }
+        this.stats.lastDreamAt = new Date();
+        this.stats.totalDreamTimeMs += Date.now() - start;
+        await this.persist();
+        return newDreams;
+    }
+    listDreams(opts = {}) {
+        const all = Array.from(this.dreams.values()).sort((a, b) => b.generatedAt.getTime() - a.generatedAt.getTime());
+        return all
+            .filter(d => !opts.type || d.type === opts.type)
+            .filter(d => !opts.unacknowledgedOnly || !d.acknowledged)
+            .slice(0, opts.limit ?? 20);
+    }
+    async acknowledge(dreamId) {
+        await this.init();
+        const d = this.dreams.get(dreamId);
+        if (!d)
+            return false;
+        d.acknowledged = true;
+        this.stats.acknowledgedCount++;
+        await this.persist();
+        return true;
+    }
+    getStats() {
+        return JSON.parse(JSON.stringify(this.stats));
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    async tick() {
+        if (!this.config.enabled)
+            return;
+        if (Date.now() - this.lastActivityAt < this.config.idleThresholdMs)
+            return;
+        await this.dreamOnce().catch(() => { });
+    }
+    async generate(type, recent, llmAvailable) {
+        const seeds = recent.slice(0, 6);
+        const sourceIds = seeds.map(s => s.id);
+        const bullets = seeds.map((s, i) => `${i + 1}. [${s.category}] ${s.content.slice(0, 160)}`).join('\n');
+        let content;
+        let confidence = 0.55;
+        let actionable = false;
+        // Prefer ModelRegistry (respects user's lead provider + caching) — fall back to LocalLLM
+        const DreamSchema = z.object({
+            content: z.string().min(4).max(900),
+            confidence: z.number().min(0).max(1),
+            actionable: z.boolean().optional(),
+        });
+        try {
+            const registry = getModelRegistry();
+            await registry.init();
+            const intel = registry.getIntelligence();
+            const canUseRegistry = intel.leadProvider !== 'none' && llmAvailable;
+            if (canUseRegistry) {
+                const prompt = this.promptForType(type, bullets) + '\n\nReply as JSON: {"content": "<insight>", "confidence": 0.0-1.0, "actionable": true|false}';
+                const result = await generateJson(prompt, DreamSchema, {
+                    system: 'You are Shadow Brain\'s reflective dream engine. Be terse. Output JSON only.',
+                    featureName: 'dream-engine',
+                    maxTokens: 300,
+                    fallback: { content: this.syntheticDream(type, seeds), confidence: 0.4 },
+                });
+                content = result.value.content.slice(0, 600);
+                confidence = Math.max(0.3, Math.min(1, result.value.confidence));
+                actionable = !!result.value.actionable;
+            }
+            else if (llmAvailable) {
+                // LocalLLM free-text fallback
+                const prompt = this.promptForType(type, bullets);
+                const res = await this.llm.generate(prompt, 'You are a reflective assistant inside Shadow Brain. Speak tersely.');
+                content = res.text.trim();
+                confidence = res.provider === 'none' ? 0.4 : 0.7;
+            }
+            else {
+                content = this.syntheticDream(type, seeds);
+            }
+        }
+        catch {
+            content = this.syntheticDream(type, seeds);
+        }
+        if (!content)
+            return null;
+        return {
+            id: `dream-${crypto.randomBytes(6).toString('hex')}`,
+            type,
+            content: content.slice(0, 600),
+            sourceMemoryIds: sourceIds,
+            confidence,
+            generatedAt: new Date(),
+            actOnNextSession: actionable || (confidence >= 0.6 && (type === 'contradiction' || type === 'pattern-discovery')),
+            acknowledged: false,
+        };
+    }
+    promptForType(type, bullets) {
+        switch (type) {
+            case 'revisit':
+                return `Revisit these recent decisions and note anything you would change with fresh eyes. Reply in two sentences max.\n\n${bullets}`;
+            case 'counterfactual':
+                return `Pick the single riskiest decision below and describe in two sentences a counterfactual — what if we had chosen differently?\n\n${bullets}`;
+            case 'consolidation':
+                return `Extract at most one generalizable pattern from these decisions, in one sentence.\n\n${bullets}`;
+            case 'contradiction':
+                return `Are any of these decisions in tension with each other? If yes, name the tension in two sentences. If no, say "none".\n\n${bullets}`;
+            case 'pattern-discovery':
+                return `Find one repeating theme across these items that could become a project principle. Reply with one short sentence.\n\n${bullets}`;
+        }
+    }
+    syntheticDream(type, seeds) {
+        const cat = seeds[0]?.category ?? 'general';
+        switch (type) {
+            case 'revisit':
+                return `Reviewed ${seeds.length} recent ${cat} decisions; no fresh counter-evidence detected.`;
+            case 'counterfactual':
+                return `Counterfactual on recent ${cat}: the inverse choice would have traded simplicity for control.`;
+            case 'consolidation':
+                return `Recurring ${cat} theme: prefer explicit contracts over implicit state.`;
+            case 'contradiction':
+                return `No hard contradictions found across recent ${cat} decisions.`;
+            case 'pattern-discovery':
+                return `Emerging ${cat} principle: invariants belong at the edges, not the middle.`;
+        }
+    }
+    async persist() {
+        try {
+            const payload = {
+                schemaVersion: 1,
+                dreams: Array.from(this.dreams.values()),
+                stats: this.stats,
+                lastActivityAt: this.lastActivityAt,
+            };
+            const tmp = DREAMS_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(payload, null, 2));
+            fs.renameSync(tmp, DREAMS_PATH);
+        }
+        catch {
+            /* non-fatal */
+        }
+    }
+}
+let _instance = null;
+export function getDreamEngine(opts) {
+    if (!_instance)
+        _instance = new DreamEngine(opts);
+    return _instance;
+}
+export function resetDreamEngineForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=dream-engine.js.map

package/dist/brain/dream-engine.js.map

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

package/dist/brain/embeddings.d.ts

@@ -0,0 +1,27 @@
+export declare class Embeddings {
+    private cache;
+    private ollamaModel;
+    private ollamaBaseUrl;
+    private initialized;
+    init(): Promise<void>;
+    /** Embed a string — returns a unit-norm vector. Uses cache when available. */
+    embed(text: string): Promise<number[]>;
+    /** Cosine similarity between two same-length vectors (L2-normalized assumed). */
+    static cosine(a: number[], b: number[]): number;
+    /** Rank candidates by cosine similarity to the query embedding. */
+    semanticSearch(query: string, candidates: Array<{
+        id: string;
+        text: string;
+    }>, topK?: number): Promise<Array<{
+        id: string;
+        score: number;
+    }>>;
+    flush(): Promise<void>;
+    private embedOllama;
+    /** Zero-dep local embedding: char tri-grams → hashed bag → dim 128 → TF weighting → L2 normalize. */
+    private embedLocal;
+    private persist;
+}
+export declare function getEmbeddings(): Embeddings;
+export declare function resetEmbeddingsForTests(): void;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/brain/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../src/brain/embeddings.ts"],"names":[],"mappings":"AAqBA,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,WAAW,CAAS;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC3B,8EAA8E;IACxE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAe5C,iFAAiF;IACjF,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAO/C,mEAAmE;IAC7D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,IAAI,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAYxI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,WAAW;IAezB,qGAAqG;IACrG,OAAO,CAAC,UAAU;YAqBJ,OAAO;CAYtB;AAeD,wBAAgB,aAAa,IAAI,UAAU,CAG1C;AACD,wBAAgB,uBAAuB,IAAI,IAAI,CAAsB"}

package/dist/brain/embeddings.js

@@ -0,0 +1,175 @@
+// src/brain/embeddings.ts — Lightweight embeddings + semantic search
+// v6.0.0 — Hive Mind Edition
+//
+// Uses a local hashing-based embedding (tfidf + char n-grams) for zero-dep
+// semantic recall. If Ollama is available with an embedding model
+// (nomic-embed-text, mxbai-embed-large, all-minilm), upgrades to real
+// dense embeddings automatically.
+//
+// Exposed: embed(text), cosineSim(a,b), semanticSearch(query, candidates)
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { getModelRegistry } from './model-registry.js';
+const CACHE_DIR = path.join(os.homedir(), '.shadow-brain', 'embeddings');
+const CACHE_PATH = path.join(CACHE_DIR, 'vectors.json');
+const EMB_DIM = 128;
+export class Embeddings {
+    constructor() {
+        this.cache = new Map();
+        this.ollamaModel = null;
+        this.ollamaBaseUrl = 'http://127.0.0.1:11434';
+        this.initialized = false;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(CACHE_DIR, { recursive: true });
+        if (fs.existsSync(CACHE_PATH)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(CACHE_PATH, 'utf-8'));
+                for (const [k, v] of Object.entries(parsed.vectors ?? {}))
+                    this.cache.set(k, v);
+            }
+            catch { /* skip */ }
+        }
+        // Probe for Ollama embedding model
+        try {
+            const reg = getModelRegistry();
+            await reg.init();
+            const ollama = reg.getProvider('ollama');
+            if (ollama?.enabled) {
+                this.ollamaBaseUrl = ollama.baseUrl;
+                const res = await fetch(this.ollamaBaseUrl + '/api/tags', { signal: AbortSignal.timeout(2000) });
+                if (res.ok) {
+                    const json = await res.json();
+                    const preferred = ['nomic-embed-text', 'mxbai-embed-large', 'all-minilm'];
+                    for (const pref of preferred) {
+                        const match = json.models?.find(m => m.name.startsWith(pref));
+                        if (match) {
+                            this.ollamaModel = match.name;
+                            break;
+                        }
+                    }
+                }
+            }
+        }
+        catch { /* no ollama */ }
+        this.initialized = true;
+    }
+    /** Embed a string — returns a unit-norm vector. Uses cache when available. */
+    async embed(text) {
+        await this.init();
+        const trimmed = (text || '').slice(0, 8000);
+        const cached = this.cache.get(trimmed);
+        if (cached)
+            return cached;
+        let vec = null;
+        if (this.ollamaModel)
+            vec = await this.embedOllama(trimmed).catch(() => null);
+        if (!vec)
+            vec = this.embedLocal(trimmed);
+        this.cache.set(trimmed, vec);
+        if (this.cache.size % 25 === 0)
+            this.persist().catch(() => { });
+        return vec;
+    }
+    /** Cosine similarity between two same-length vectors (L2-normalized assumed). */
+    static cosine(a, b) {
+        let dot = 0;
+        const n = Math.min(a.length, b.length);
+        for (let i = 0; i < n; i++)
+            dot += a[i] * b[i];
+        return dot;
+    }
+    /** Rank candidates by cosine similarity to the query embedding. */
+    async semanticSearch(query, candidates, topK = 20) {
+        await this.init();
+        const q = await this.embed(query);
+        const scored = [];
+        for (const c of candidates) {
+            const v = await this.embed(c.text);
+            scored.push({ id: c.id, score: Embeddings.cosine(q, v) });
+        }
+        scored.sort((a, b) => b.score - a.score);
+        return scored.slice(0, topK);
+    }
+    async flush() { await this.persist(); }
+    // ── Internals ─────────────────────────────────────────────────────────
+    async embedOllama(text) {
+        try {
+            const res = await fetch(this.ollamaBaseUrl + '/api/embeddings', {
+                method: 'POST', headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ model: this.ollamaModel, prompt: text }),
+                signal: AbortSignal.timeout(30000),
+            });
+            if (!res.ok)
+                return null;
+            const json = await res.json();
+            if (!json.embedding || !json.embedding.length)
+                return null;
+            // L2 normalize
+            return normalize(json.embedding);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Zero-dep local embedding: char tri-grams → hashed bag → dim 128 → TF weighting → L2 normalize. */
+    embedLocal(text) {
+        const vec = new Array(EMB_DIM).fill(0);
+        const norm = text.toLowerCase().replace(/[^a-z0-9\s]/g, ' ');
+        // word unigrams
+        const tokens = norm.split(/\s+/).filter(t => t.length > 1);
+        const stopwords = new Set(['the', 'a', 'an', 'and', 'or', 'of', 'to', 'for', 'in', 'on', 'is', 'it', 'this', 'that', 'as', 'by', 'be', 'do']);
+        for (const t of tokens) {
+            if (stopwords.has(t))
+                continue;
+            const h = hash32(t) % EMB_DIM;
+            vec[h] += 1 + Math.log(t.length);
+        }
+        // char tri-grams for fuzzy matching
+        for (let i = 0; i <= norm.length - 3; i++) {
+            const tri = norm.slice(i, i + 3);
+            if (!/\S/.test(tri))
+                continue;
+            const h = (hash32(tri) * 17) % EMB_DIM;
+            vec[h] += 0.3;
+        }
+        return normalize(vec);
+    }
+    async persist() {
+        try {
+            const shape = {
+                schemaVersion: 1,
+                vectors: Object.fromEntries(this.cache.entries()),
+                lastProvider: this.ollamaModel ? 'ollama' : 'local',
+            };
+            const tmp = CACHE_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(shape));
+            fs.renameSync(tmp, CACHE_PATH);
+        }
+        catch { /* non-fatal */ }
+    }
+}
+function hash32(s) {
+    let h = 2166136261;
+    for (let i = 0; i < s.length; i++)
+        h = Math.imul(h ^ s.charCodeAt(i), 16777619);
+    return h >>> 0;
+}
+function normalize(v) {
+    let n = 0;
+    for (const x of v)
+        n += x * x;
+    n = Math.sqrt(n) || 1;
+    return v.map(x => x / n);
+}
+let _instance = null;
+export function getEmbeddings() {
+    if (!_instance)
+        _instance = new Embeddings();
+    return _instance;
+}
+export function resetEmbeddingsForTests() { _instance = null; }
+//# sourceMappingURL=embeddings.js.map

package/dist/brain/embeddings.js.map

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

package/dist/brain/forgetting-curve.d.ts

@@ -0,0 +1,21 @@
+import { ConsolidationReport, ForgettingState, MemoryTier } from '../types.js';
+export declare class ForgettingCurve {
+    private states;
+    private reports;
+    private cycleCount;
+    private initialized;
+    init(): Promise<void>;
+    track(memoryId: string, initialStrength?: number, consolidatedTier?: MemoryTier): Promise<ForgettingState>;
+    reinforce(memoryId: string, strengthBoost?: number): Promise<ForgettingState | null>;
+    /** Run a consolidation sleep cycle. Returns a report of changes. */
+    runConsolidation(): Promise<ConsolidationReport>;
+    getState(memoryId: string): ForgettingState | null;
+    listStates(limit?: number): ForgettingState[];
+    listReports(limit?: number): ConsolidationReport[];
+    private tierForStrength;
+    private tierRank;
+    private persist;
+}
+export declare function getForgettingCurve(): ForgettingCurve;
+export declare function resetForgettingCurveForTests(): void;
+//# sourceMappingURL=forgetting-curve.d.ts.map

package/dist/brain/forgetting-curve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgetting-curve.d.ts","sourceRoot":"","sources":["../../src/brain/forgetting-curve.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,UAAU,EACX,MAAM,aAAa,CAAC;AAarB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAS;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBrB,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,SAAM,EAAE,gBAAgB,GAAE,UAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkB9G,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,SAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAYvF,oEAAoE;IAC9D,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAgDtD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAIlD,UAAU,CAAC,KAAK,SAAK,GAAG,eAAe,EAAE;IAMzC,WAAW,CAAC,KAAK,SAAK,GAAG,mBAAmB,EAAE;IAM9C,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,QAAQ;YASF,OAAO;CActB;AAID,wBAAgB,kBAAkB,IAAI,eAAe,CAGpD;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}