@theihtisham/agent-shadow-brain 5.2.0 → 6.0.2

package/dist/brain/brain-reflex.js

@@ -0,0 +1,364 @@
+// src/brain/brain-reflex.ts — Local-model inline completion service
+// v6.0.2 — Multimodal Edition
+//
+// "Cursor Tab, but from your brain — locally, free."
+//
+// Pulls the top brain memories for the current prefix, then asks a small local
+// model (Ollama qwen2.5-coder:1.5b / deepseek-coder:1.3b) to continue the code.
+// If Ollama is unavailable, falls back to brain-only mode: prepends the top
+// memory verbatim with a "// Suggested from brain memory" prefix.
+//
+// Exposed: complete(), streamComplete(), precache()
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const STATS_DIR = path.join(os.homedir(), '.shadow-brain', 'reflex');
+const STATS_PATH = path.join(STATS_DIR, 'stats.jsonl');
+const OLLAMA_DEFAULT = 'http://127.0.0.1:11434';
+const PREFERRED_MODELS = ['qwen2.5-coder:1.5b', 'qwen2.5-coder', 'deepseek-coder:1.3b', 'deepseek-coder'];
+const DEFAULT_MAX_TOKENS = 96;
+export class BrainReflex {
+    constructor() {
+        this.ollamaUrl = OLLAMA_DEFAULT;
+        this.ollamaModel = null;
+        this.probed = false;
+        this.precachedMemories = [];
+        this.cacheHits = 0;
+        this.cacheMisses = 0;
+    }
+    /** One-shot completion. */
+    async complete(context, opts = {}) {
+        const start = Date.now();
+        const maxTokens = opts.maxTokens ?? DEFAULT_MAX_TOKENS;
+        const useOllama = opts.useOllama !== false;
+        const memories = await this.fetchMemories(context);
+        const usedCache = memories.length > 0 && this.precachedMemories.length > 0;
+        if (usedCache)
+            this.cacheHits++;
+        else
+            this.cacheMisses++;
+        if (useOllama) {
+            await this.probeOllama();
+            if (this.ollamaModel) {
+                const prompt = this.buildPrompt(context, memories);
+                const text = await this.callOllama(prompt, maxTokens).catch(() => null);
+                if (text && text.trim().length) {
+                    const result = {
+                        completion: cleanCompletion(text),
+                        source: memories.length ? 'hybrid' : 'ollama',
+                        latencyMs: Date.now() - start,
+                        citations: memories.map(m => m.id),
+                    };
+                    await this.logStat(context, result, maxTokens);
+                    return result;
+                }
+            }
+        }
+        // Brain-only fallback
+        const fallback = this.brainOnlyCompletion(context, memories);
+        const result = {
+            completion: fallback,
+            source: 'brain',
+            latencyMs: Date.now() - start,
+            citations: memories.map(m => m.id),
+        };
+        await this.logStat(context, result, maxTokens);
+        return result;
+    }
+    /** Streaming completion. Yields tokens as they arrive. */
+    async *streamComplete(context, opts = {}) {
+        const maxTokens = opts.maxTokens ?? DEFAULT_MAX_TOKENS;
+        const useOllama = opts.useOllama !== false;
+        const memories = await this.fetchMemories(context);
+        if (useOllama) {
+            await this.probeOllama();
+            if (this.ollamaModel) {
+                const prompt = this.buildPrompt(context, memories);
+                try {
+                    for await (const chunk of this.streamOllama(prompt, maxTokens)) {
+                        yield { delta: chunk, done: false };
+                    }
+                    yield { delta: '', done: true };
+                    return;
+                }
+                catch { /* fall through */ }
+            }
+        }
+        // Fallback — emit the brain-only completion in one shot
+        const fallback = this.brainOnlyCompletion(context, memories);
+        const chunks = fallback.match(/.{1,32}/gs) ?? [fallback];
+        for (const c of chunks)
+            yield { delta: c, done: false };
+        yield { delta: '', done: true };
+    }
+    /** Warm up the brain's relevant memories before a session starts. */
+    async precache(project, files) {
+        const start = Date.now();
+        const seeds = [];
+        for (const f of files.slice(0, 24)) {
+            try {
+                const full = path.isAbsolute(f) ? f : path.join(project, f);
+                if (fs.existsSync(full)) {
+                    const buf = fs.readFileSync(full, 'utf-8');
+                    seeds.push(buf.slice(0, 800));
+                }
+            }
+            catch { /* skip */ }
+        }
+        if (seeds.length === 0)
+            seeds.push(project);
+        const aggregate = [];
+        for (const seed of seeds) {
+            const mems = await this.recallFromBrain(seed, project).catch(() => []);
+            for (const m of mems) {
+                if (!aggregate.find(a => a.id === m.id))
+                    aggregate.push(m);
+            }
+            if (aggregate.length >= 24)
+                break;
+        }
+        this.precachedMemories = aggregate;
+        return { cached: aggregate.length, durationMs: Date.now() - start };
+    }
+    /** Stats accessor — for telemetry. */
+    getStats() {
+        return {
+            cacheHits: this.cacheHits,
+            cacheMisses: this.cacheMisses,
+            precachedCount: this.precachedMemories.length,
+            ollamaModel: this.ollamaModel,
+        };
+    }
+    // ── Internals ────────────────────────────────────────────────────────────
+    async fetchMemories(context) {
+        // Prefer precached when prefix is small (high signal-to-noise from a seed)
+        if (this.precachedMemories.length && context.prefix.length < 200) {
+            return this.precachedMemories.slice(0, 5);
+        }
+        const seed = (context.fileName ? context.fileName + '\n' : '') + context.prefix.slice(-1500);
+        return this.recallFromBrain(seed, context.project ?? '').catch(() => []);
+    }
+    async recallFromBrain(seed, project) {
+        // Prefer embeddings-v2 if available, then embeddings, then hierarchical-memory search
+        const ev2 = await tryImport('./embeddings-v2.js');
+        if (ev2 && typeof ev2.getEmbeddingsV2 === 'function') {
+            const inst = ev2.getEmbeddingsV2();
+            const candidates = await this.candidatePool(project);
+            if (candidates.length && typeof inst.semanticSearch === 'function') {
+                const ranked = await inst.semanticSearch(seed, candidates, 5).catch(() => null);
+                if (Array.isArray(ranked) && ranked.length) {
+                    const map = new Map(candidates.map((c) => [c.id, c.text]));
+                    return ranked.map((r) => ({ id: r.id, text: String(map.get(r.id) ?? ''), score: r.score ?? 0 }));
+                }
+            }
+        }
+        const ev1 = await tryImport('./embeddings.js');
+        if (ev1 && typeof ev1.getEmbeddings === 'function') {
+            const inst = ev1.getEmbeddings();
+            const candidates = await this.candidatePool(project);
+            if (candidates.length && typeof inst.semanticSearch === 'function') {
+                const ranked = await inst.semanticSearch(seed, candidates, 5).catch(() => null);
+                if (Array.isArray(ranked) && ranked.length) {
+                    const map = new Map(candidates.map((c) => [c.id, c.text]));
+                    return ranked.map((r) => ({ id: r.id, text: String(map.get(r.id) ?? ''), score: r.score ?? 0 }));
+                }
+            }
+        }
+        const hm = await tryImport('./hierarchical-memory.js');
+        if (hm && typeof hm.getHierarchicalMemory === 'function') {
+            const inst = hm.getHierarchicalMemory();
+            if (typeof inst.search === 'function') {
+                const results = await inst.search({ query: seed, project, limit: 5 }).catch(() => null);
+                if (Array.isArray(results) && results.length) {
+                    return results.map((r, idx) => ({
+                        id: String(r.id ?? r.memoryId ?? `mem_${idx}`),
+                        text: String(r.snippet ?? r.content ?? r.text ?? ''),
+                        score: typeof r.score === 'number' ? r.score : 0,
+                    }));
+                }
+            }
+        }
+        return [];
+    }
+    async candidatePool(project) {
+        const hm = await tryImport('./hierarchical-memory.js');
+        if (!hm || typeof hm.getHierarchicalMemory !== 'function')
+            return [];
+        const inst = hm.getHierarchicalMemory();
+        if (typeof inst.list === 'function') {
+            const items = await inst.list({ project, limit: 200 }).catch(() => null);
+            if (Array.isArray(items)) {
+                return items.map((it, idx) => ({
+                    id: String(it.id ?? it.memoryId ?? `mem_${idx}`),
+                    text: String(it.snippet ?? it.content ?? it.text ?? ''),
+                }));
+            }
+        }
+        return [];
+    }
+    buildPrompt(context, memories) {
+        const lang = context.language ? `Language: ${context.language}\n` : '';
+        const file = context.fileName ? `File: ${context.fileName}\n` : '';
+        const memBlock = memories.length
+            ? memories.map((m, idx) => `[mem ${idx + 1} ${m.id}]\n${truncate(m.text, 400)}`).join('\n\n')
+            : '(no relevant memories — use idiomatic style)';
+        return [
+            'Continue the following code. Use these conventions from this codebase:',
+            '',
+            memBlock,
+            '',
+            lang + file + 'Code:',
+            context.prefix,
+            'Completion:',
+        ].join('\n');
+    }
+    async probeOllama() {
+        if (this.probed)
+            return;
+        this.probed = true;
+        try {
+            const reg = await tryImport('./model-registry.js');
+            if (reg && typeof reg.getModelRegistry === 'function') {
+                const r = reg.getModelRegistry();
+                await r.init?.();
+                const ollama = r.getProvider?.('ollama');
+                if (ollama?.enabled && ollama.baseUrl)
+                    this.ollamaUrl = ollama.baseUrl;
+            }
+        }
+        catch { /* keep default url */ }
+        try {
+            const res = await fetch(this.ollamaUrl + '/api/tags', { signal: AbortSignal.timeout(2000) });
+            if (!res.ok)
+                return;
+            const json = await res.json();
+            for (const pref of PREFERRED_MODELS) {
+                const match = json.models?.find(m => m.name.startsWith(pref));
+                if (match) {
+                    this.ollamaModel = match.name;
+                    return;
+                }
+            }
+        }
+        catch { /* no ollama */ }
+    }
+    async callOllama(prompt, maxTokens) {
+        try {
+            const res = await fetch(this.ollamaUrl + '/api/generate', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    model: this.ollamaModel,
+                    prompt,
+                    stream: false,
+                    options: { num_predict: maxTokens, temperature: 0.2, stop: ['\nCompletion:', '\n\n\n'] },
+                }),
+                signal: AbortSignal.timeout(20000),
+            });
+            if (!res.ok)
+                return null;
+            const json = await res.json();
+            return json.response ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async *streamOllama(prompt, maxTokens) {
+        const res = await fetch(this.ollamaUrl + '/api/generate', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                model: this.ollamaModel,
+                prompt,
+                stream: true,
+                options: { num_predict: maxTokens, temperature: 0.2, stop: ['\nCompletion:', '\n\n\n'] },
+            }),
+            signal: AbortSignal.timeout(30000),
+        });
+        if (!res.ok || !res.body)
+            return;
+        const reader = res.body.getReader();
+        const dec = new TextDecoder();
+        let buffer = '';
+        while (true) {
+            const { value, done } = await reader.read();
+            if (done)
+                break;
+            buffer += dec.decode(value, { stream: true });
+            let nl = buffer.indexOf('\n');
+            while (nl !== -1) {
+                const line = buffer.slice(0, nl).trim();
+                buffer = buffer.slice(nl + 1);
+                nl = buffer.indexOf('\n');
+                if (!line)
+                    continue;
+                try {
+                    const json = JSON.parse(line);
+                    if (json.response)
+                        yield json.response;
+                    if (json.done)
+                        return;
+                }
+                catch { /* skip malformed line */ }
+            }
+        }
+    }
+    brainOnlyCompletion(context, memories) {
+        if (memories.length === 0) {
+            return '// Suggested from brain memory: no relevant memories cached. Run precache() first or write more brain entries.';
+        }
+        const top = memories[0];
+        const snippet = truncate(top.text, 480);
+        const cite = ` (mem: ${top.id})`;
+        return `// Suggested from brain memory${cite}\n// ${snippet.split('\n').join('\n// ')}`;
+    }
+    async logStat(context, result, maxTokens) {
+        try {
+            fs.mkdirSync(STATS_DIR, { recursive: true });
+            const line = JSON.stringify({
+                ts: new Date().toISOString(),
+                project: context.project ?? null,
+                fileName: context.fileName ?? null,
+                language: context.language ?? null,
+                prefixLen: context.prefix.length,
+                completionLen: result.completion.length,
+                source: result.source,
+                latencyMs: result.latencyMs,
+                citationCount: result.citations.length,
+                maxTokens,
+                ollamaModel: this.ollamaModel,
+                cacheHits: this.cacheHits,
+                cacheMisses: this.cacheMisses,
+            }) + '\n';
+            fs.appendFileSync(STATS_PATH, line);
+        }
+        catch { /* non-fatal */ }
+    }
+}
+// ── Helpers ───────────────────────────────────────────────────────────────
+function truncate(s, n) {
+    if (!s)
+        return '';
+    return s.length <= n ? s : s.slice(0, n) + '…';
+}
+function cleanCompletion(s) {
+    // Trim Ollama's stop-token bleed and leading whitespace artifacts
+    return s.replace(/^\s*Completion:\s*/i, '').replace(/\n*Completion:\s*$/i, '').trimEnd();
+}
+async function tryImport(spec) {
+    try {
+        return await import(spec).catch(() => null);
+    }
+    catch {
+        return null;
+    }
+}
+let _instance = null;
+export function getBrainReflex() {
+    if (!_instance)
+        _instance = new BrainReflex();
+    return _instance;
+}
+export function resetBrainReflexForTests() { _instance = null; }
+//# sourceMappingURL=brain-reflex.js.map

package/dist/brain/brain-reflex.js.map

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

package/dist/brain/brain-replay.d.ts

@@ -0,0 +1,74 @@
+import { GlobalBrain } from './global-brain.js';
+export interface ReplayEvent {
+    type: string;
+    payload: unknown;
+    ts: number;
+    project: string;
+    agent?: string;
+}
+export interface ReplayFrame {
+    ts: number;
+    eventCount: number;
+    memoryCount: number;
+    entityCount: number;
+    topEntities: string[];
+    deltaFromPrevious: {
+        added: number;
+        modified: number;
+        decayed: number;
+    };
+    healthScore?: number;
+}
+export interface ReplayTimeline {
+    project: string;
+    frames: ReplayFrame[];
+    totalEvents: number;
+    firstEventAt: number | null;
+    lastEventAt: number | null;
+}
+export declare class BrainReplay {
+    private brain;
+    constructor(brain?: GlobalBrain);
+    /** Append an event to the per-project log. */
+    record(event: {
+        type: string;
+        payload: unknown;
+        ts?: number;
+        project?: string;
+        agent?: string;
+    }): void;
+    /** Read all events for a project as a timeline of frames (downsampled). */
+    getTimeline(project: string, opts?: {
+        from?: number;
+        to?: number;
+        types?: string[];
+    }): ReplayFrame[];
+    /** Return the brain state as it would have appeared at exactly `ts`. */
+    frameAt(project: string, ts: number): ReplayFrame;
+    /** Compact old events into snapshots + diff chains; keeps file size bounded. */
+    compress(project: string): {
+        kept: number;
+        archived: number;
+    };
+    /** Export as JSONL string, CSV string, or SVG Buffer. */
+    export(project: string, format: 'jsonl' | 'csv' | 'svg'): string | Buffer;
+    /** Get the raw event list (used by Brain DNA + tests). */
+    listEvents(project: string, opts?: {
+        from?: number;
+        to?: number;
+        types?: string[];
+    }): ReplayEvent[];
+    private fileFor;
+    private projectHash;
+    private readEvents;
+    private buildFrame;
+    private entityKeyOf;
+    private estimateHealth;
+    private emptyFrame;
+    private renderSvg;
+    private emptySvg;
+    private findMilestones;
+}
+export declare function getBrainReplay(): BrainReplay;
+export declare function resetBrainReplayForTests(): void;
+//# sourceMappingURL=brain-replay.d.ts.map

package/dist/brain/brain-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-replay.d.ts","sourceRoot":"","sources":["../../src/brain/brain-replay.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAkB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAc;gBAEf,KAAK,CAAC,EAAE,WAAW;IAK/B,8CAA8C;IAC9C,MAAM,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAetG,2EAA2E;IAC3E,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,WAAW,EAAE;IA4BxG,wEAAwE;IACxE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW;IAOjD,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IA6B7D,yDAAyD;IACzD,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM;IAgBzE,0DAA0D;IAC1D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;KAAO,GAAG,WAAW,EAAE;IAMvG,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,UAAU;IAqClB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,SAAS;IAuFjB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,cAAc;CAsBvB;AAOD,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AACD,wBAAgB,wBAAwB,IAAI,IAAI,CAAsB"}