nexus-prime 0.2.0

package/dist/engines/cache-manager.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Multi-Agent Cache Manager
+ *
+ * Implements shared KV cache with Byzantine consensus.
+ */
+export interface CacheEntry {
+    direction: number[];
+    magnitudes: number[];
+    retained: Map<number, number[]>;
+    indices: number[];
+}
+export interface AgentDelta {
+    layerIndex: number;
+    delta: number[];
+    timestamp: number;
+}
+export declare class CacheManager {
+    private sharedCache;
+    private agentDeltas;
+    private version;
+    private locks;
+    private syncInterval;
+    private compressionThreshold;
+    /**
+     * Initialize shared cache for a layer
+     */
+    initLayer(layerIndex: number, kvCache: number[][]): void;
+    /**
+     * Compress KV cache using SLERP-inspired merge
+     */
+    private compress;
+    /**
+     * SLERP-inspired merge
+     */
+    private slerpMerge;
+    /**
+     * Acquire read lock (non-blocking)
+     */
+    acquireReadLock(layerIndex: number): boolean;
+    /**
+     * Acquire write lock
+     */
+    acquireWriteLock(layerIndex: number): boolean;
+    /**
+     * Release lock
+     */
+    releaseLock(layerIndex: number): void;
+    /**
+     * Get cache entry for agent
+     */
+    getForAgent(agentId: string, layerIndex: number): number[];
+    /**
+     * Update agent delta
+     */
+    updateDelta(agentId: string, layerIndex: number, delta: number[]): void;
+    /**
+     * Sync agent delta to shared cache
+     */
+    syncToShared(agentId: string, layerIndex: number): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        layers: number;
+        agents: number;
+        version: number;
+        compressionRatio: number;
+    };
+    private magnitude;
+    private normalize;
+    private dotProduct;
+    private cosineSimilarity;
+}
+export declare const createCacheManager: () => CacheManager;
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/engines/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/engines/cache-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,WAAW,CAAiD;IACpE,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,KAAK,CAAqD;IAElE,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,oBAAoB,CAAO;IAEnC;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAMxD;;OAEG;IACH,OAAO,CAAC,QAAQ;IAsChB;;OAEG;IACH,OAAO,CAAC,UAAU;IAgBlB;;OAEG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAS5C;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAS7C;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAuB1D;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAavE;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAgCvD;;OAEG;IACH,QAAQ,IAAI;QACV,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAqBD,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,gBAAgB;CAMzB;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/engines/cache-manager.js

@@ -0,0 +1,200 @@
+/**
+ * Multi-Agent Cache Manager
+ *
+ * Implements shared KV cache with Byzantine consensus.
+ */
+export class CacheManager {
+    sharedCache = new Map();
+    agentDeltas = new Map();
+    version = 0;
+    locks = new Map();
+    syncInterval = 50; // tokens
+    compressionThreshold = 0.1;
+    /**
+     * Initialize shared cache for a layer
+     */
+    initLayer(layerIndex, kvCache) {
+        // Compress using SLERP-like merge
+        const compressed = this.compress(kvCache);
+        this.sharedCache.set(layerIndex, compressed);
+    }
+    /**
+     * Compress KV cache using SLERP-inspired merge
+     */
+    compress(kvCache) {
+        if (kvCache.length < 2) {
+            return {
+                direction: kvCache[0] || [],
+                magnitudes: [1],
+                retained: new Map(),
+                indices: kvCache.map((_, i) => i)
+            };
+        }
+        // Start from middle
+        const mid = Math.floor(kvCache.length / 2);
+        // Merge middle with previous (like SLERP)
+        const merged = this.slerpMerge(kvCache[mid], kvCache[mid - 1], 0.5);
+        // Compute magnitudes
+        const magnitudes = kvCache.map(v => this.magnitude(v));
+        // Retain highly distinct tokens (simple threshold)
+        const retained = new Map();
+        const threshold = 0.3;
+        for (let i = mid; i < kvCache.length; i++) {
+            const sim = this.cosineSimilarity(kvCache[i], merged);
+            if (sim < threshold) {
+                retained.set(i, kvCache[i]);
+            }
+        }
+        return {
+            direction: this.normalize(merged),
+            magnitudes: magnitudes.slice(mid),
+            retained,
+            indices: kvCache.map((_, i) => i).slice(mid)
+        };
+    }
+    /**
+     * SLERP-inspired merge
+     */
+    slerpMerge(v1, v2, t) {
+        // Simplified SLERP
+        const dot = this.dotProduct(v1, v2) / (this.magnitude(v1) * this.magnitude(v2) || 1);
+        const omega = Math.acos(Math.max(-1, Math.min(1, dot)));
+        const sinOmega = Math.sin(omega);
+        if (sinOmega < 1e-6) {
+            return v1.map((x, i) => (1 - t) * x + t * (v2[i] || 0));
+        }
+        const a = Math.sin((1 - t) * omega) / sinOmega;
+        const b = Math.sin(t * omega) / sinOmega;
+        return v1.map((x, i) => a * x + b * (v2[i] || 0));
+    }
+    /**
+     * Acquire read lock (non-blocking)
+     */
+    acquireReadLock(layerIndex) {
+        const current = this.locks.get(layerIndex) || 'none';
+        if (current === 'write') {
+            return false; // Blocked
+        }
+        this.locks.set(layerIndex, 'read');
+        return true;
+    }
+    /**
+     * Acquire write lock
+     */
+    acquireWriteLock(layerIndex) {
+        const current = this.locks.get(layerIndex) || 'none';
+        if (current !== 'none') {
+            return false; // Blocked
+        }
+        this.locks.set(layerIndex, 'write');
+        return true;
+    }
+    /**
+     * Release lock
+     */
+    releaseLock(layerIndex) {
+        this.locks.set(layerIndex, 'none');
+    }
+    /**
+     * Get cache entry for agent
+     */
+    getForAgent(agentId, layerIndex) {
+        const entry = this.sharedCache.get(layerIndex);
+        if (!entry)
+            return [];
+        // Get agent's delta
+        const agentDeltaMap = this.agentDeltas.get(agentId) || new Map();
+        const delta = agentDeltaMap.get(layerIndex) || [];
+        // Restore: direction * magnitude + delta
+        const restored = entry.direction.map((d, i) => d * (entry.magnitudes[i] || 1) + (delta[i] || 0));
+        // Add retained tokens
+        for (const [idx, token] of entry.retained) {
+            if (idx < restored.length) {
+                restored[idx] += this.magnitude(token);
+            }
+        }
+        return restored;
+    }
+    /**
+     * Update agent delta
+     */
+    updateDelta(agentId, layerIndex, delta) {
+        if (!this.agentDeltas.has(agentId)) {
+            this.agentDeltas.set(agentId, new Map());
+        }
+        const agentDeltaMap = this.agentDeltas.get(agentId);
+        const existing = agentDeltaMap.get(layerIndex) || [];
+        // Accumulate delta
+        const newDelta = delta.map((d, i) => d + (existing[i] || 0));
+        agentDeltaMap.set(layerIndex, newDelta);
+    }
+    /**
+     * Sync agent delta to shared cache
+     */
+    syncToShared(agentId, layerIndex) {
+        const agentDeltaMap = this.agentDeltas.get(agentId);
+        if (!agentDeltaMap)
+            return;
+        const delta = agentDeltaMap.get(layerIndex);
+        if (!delta)
+            return;
+        // Check if delta is significant
+        const entry = this.sharedCache.get(layerIndex);
+        if (!entry)
+            return;
+        const mag = this.magnitude(entry.direction);
+        const deltaMag = this.magnitude(delta);
+        if (deltaMag > this.compressionThreshold * mag) {
+            // Merge delta into shared
+            const merged = entry.direction.map((d, i) => d + delta[i] * 0.1);
+            this.sharedCache.set(layerIndex, {
+                ...entry,
+                direction: this.normalize(merged),
+                magnitudes: entry.magnitudes.map(m => m + deltaMag * 0.1)
+            });
+            // Reset agent delta
+            agentDeltaMap.set(layerIndex, []);
+            this.version++;
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        let totalOriginal = 0;
+        let totalCompressed = 0;
+        for (const entry of this.sharedCache.values()) {
+            totalOriginal += entry.magnitudes.length * entry.direction.length;
+            totalCompressed += entry.direction.length + entry.magnitudes.length;
+            totalCompressed += Array.from(entry.retained.values())
+                .reduce((sum, v) => sum + v.length, 0);
+        }
+        return {
+            layers: this.sharedCache.size,
+            agents: this.agentDeltas.size,
+            version: this.version,
+            compressionRatio: totalOriginal / (totalCompressed || 1)
+        };
+    }
+    // ===== Utilities =====
+    magnitude(v) {
+        return Math.sqrt(v.reduce((sum, x) => sum + x * x, 0));
+    }
+    normalize(v) {
+        const mag = this.magnitude(v);
+        if (mag === 0)
+            return v;
+        return v.map(x => x / mag);
+    }
+    dotProduct(a, b) {
+        return a.reduce((sum, x, i) => sum + x * (b[i] || 0), 0);
+    }
+    cosineSimilarity(a, b) {
+        const dot = this.dotProduct(a, b);
+        const magA = this.magnitude(a);
+        const magB = this.magnitude(b);
+        return dot / (magA * magB || 1);
+    }
+}
+export const createCacheManager = () => new CacheManager();
+//# sourceMappingURL=cache-manager.js.map

package/dist/engines/cache-manager.js.map

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

package/dist/engines/context.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Context Engine
+ *
+ * Manages context window with compression and retrieval.
+ */
+export declare class ContextEngine {
+    private maxTokens;
+    private tokenOptimizer;
+    private workingContext;
+    private compressedCache;
+    constructor(maxTokens?: number);
+    /**
+     * Add content to context
+     */
+    add(content: string): void;
+    /**
+     * Get relevant context for query
+     */
+    getContext(query: string): string[];
+    /**
+     * Compress working context
+     */
+    private compress;
+    /**
+     * Get total token count
+     */
+    private getTokenCount;
+    /**
+     * Simple tokenization
+     */
+    private tokenize;
+    /**
+     * Simple similarity (in production use embeddings)
+     */
+    private similarity;
+    /**
+     * Simple hash
+     */
+    private hashString;
+    /**
+     * Clear context
+     */
+    clear(): void;
+    /**
+     * Get all context
+     */
+    getAll(): string[];
+}
+export declare const createContextEngine: (maxTokens?: number) => ContextEngine;
+//# sourceMappingURL=context.d.ts.map

package/dist/engines/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/engines/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,eAAe,CAAoC;gBAE/C,SAAS,GAAE,MAAe;IAKtC;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAW1B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IASnC;;OAEG;IACH,OAAO,CAAC,QAAQ;IAehB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,UAAU;IAUlB;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,IAAI,MAAM,EAAE;CAGnB;AAED,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,kBACxB,CAAC"}

package/dist/engines/context.js

@@ -0,0 +1,99 @@
+/**
+ * Context Engine
+ *
+ * Manages context window with compression and retrieval.
+ */
+import { TokenOptimizer } from './token-optimizer.js';
+export class ContextEngine {
+    maxTokens;
+    tokenOptimizer;
+    workingContext = [];
+    compressedCache = new Map();
+    constructor(maxTokens = 128000) {
+        this.maxTokens = maxTokens;
+        this.tokenOptimizer = new TokenOptimizer(maxTokens);
+    }
+    /**
+     * Add content to context
+     */
+    add(content) {
+        const tokens = this.tokenize(content);
+        // Check if we need to compress
+        if (this.getTokenCount() + tokens.length > this.maxTokens * 0.8) {
+            this.compress();
+        }
+        this.workingContext.push(content);
+    }
+    /**
+     * Get relevant context for query
+     */
+    getContext(query) {
+        // Simple retrieval - in production use embeddings
+        const relevant = this.workingContext
+            .filter(c => this.similarity(query, c) > 0.3)
+            .slice(-50);
+        return relevant;
+    }
+    /**
+     * Compress working context
+     */
+    compress() {
+        if (this.workingContext.length === 0)
+            return;
+        // Keep most recent and most relevant
+        const toCompress = this.workingContext.slice(0, -10);
+        const recent = this.workingContext.slice(-10);
+        // Create compressed version (simple concatenation for now)
+        const compressed = toCompress.join(' | ');
+        const key = this.hashString(compressed);
+        this.compressedCache.set(key, toCompress);
+        this.workingContext = recent;
+    }
+    /**
+     * Get total token count
+     */
+    getTokenCount() {
+        return this.workingContext.reduce((sum, c) => sum + c.length / 4, 0);
+    }
+    /**
+     * Simple tokenization
+     */
+    tokenize(content) {
+        return content.split(/\s+/);
+    }
+    /**
+     * Simple similarity (in production use embeddings)
+     */
+    similarity(a, b) {
+        const wordsA = new Set(a.toLowerCase().split(/\s+/));
+        const wordsB = new Set(b.toLowerCase().split(/\s+/));
+        const intersection = [...wordsA].filter(x => wordsB.has(x));
+        const union = new Set([...wordsA, ...wordsB]);
+        return intersection.length / union.size;
+    }
+    /**
+     * Simple hash
+     */
+    hashString(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            hash = ((hash << 5) - hash) + str.charCodeAt(i);
+            hash |= 0;
+        }
+        return hash.toString(36);
+    }
+    /**
+     * Clear context
+     */
+    clear() {
+        this.workingContext = [];
+    }
+    /**
+     * Get all context
+     */
+    getAll() {
+        return [...this.workingContext];
+    }
+}
+export const createContextEngine = (maxTokens) => new ContextEngine(maxTokens);
+//# sourceMappingURL=context.js.map

package/dist/engines/context.js.map

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

package/dist/engines/embedder.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Embedder — TF-IDF local embeddings + optional API mode
+ *
+ * Mode 1 (default): Pure TF-IDF, no API needed. Works offline, fast.
+ * Mode 2: OpenAI-compatible API (set NEXUS_EMBED_MODE=api, NEXUS_EMBED_URL, NEXUS_EMBED_KEY)
+ *
+ * Output: fixed 128-dim float32 vectors (TF-IDF) or 1536-dim (API)
+ */
+/**
+ * Poincare Ball model for hyperbolic space.
+ * Hyperbolic distance is better suited for hierarchical structures (trees/code).
+ */
+export declare const HyperbolicMath: {
+    /**
+     * Hyperbolic distance between two points in the unit ball.
+     * d(u, v) = arcosh(1 + 2 * ||u-v||^2 / ( (1-||u||^2)(1-||v||^2) ))
+     */
+    dist(u: number[], v: number[]): number;
+    /**
+     * Mobius addition: u ⊕ v
+     * Used to translate points in hyperbolic space while staying in the unit ball.
+     */
+    mobiusAdd(u: number[], v: number[]): number;
+    /** Ensure vector is within unit ball (norm < 1) */
+    project(v: number[]): number[];
+};
+export declare class Embedder {
+    private vocabulary;
+    private idf;
+    private docCount;
+    private apiMode;
+    private apiUrl;
+    private apiKey;
+    private apiModel;
+    constructor();
+    /** Embed a string → float32 vector */
+    embed(text: string): Promise<number[]>;
+    /**
+     * Generate a hierarchical embedding.
+     * Shifts the vector "deeper" into the Poincare ball relative to a parent.
+     */
+    embedHierarchical(text: string, parentVector?: number[], depth?: number): number[];
+    /** Update vocabulary with new documents (call as you store memories) */
+    fitVocabulary(docs: string[]): void;
+    /** Dimension of vectors produced by this embedder */
+    get dimensions(): number;
+    localEmbed(text: string): number[];
+    apiEmbed(text: string): Promise<number[]>;
+    cosineSimilarity(a: number[], b: number[]): number;
+    private tokenize;
+    private normalize;
+    private hashCode;
+}
+export declare const createEmbedder: () => Embedder;
+//# sourceMappingURL=embedder.d.ts.map

package/dist/engines/embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.d.ts","sourceRoot":"","sources":["../../src/engines/embedder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAyBH;;;GAGG;AACH,eAAO,MAAM,cAAc;IACvB;;;OAGG;YACK,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM;IActC;;;OAGG;iBACU,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,MAAM;IAc3C,mDAAmD;eACxC,MAAM,EAAE,GAAG,MAAM,EAAE;CAMjC,CAAC;AAMF,qBAAa,QAAQ;IACjB,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,GAAG,CAAkC;IAC7C,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;;IAWzB,sCAAsC;IAChC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAY5C;;;OAGG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,EAAE;IAmBrF,wEAAwE;IACxE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAyBnC,qDAAqD;IACrD,IAAI,UAAU,IAAI,MAAM,CAEvB;IAID,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE;IA2B5B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAuB/C,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAclD,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;CAOnB;AAED,eAAO,MAAM,cAAc,gBAAuB,CAAC"}