@theihtisham/agent-shadow-brain 5.1.1 → 5.2.0

package/dist/brain/global-brain.js

@@ -0,0 +1,324 @@
+// src/brain/global-brain.ts — Singleton Global Brain (v5.2.0)
+//
+// One brain. Every project. Every agent. Every machine.
+//
+// The Global Brain is a singleton store at ~/.shadow-brain/global.json that
+// every Shadow Brain instance reads from and writes to. Insights from project
+// A using Cursor are immediately available to project B using Claude Code.
+//
+// Storage: append-friendly JSON store (no native deps), persisted on every
+// flush. Combined with l0-cache.ts, hot recalls return in <1ms.
+//
+// Concurrency: write queue + atomic file replace prevents conflicts when
+// multiple agents write simultaneously.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+const DEFAULT_DIR = path.join(os.homedir(), '.shadow-brain');
+const DEFAULT_DB_PATH = path.join(DEFAULT_DIR, 'global.json');
+const DEFAULT_CONFIG = {
+    dbPath: DEFAULT_DB_PATH,
+    walMode: true,
+    writeQueueSize: 1000,
+    autoVacuumMB: 500,
+    autoPruneMB: 1000,
+    syncIntervalMs: 5000,
+};
+/**
+ * Singleton Global Brain — the source of truth for all projects + agents.
+ *
+ * Storage: JSON file at ~/.shadow-brain/global.json (zero new deps).
+ * In-memory Map keyed by entry.id for O(1) ID lookups.
+ */
+export class GlobalBrain {
+    constructor(config = {}) {
+        this.entries = new Map();
+        this.projects = new Map();
+        this.agents = new Map();
+        this.writeQueue = [];
+        this.syncTimer = null;
+        this.initialized = false;
+        this.dirty = false;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.startedAt = Date.now();
+        this.stats = {
+            totalProjects: 0,
+            totalAgents: 0,
+            totalEntries: 0,
+            totalSizeMB: 0,
+            pendingWrites: 0,
+            hits: 0,
+            misses: 0,
+            hitRate: 0,
+            lastSync: new Date(),
+            lastVacuum: null,
+            lastPrune: null,
+            uptime: 0,
+        };
+    }
+    static getInstance(config) {
+        if (!GlobalBrain.instance) {
+            GlobalBrain.instance = new GlobalBrain(config);
+        }
+        return GlobalBrain.instance;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(path.dirname(this.config.dbPath), { recursive: true });
+        if (fs.existsSync(this.config.dbPath)) {
+            try {
+                const raw = fs.readFileSync(this.config.dbPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                for (const e of parsed.entries ?? []) {
+                    // Re-hydrate Date instances
+                    this.entries.set(e.id, {
+                        ...e,
+                        createdAt: new Date(e.createdAt),
+                        lastAccessed: new Date(e.lastAccessed),
+                    });
+                }
+                for (const p of parsed.projects ?? [])
+                    this.projects.set(p.id, p);
+                for (const a of parsed.agents ?? [])
+                    this.agents.set(a.tool, a);
+            }
+            catch {
+                // Corrupted file → start fresh, back up the bad one
+                try {
+                    fs.renameSync(this.config.dbPath, this.config.dbPath + '.corrupt-' + Date.now());
+                }
+                catch { /* ignore */ }
+            }
+        }
+        this.startSyncLoop();
+        this.refreshStats();
+        this.initialized = true;
+    }
+    /** Generate a stable project ID from absolute path */
+    static projectIdFor(rootDir) {
+        const abs = path.resolve(rootDir);
+        return crypto.createHash('sha1').update(abs).digest('hex').slice(0, 16);
+    }
+    registerProject(rootDir, name) {
+        if (!this.initialized)
+            throw new Error('GlobalBrain not initialized — call init() first');
+        const id = GlobalBrain.projectIdFor(rootDir);
+        const projectName = name || path.basename(rootDir);
+        const now = Date.now();
+        const existing = this.projects.get(id);
+        this.projects.set(id, {
+            id,
+            name: projectName,
+            rootDir: path.resolve(rootDir),
+            firstSeen: existing?.firstSeen ?? now,
+            lastSeen: now,
+        });
+        this.dirty = true;
+        return id;
+    }
+    registerAgent(agent) {
+        if (!this.initialized)
+            return;
+        const now = Date.now();
+        const existing = this.agents.get(agent);
+        this.agents.set(agent, {
+            tool: agent,
+            firstSeen: existing?.firstSeen ?? now,
+            lastSeen: now,
+            sessionCount: (existing?.sessionCount ?? 0) + 1,
+        });
+        this.dirty = true;
+    }
+    /** Queue a write — resolves true on success */
+    async write(entry) {
+        if (!this.initialized)
+            await this.init();
+        const fullEntry = {
+            ...entry,
+            id: crypto.randomUUID(),
+            createdAt: new Date(),
+            lastAccessed: new Date(),
+            accessCount: 0,
+        };
+        if (this.writeQueue.length >= this.config.writeQueueSize) {
+            return false;
+        }
+        return new Promise((resolve) => {
+            this.writeQueue.push({ entry: fullEntry, resolve });
+        });
+    }
+    /** Direct synchronous write — bypasses queue */
+    writeSync(entry) {
+        if (!this.initialized)
+            throw new Error('GlobalBrain not initialized');
+        const id = crypto.randomUUID();
+        const fullEntry = {
+            ...entry,
+            id,
+            createdAt: new Date(),
+            lastAccessed: new Date(),
+            accessCount: 0,
+        };
+        this.entries.set(id, fullEntry);
+        this.dirty = true;
+        this.stats.totalEntries = this.entries.size;
+        return id;
+    }
+    /** Recall entries — cross-project + cross-agent */
+    recall(opts = {}) {
+        if (!this.initialized)
+            return [];
+        const limit = opts.limit ?? 20;
+        const minImp = opts.minImportance ?? 0;
+        const kwLower = opts.keywords?.map(k => k.toLowerCase()) ?? null;
+        const matches = [];
+        for (const e of this.entries.values()) {
+            if (opts.projectId && e.projectId !== opts.projectId)
+                continue;
+            if (opts.agentTool && e.agentTool !== opts.agentTool)
+                continue;
+            if (opts.category && e.category !== opts.category)
+                continue;
+            if (e.importance < minImp)
+                continue;
+            if (kwLower) {
+                const hay = e.content.toLowerCase();
+                if (!kwLower.some(k => hay.includes(k)))
+                    continue;
+            }
+            matches.push(e);
+        }
+        matches.sort((a, b) => {
+            if (b.importance !== a.importance)
+                return b.importance - a.importance;
+            return b.lastAccessed.getTime() - a.lastAccessed.getTime();
+        });
+        const result = matches.slice(0, limit);
+        if (result.length)
+            this.stats.hits++;
+        else
+            this.stats.misses++;
+        return result;
+    }
+    /** Bump access count for an entry */
+    touch(id) {
+        const entry = this.entries.get(id);
+        if (!entry)
+            return;
+        entry.accessCount++;
+        entry.lastAccessed = new Date();
+        this.dirty = true;
+    }
+    recallByIds(ids) {
+        const out = [];
+        for (const id of ids) {
+            const e = this.entries.get(id);
+            if (e)
+                out.push(e);
+        }
+        return out;
+    }
+    getStats() {
+        this.refreshStats();
+        return { ...this.stats };
+    }
+    /** Force a sync of pending writes to disk */
+    async sync() {
+        if (!this.initialized)
+            return;
+        if (this.writeQueue.length > 0) {
+            const pending = this.writeQueue.splice(0, this.writeQueue.length);
+            for (const { entry, resolve } of pending) {
+                try {
+                    this.entries.set(entry.id, entry);
+                    resolve(true);
+                }
+                catch {
+                    resolve(false);
+                }
+            }
+            this.dirty = true;
+        }
+        if (this.dirty) {
+            this.persist();
+            this.stats.lastSync = new Date();
+            this.dirty = false;
+        }
+        this.maybeAutoMaintenance();
+    }
+    maybeAutoMaintenance() {
+        const sizeMB = this.estimateSizeMB();
+        this.stats.totalSizeMB = sizeMB;
+        if (sizeMB > this.config.autoPruneMB)
+            this.prune();
+    }
+    /** Auto-prune: drop low-importance, rarely-accessed entries when over threshold */
+    prune() {
+        const cutoff = Date.now() - 90 * 24 * 60 * 60 * 1000; // 90 days
+        const toDelete = [];
+        for (const [id, e] of this.entries) {
+            if (e.importance < 0.3 && e.accessCount < 2 && e.lastAccessed.getTime() < cutoff) {
+                toDelete.push(id);
+            }
+        }
+        for (const id of toDelete)
+            this.entries.delete(id);
+        if (toDelete.length) {
+            this.dirty = true;
+            this.stats.lastPrune = new Date();
+        }
+    }
+    persist() {
+        const shape = {
+            schemaVersion: 1,
+            entries: Array.from(this.entries.values()),
+            projects: Array.from(this.projects.values()),
+            agents: Array.from(this.agents.values()),
+        };
+        // Atomic write — write to .tmp then rename
+        const tmp = this.config.dbPath + '.tmp';
+        fs.writeFileSync(tmp, JSON.stringify(shape));
+        fs.renameSync(tmp, this.config.dbPath);
+    }
+    startSyncLoop() {
+        if (this.syncTimer)
+            clearInterval(this.syncTimer);
+        this.syncTimer = setInterval(() => {
+            this.sync().catch(() => { });
+        }, this.config.syncIntervalMs);
+    }
+    refreshStats() {
+        if (!this.initialized)
+            return;
+        this.stats.totalProjects = this.projects.size;
+        this.stats.totalAgents = this.agents.size;
+        this.stats.totalEntries = this.entries.size;
+        this.stats.pendingWrites = this.writeQueue.length;
+        const totalChecks = this.stats.hits + this.stats.misses;
+        this.stats.hitRate = totalChecks > 0 ? this.stats.hits / totalChecks : 0;
+        this.stats.uptime = Date.now() - this.startedAt;
+    }
+    estimateSizeMB() {
+        try {
+            const stat = fs.statSync(this.config.dbPath);
+            return stat.size / (1024 * 1024);
+        }
+        catch {
+            return 0;
+        }
+    }
+    async shutdown() {
+        if (this.syncTimer)
+            clearInterval(this.syncTimer);
+        await this.sync();
+        this.initialized = false;
+        GlobalBrain.instance = null;
+    }
+}
+GlobalBrain.instance = null;
+export function getGlobalBrain(config) {
+    return GlobalBrain.getInstance(config);
+}
+//# sourceMappingURL=global-brain.js.map

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

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

package/dist/brain/l0-cache.d.ts

@@ -0,0 +1,40 @@
+import { L0CacheEntry, L0CacheStats } from '../types.js';
+export interface L0CacheOptions {
+    bytesLimit?: number;
+    /** Estimate bytes for a value when computing budget */
+    byteEstimator?: (value: unknown) => number;
+}
+/** Generic L0 cache. Construct one per logical namespace (recall, vectors, etc.) */
+export declare class L0Cache<T = unknown> {
+    private map;
+    private bytesUsed;
+    private bytesLimit;
+    private byteEstimator;
+    private hits;
+    private misses;
+    private evictions;
+    private accessTimingsNs;
+    constructor(opts?: L0CacheOptions);
+    /** Get a value from the cache — sub-microsecond on hit */
+    get(key: string): T | undefined;
+    /** Set a value — evicts LRU entries if over budget */
+    set(key: string, value: T): void;
+    /** Check existence without touching LRU */
+    has(key: string): boolean;
+    /** Remove a single entry */
+    delete(key: string): boolean;
+    /** Clear all entries */
+    clear(): void;
+    /** Get cache stats */
+    getStats(): L0CacheStats;
+    /** Iterate entries (for warm-restart persistence) */
+    entries(): IterableIterator<[string, L0CacheEntry<T>]>;
+    /** Resize the byte budget — evicts if shrinking */
+    resize(newBytesLimit: number): void;
+    private evictOldest;
+    private recordTiming;
+}
+export declare function getCache<T = unknown>(namespace: string, opts?: L0CacheOptions): L0Cache<T>;
+export declare function getAllCacheStats(): Record<string, L0CacheStats>;
+export declare function clearAllCaches(): void;
+//# sourceMappingURL=l0-cache.d.ts.map

package/dist/brain/l0-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"l0-cache.d.ts","sourceRoot":"","sources":["../../src/brain/l0-cache.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzD,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CAC5C;AAgBD,oFAAoF;AACpF,qBAAa,OAAO,CAAC,CAAC,GAAG,OAAO;IAC9B,OAAO,CAAC,GAAG,CAA2C;IACtD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAA6B;IAElD,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAAgB;gBAE3B,IAAI,GAAE,cAAmB;IAKrC,0DAA0D;IAC1D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAqB/B,sDAAsD;IACtD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IA4BhC,2CAA2C;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,4BAA4B;IAC5B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAO5B,wBAAwB;IACxB,KAAK,IAAI,IAAI;IAKb,sBAAsB;IACtB,QAAQ,IAAI,YAAY;IAyBxB,qDAAqD;IACrD,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAItD,mDAAmD;IACnD,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAOnC,OAAO,CAAC,WAAW;IAUnB,OAAO,CAAC,YAAY;CAOrB;AAKD,wBAAgB,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAO1F;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAM/D;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/brain/l0-cache.js

@@ -0,0 +1,176 @@
+// src/brain/l0-cache.ts — L0 In-Memory Hot Tier (v5.2.0)
+//
+// Sub-millisecond recall for the hottest brain entries. Sits in front of the
+// global SQLite brain. Map-based, LRU-evicted, byte-budget-bounded.
+//
+// Design:
+//   - Pure JavaScript Map (insertion-ordered → easy LRU)
+//   - Byte budget (default 64MB) prevents memory bloat
+//   - Tracks hit/miss for adaptive prefetch decisions
+//   - Auto-evict least-recently-accessed when budget exceeded
+const DEFAULT_BYTES_LIMIT = 64 * 1024 * 1024; // 64MB
+/** Default byte estimator — works for strings, objects, arrays */
+function defaultByteEstimator(value) {
+    if (value == null)
+        return 8;
+    if (typeof value === 'string')
+        return value.length * 2;
+    if (typeof value === 'number')
+        return 8;
+    if (typeof value === 'boolean')
+        return 4;
+    if (value instanceof Uint8Array)
+        return value.byteLength;
+    try {
+        return JSON.stringify(value).length * 2;
+    }
+    catch {
+        return 64;
+    }
+}
+/** Generic L0 cache. Construct one per logical namespace (recall, vectors, etc.) */
+export class L0Cache {
+    constructor(opts = {}) {
+        this.map = new Map();
+        this.bytesUsed = 0;
+        this.hits = 0;
+        this.misses = 0;
+        this.evictions = 0;
+        this.accessTimingsNs = [];
+        this.bytesLimit = opts.bytesLimit ?? DEFAULT_BYTES_LIMIT;
+        this.byteEstimator = opts.byteEstimator ?? defaultByteEstimator;
+    }
+    /** Get a value from the cache — sub-microsecond on hit */
+    get(key) {
+        const start = process.hrtime.bigint();
+        const entry = this.map.get(key);
+        if (!entry) {
+            this.misses++;
+            this.recordTiming(start);
+            return undefined;
+        }
+        // LRU touch — re-insert at end of map
+        this.map.delete(key);
+        entry.hits++;
+        entry.lastAccessed = Date.now();
+        this.map.set(key, entry);
+        this.hits++;
+        this.recordTiming(start);
+        return entry.value;
+    }
+    /** Set a value — evicts LRU entries if over budget */
+    set(key, value) {
+        const bytes = this.byteEstimator(value);
+        // If key already exists, subtract its bytes first
+        const existing = this.map.get(key);
+        if (existing) {
+            this.bytesUsed -= existing.bytes;
+            this.map.delete(key);
+        }
+        // Make room
+        while (this.bytesUsed + bytes > this.bytesLimit && this.map.size > 0) {
+            this.evictOldest();
+        }
+        const entry = {
+            key,
+            value,
+            hits: 0,
+            insertedAt: Date.now(),
+            lastAccessed: Date.now(),
+            bytes,
+        };
+        this.map.set(key, entry);
+        this.bytesUsed += bytes;
+    }
+    /** Check existence without touching LRU */
+    has(key) {
+        return this.map.has(key);
+    }
+    /** Remove a single entry */
+    delete(key) {
+        const entry = this.map.get(key);
+        if (!entry)
+            return false;
+        this.bytesUsed -= entry.bytes;
+        return this.map.delete(key);
+    }
+    /** Clear all entries */
+    clear() {
+        this.map.clear();
+        this.bytesUsed = 0;
+    }
+    /** Get cache stats */
+    getStats() {
+        const total = this.hits + this.misses;
+        const avgAccessNs = this.accessTimingsNs.length
+            ? this.accessTimingsNs.reduce((a, b) => a + b, 0) / this.accessTimingsNs.length
+            : 0;
+        // Top 10 most-hit keys
+        const topKeys = Array.from(this.map.values())
+            .sort((a, b) => b.hits - a.hits)
+            .slice(0, 10)
+            .map(e => ({ key: e.key, hits: e.hits }));
+        return {
+            entries: this.map.size,
+            bytesUsed: this.bytesUsed,
+            bytesLimit: this.bytesLimit,
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: total ? this.hits / total : 0,
+            evictions: this.evictions,
+            avgAccessNs,
+            topKeys,
+        };
+    }
+    /** Iterate entries (for warm-restart persistence) */
+    entries() {
+        return this.map.entries();
+    }
+    /** Resize the byte budget — evicts if shrinking */
+    resize(newBytesLimit) {
+        this.bytesLimit = newBytesLimit;
+        while (this.bytesUsed > this.bytesLimit && this.map.size > 0) {
+            this.evictOldest();
+        }
+    }
+    evictOldest() {
+        // First entry in Map = oldest by insertion (and we re-insert on touch → LRU)
+        const oldest = this.map.keys().next().value;
+        if (oldest === undefined)
+            return;
+        const entry = this.map.get(oldest);
+        if (entry)
+            this.bytesUsed -= entry.bytes;
+        this.map.delete(oldest);
+        this.evictions++;
+    }
+    recordTiming(startNs) {
+        const elapsedNs = Number(process.hrtime.bigint() - startNs);
+        this.accessTimingsNs.push(elapsedNs);
+        if (this.accessTimingsNs.length > 1000) {
+            this.accessTimingsNs.shift();
+        }
+    }
+}
+/** Process-wide singleton caches — one per logical namespace */
+const caches = new Map();
+export function getCache(namespace, opts) {
+    let cache = caches.get(namespace);
+    if (!cache) {
+        cache = new L0Cache(opts);
+        caches.set(namespace, cache);
+    }
+    return cache;
+}
+export function getAllCacheStats() {
+    const out = {};
+    for (const [name, cache] of caches.entries()) {
+        out[name] = cache.getStats();
+    }
+    return out;
+}
+export function clearAllCaches() {
+    for (const cache of caches.values())
+        cache.clear();
+}
+//# sourceMappingURL=l0-cache.js.map

package/dist/brain/l0-cache.js.map

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

package/dist/brain/mcp-server.d.ts

@@ -7,6 +7,10 @@ export declare class MCPServer {
     private lastHealthScore;
     private toolHandlers;
     constructor(orchestrator: any, options?: MCPServerOptions);
+    private handleSubconsciousInject;
+    private handleGlobalRecall;
+    private handleGlobalStats;
+    private handleAttachStatus;
     start(): Promise<void>;
     stop(): Promise<void>;
     handleRequest(request: MCPRequest): Promise<MCPResponse>;

package/dist/brain/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/brain/mcp-server.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAW,gBAAgB,EAAc,MAAM,aAAa,CAAC;AAO7F,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAAwE;gBAEhF,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB;IA8BnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2DtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBrB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAoD9D,OAAO,CAAC,gBAAgB;YAiBV,aAAa;YAgBb,YAAY;YAwBZ,WAAW;YAgBX,aAAa;YAeb,cAAc;YAmBd,UAAU;YAeV,WAAW;YAWX,YAAY;YAkCZ,YAAY;YAsBZ,eAAe;YAyBf,WAAW;YAkBX,WAAW;YAkBX,eAAe;YAkBf,oBAAoB;YAkBpB,aAAa;YAUb,SAAS;YAuCT,YAAY;YAQZ,aAAa;YAgCb,gBAAgB;IAqB9B,OAAO,CAAC,kBAAkB;YA4KZ,oBAAoB;IA2BlC,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;CAGlB"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/brain/mcp-server.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAW,gBAAgB,EAAc,MAAM,aAAa,CAAC;AAO7F,qBAAa,SAAS;IACpB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,YAAY,CAAwE;gBAEhF,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB;YAoC3C,wBAAwB;YAcxB,kBAAkB;YAclB,iBAAiB;YAWjB,kBAAkB;IAO1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2DtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBrB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAoD9D,OAAO,CAAC,gBAAgB;YAiBV,aAAa;YAgBb,YAAY;YAwBZ,WAAW;YAgBX,aAAa;YAeb,cAAc;YAmBd,UAAU;YAeV,WAAW;YAWX,YAAY;YAkCZ,YAAY;YAsBZ,eAAe;YAyBf,WAAW;YAkBX,WAAW;YAkBX,eAAe;YAkBf,oBAAoB;YAkBpB,aAAa;YAUb,SAAS;YAuCT,YAAY;YAQZ,aAAa;YAgCb,gBAAgB;IAqB9B,OAAO,CAAC,kBAAkB;YAuNZ,oBAAoB;IA2BlC,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,YAAY;IAmBpB,OAAO,CAAC,eAAe;IAwBvB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;CAGlB"}