ruvector 0.2.23 → 0.2.25

package/dist/core/sona-wrapper.d.ts

@@ -0,0 +1,226 @@
+/**
+ * SONA Wrapper - Self-Optimizing Neural Architecture
+ *
+ * Provides a safe, flexible interface to @ruvector/sona with:
+ * - Automatic array type conversion (Array <-> Float64Array)
+ * - Graceful handling when sona is not installed
+ * - TypeScript types for all APIs
+ *
+ * SONA Features:
+ * - Micro-LoRA: Ultra-fast rank-1/2 adaptations (~0.1ms)
+ * - Base-LoRA: Deeper adaptations for complex patterns
+ * - EWC++: Elastic Weight Consolidation to prevent catastrophic forgetting
+ * - ReasoningBank: Pattern storage and retrieval
+ * - Trajectory tracking: Record and learn from execution paths
+ */
+/** Array input type - accepts both regular arrays and typed arrays */
+export type ArrayInput = number[] | Float32Array | Float64Array;
+/** SONA configuration options */
+export interface SonaConfig {
+    /** Hidden dimension size (required) */
+    hiddenDim: number;
+    /** Embedding dimension (defaults to hiddenDim) */
+    embeddingDim?: number;
+    /** Micro-LoRA rank (1-2, default: 1) */
+    microLoraRank?: number;
+    /** Base LoRA rank (default: 8) */
+    baseLoraRank?: number;
+    /** Micro-LoRA learning rate (default: 0.001) */
+    microLoraLr?: number;
+    /** Base LoRA learning rate (default: 0.0001) */
+    baseLoraLr?: number;
+    /** EWC lambda regularization (default: 1000.0) */
+    ewcLambda?: number;
+    /** Number of pattern clusters (default: 50) */
+    patternClusters?: number;
+    /** Trajectory buffer capacity (default: 10000) */
+    trajectoryCapacity?: number;
+    /** Background learning interval in ms (default: 3600000 = 1 hour) */
+    backgroundIntervalMs?: number;
+    /** Quality threshold for learning (default: 0.5) */
+    qualityThreshold?: number;
+    /** Enable SIMD optimizations (default: true) */
+    enableSimd?: boolean;
+}
+/** Learned pattern from ReasoningBank */
+export interface LearnedPattern {
+    /** Pattern identifier */
+    id: string;
+    /** Cluster centroid embedding */
+    centroid: number[];
+    /** Number of trajectories in cluster */
+    clusterSize: number;
+    /** Total weight of trajectories */
+    totalWeight: number;
+    /** Average quality of member trajectories */
+    avgQuality: number;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Last access timestamp */
+    lastAccessed: string;
+    /** Total access count */
+    accessCount: number;
+    /** Pattern type */
+    patternType: string;
+}
+/** SONA engine statistics */
+export interface SonaStats {
+    trajectoriesRecorded: number;
+    patternsLearned: number;
+    microLoraUpdates: number;
+    baseLoraUpdates: number;
+    ewcConsolidations: number;
+    avgLearningTimeMs: number;
+}
+/** Check if sona is available */
+export declare function isSonaAvailable(): boolean;
+/**
+ * SONA Engine - Self-Optimizing Neural Architecture
+ *
+ * Provides runtime-adaptive learning with:
+ * - Micro-LoRA for instant adaptations
+ * - Base-LoRA for deeper learning
+ * - EWC++ for preventing forgetting
+ * - ReasoningBank for pattern storage
+ *
+ * @example
+ * ```typescript
+ * import { Sona } from 'ruvector';
+ *
+ * // Create engine with hidden dimension
+ * const engine = new Sona.Engine(256);
+ *
+ * // Or with custom config
+ * const engine = Sona.Engine.withConfig({
+ *   hiddenDim: 256,
+ *   microLoraRank: 2,
+ *   patternClusters: 100
+ * });
+ *
+ * // Record a trajectory
+ * const trajId = engine.beginTrajectory([0.1, 0.2, ...]);
+ * engine.addStep(trajId, activations, attentionWeights, 0.8);
+ * engine.endTrajectory(trajId, 0.9);
+ *
+ * // Apply learned adaptations
+ * const adapted = engine.applyMicroLora(input);
+ * ```
+ */
+export declare class SonaEngine {
+    private _native;
+    /**
+     * Create a new SONA engine
+     * @param hiddenDim Hidden dimension size (e.g., 256, 512, 768)
+     */
+    constructor(hiddenDim: number);
+    /**
+     * Create engine with custom configuration
+     * @param config SONA configuration options
+     */
+    static withConfig(config: SonaConfig): SonaEngine;
+    /**
+     * Begin recording a new trajectory
+     * @param queryEmbedding Initial query embedding
+     * @returns Trajectory ID for subsequent operations
+     */
+    beginTrajectory(queryEmbedding: ArrayInput): number;
+    /**
+     * Add a step to an active trajectory
+     * @param trajectoryId Trajectory ID from beginTrajectory
+     * @param activations Layer activations
+     * @param attentionWeights Attention weights
+     * @param reward Reward signal for this step (0.0 - 1.0)
+     */
+    addStep(trajectoryId: number, activations: ArrayInput, attentionWeights: ArrayInput, reward: number): void;
+    /**
+     * Alias for addStep for API compatibility
+     */
+    addTrajectoryStep(trajectoryId: number, activations: ArrayInput, attentionWeights: ArrayInput, reward: number): void;
+    /**
+     * Set the model route for a trajectory
+     * @param trajectoryId Trajectory ID
+     * @param route Model route identifier (e.g., "gpt-4", "claude-3")
+     */
+    setRoute(trajectoryId: number, route: string): void;
+    /**
+     * Add context to a trajectory
+     * @param trajectoryId Trajectory ID
+     * @param contextId Context identifier
+     */
+    addContext(trajectoryId: number, contextId: string): void;
+    /**
+     * Complete a trajectory and submit for learning
+     * @param trajectoryId Trajectory ID
+     * @param quality Final quality score (0.0 - 1.0)
+     */
+    endTrajectory(trajectoryId: number, quality: number): void;
+    /**
+     * Apply micro-LoRA transformation (ultra-fast, ~0.1ms)
+     * @param input Input vector
+     * @returns Transformed output vector
+     */
+    applyMicroLora(input: ArrayInput): number[];
+    /**
+     * Apply base-LoRA transformation to a specific layer
+     * @param layerIdx Layer index
+     * @param input Input vector
+     * @returns Transformed output vector
+     */
+    applyBaseLora(layerIdx: number, input: ArrayInput): number[];
+    /**
+     * Run background learning cycle if due
+     * Call this periodically (e.g., every few seconds)
+     * @returns Status message if learning occurred, null otherwise
+     */
+    tick(): string | null;
+    /**
+     * Force immediate background learning cycle
+     * @returns Status message with learning results
+     */
+    forceLearn(): string;
+    /**
+     * Flush pending instant loop updates
+     */
+    flush(): void;
+    /**
+     * Find similar learned patterns to a query
+     * @param queryEmbedding Query embedding
+     * @param k Number of patterns to return
+     * @returns Array of similar patterns
+     */
+    findPatterns(queryEmbedding: ArrayInput, k: number): LearnedPattern[];
+    /**
+     * Get engine statistics
+     * @returns Statistics object
+     */
+    getStats(): SonaStats;
+    /**
+     * Save engine state to JSON string for persistence across restarts (fixes #274)
+     * @returns State JSON that can be stored to disk/database
+     */
+    saveState(): string;
+    /**
+     * Restore engine state from JSON saved by saveState() (fixes #274)
+     * @param stateJson - JSON string from a previous saveState() call
+     * @returns Number of patterns restored
+     */
+    loadState(stateJson: string): number;
+    /**
+     * Enable or disable the engine
+     * @param enabled Whether to enable
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Check if engine is enabled
+     */
+    isEnabled(): boolean;
+}
+/**
+ * SONA namespace with all exports
+ */
+export declare const Sona: {
+    Engine: typeof SonaEngine;
+    isAvailable: typeof isSonaAvailable;
+};
+export default Sona;
+//# sourceMappingURL=sona-wrapper.d.ts.map

package/dist/core/sona-wrapper.d.ts.map

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

package/dist/core/sona-wrapper.js

@@ -0,0 +1,282 @@
+"use strict";
+/**
+ * SONA Wrapper - Self-Optimizing Neural Architecture
+ *
+ * Provides a safe, flexible interface to @ruvector/sona with:
+ * - Automatic array type conversion (Array <-> Float64Array)
+ * - Graceful handling when sona is not installed
+ * - TypeScript types for all APIs
+ *
+ * SONA Features:
+ * - Micro-LoRA: Ultra-fast rank-1/2 adaptations (~0.1ms)
+ * - Base-LoRA: Deeper adaptations for complex patterns
+ * - EWC++: Elastic Weight Consolidation to prevent catastrophic forgetting
+ * - ReasoningBank: Pattern storage and retrieval
+ * - Trajectory tracking: Record and learn from execution paths
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Sona = exports.SonaEngine = void 0;
+exports.isSonaAvailable = isSonaAvailable;
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/** Convert any array-like to regular Array (SONA expects number[]) */
+function toArray(input) {
+    if (Array.isArray(input))
+        return input;
+    return Array.from(input);
+}
+// ============================================================================
+// Lazy Loading
+// ============================================================================
+let sonaModule = null;
+let sonaLoadError = null;
+function getSonaModule() {
+    if (sonaModule)
+        return sonaModule;
+    if (sonaLoadError)
+        throw sonaLoadError;
+    try {
+        sonaModule = require('@ruvector/sona');
+        return sonaModule;
+    }
+    catch (e) {
+        sonaLoadError = new Error(`@ruvector/sona is not installed. Install it with:\n` +
+            `  npm install @ruvector/sona\n\n` +
+            `Original error: ${e.message}`);
+        throw sonaLoadError;
+    }
+}
+/** Check if sona is available */
+function isSonaAvailable() {
+    try {
+        getSonaModule();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ============================================================================
+// SONA Engine Wrapper
+// ============================================================================
+/**
+ * SONA Engine - Self-Optimizing Neural Architecture
+ *
+ * Provides runtime-adaptive learning with:
+ * - Micro-LoRA for instant adaptations
+ * - Base-LoRA for deeper learning
+ * - EWC++ for preventing forgetting
+ * - ReasoningBank for pattern storage
+ *
+ * @example
+ * ```typescript
+ * import { Sona } from 'ruvector';
+ *
+ * // Create engine with hidden dimension
+ * const engine = new Sona.Engine(256);
+ *
+ * // Or with custom config
+ * const engine = Sona.Engine.withConfig({
+ *   hiddenDim: 256,
+ *   microLoraRank: 2,
+ *   patternClusters: 100
+ * });
+ *
+ * // Record a trajectory
+ * const trajId = engine.beginTrajectory([0.1, 0.2, ...]);
+ * engine.addStep(trajId, activations, attentionWeights, 0.8);
+ * engine.endTrajectory(trajId, 0.9);
+ *
+ * // Apply learned adaptations
+ * const adapted = engine.applyMicroLora(input);
+ * ```
+ */
+class SonaEngine {
+    /**
+     * Create a new SONA engine
+     * @param hiddenDim Hidden dimension size (e.g., 256, 512, 768)
+     */
+    constructor(hiddenDim) {
+        const mod = getSonaModule();
+        this._native = new mod.SonaEngine(hiddenDim);
+    }
+    /**
+     * Create engine with custom configuration
+     * @param config SONA configuration options
+     */
+    static withConfig(config) {
+        const mod = getSonaModule();
+        const engine = new SonaEngine(config.hiddenDim);
+        // Replace native with configured version
+        engine._native = mod.SonaEngine.withConfig(config);
+        return engine;
+    }
+    // -------------------------------------------------------------------------
+    // Trajectory Recording
+    // -------------------------------------------------------------------------
+    /**
+     * Begin recording a new trajectory
+     * @param queryEmbedding Initial query embedding
+     * @returns Trajectory ID for subsequent operations
+     */
+    beginTrajectory(queryEmbedding) {
+        return this._native.beginTrajectory(toArray(queryEmbedding));
+    }
+    /**
+     * Add a step to an active trajectory
+     * @param trajectoryId Trajectory ID from beginTrajectory
+     * @param activations Layer activations
+     * @param attentionWeights Attention weights
+     * @param reward Reward signal for this step (0.0 - 1.0)
+     */
+    addStep(trajectoryId, activations, attentionWeights, reward) {
+        this._native.addTrajectoryStep(trajectoryId, toArray(activations), toArray(attentionWeights), reward);
+    }
+    /**
+     * Alias for addStep for API compatibility
+     */
+    addTrajectoryStep(trajectoryId, activations, attentionWeights, reward) {
+        this.addStep(trajectoryId, activations, attentionWeights, reward);
+    }
+    /**
+     * Set the model route for a trajectory
+     * @param trajectoryId Trajectory ID
+     * @param route Model route identifier (e.g., "gpt-4", "claude-3")
+     */
+    setRoute(trajectoryId, route) {
+        this._native.setTrajectoryRoute(trajectoryId, route);
+    }
+    /**
+     * Add context to a trajectory
+     * @param trajectoryId Trajectory ID
+     * @param contextId Context identifier
+     */
+    addContext(trajectoryId, contextId) {
+        this._native.addTrajectoryContext(trajectoryId, contextId);
+    }
+    /**
+     * Complete a trajectory and submit for learning
+     * @param trajectoryId Trajectory ID
+     * @param quality Final quality score (0.0 - 1.0)
+     */
+    endTrajectory(trajectoryId, quality) {
+        this._native.endTrajectory(trajectoryId, quality);
+    }
+    // -------------------------------------------------------------------------
+    // LoRA Transformations
+    // -------------------------------------------------------------------------
+    /**
+     * Apply micro-LoRA transformation (ultra-fast, ~0.1ms)
+     * @param input Input vector
+     * @returns Transformed output vector
+     */
+    applyMicroLora(input) {
+        return this._native.applyMicroLora(toArray(input));
+    }
+    /**
+     * Apply base-LoRA transformation to a specific layer
+     * @param layerIdx Layer index
+     * @param input Input vector
+     * @returns Transformed output vector
+     */
+    applyBaseLora(layerIdx, input) {
+        return this._native.applyBaseLora(layerIdx, toArray(input));
+    }
+    // -------------------------------------------------------------------------
+    // Learning Control
+    // -------------------------------------------------------------------------
+    /**
+     * Run background learning cycle if due
+     * Call this periodically (e.g., every few seconds)
+     * @returns Status message if learning occurred, null otherwise
+     */
+    tick() {
+        return this._native.tick();
+    }
+    /**
+     * Force immediate background learning cycle
+     * @returns Status message with learning results
+     */
+    forceLearn() {
+        return this._native.forceLearn();
+    }
+    /**
+     * Flush pending instant loop updates
+     */
+    flush() {
+        this._native.flush();
+    }
+    // -------------------------------------------------------------------------
+    // Pattern Retrieval
+    // -------------------------------------------------------------------------
+    /**
+     * Find similar learned patterns to a query
+     * @param queryEmbedding Query embedding
+     * @param k Number of patterns to return
+     * @returns Array of similar patterns
+     */
+    findPatterns(queryEmbedding, k) {
+        return this._native.findPatterns(toArray(queryEmbedding), k);
+    }
+    // -------------------------------------------------------------------------
+    // Engine Control
+    // -------------------------------------------------------------------------
+    /**
+     * Get engine statistics
+     * @returns Statistics object
+     */
+    getStats() {
+        const statsJson = this._native.getStats();
+        const raw = JSON.parse(statsJson);
+        // Map snake_case Rust fields to camelCase TypeScript (fixes #273)
+        return {
+            trajectoriesRecorded: raw.trajectories_recorded ?? raw.trajectoriesRecorded ?? (raw.trajectories_buffered ?? 0) + (raw.trajectories_dropped ?? 0),
+            patternsLearned: raw.patterns_learned ?? raw.patternsLearned ?? raw.patterns_stored ?? 0,
+            microLoraUpdates: raw.micro_lora_updates ?? raw.microLoraUpdates ?? 0,
+            baseLoraUpdates: raw.base_lora_updates ?? raw.baseLoraUpdates ?? 0,
+            ewcConsolidations: raw.ewc_tasks ?? raw.ewcConsolidations ?? 0,
+            avgLearningTimeMs: raw.avg_learning_time_ms ?? raw.avgLearningTimeMs ?? 0,
+        };
+    }
+    /**
+     * Save engine state to JSON string for persistence across restarts (fixes #274)
+     * @returns State JSON that can be stored to disk/database
+     */
+    saveState() {
+        return this._native.saveState();
+    }
+    /**
+     * Restore engine state from JSON saved by saveState() (fixes #274)
+     * @param stateJson - JSON string from a previous saveState() call
+     * @returns Number of patterns restored
+     */
+    loadState(stateJson) {
+        return this._native.loadState(stateJson);
+    }
+    /**
+     * Enable or disable the engine
+     * @param enabled Whether to enable
+     */
+    setEnabled(enabled) {
+        this._native.setEnabled(enabled);
+    }
+    /**
+     * Check if engine is enabled
+     */
+    isEnabled() {
+        return this._native.isEnabled();
+    }
+}
+exports.SonaEngine = SonaEngine;
+// ============================================================================
+// Convenience Exports
+// ============================================================================
+/**
+ * SONA namespace with all exports
+ */
+exports.Sona = {
+    Engine: SonaEngine,
+    isAvailable: isSonaAvailable,
+};
+exports.default = exports.Sona;

package/dist/core/tensor-compress.d.ts

@@ -0,0 +1,134 @@
+/**
+ * TensorCompress - Adaptive tensor compression for intelligence storage
+ * Provides 10x memory savings with access-frequency based compression
+ */
+export type CompressionLevel = 'none' | 'half' | 'pq8' | 'pq4' | 'binary';
+export interface CompressedTensor {
+    data: number[] | Uint8Array | Uint16Array | Float32Array;
+    level: CompressionLevel;
+    originalDim: number;
+    accessCount: number;
+    lastAccess: number;
+    created: number;
+}
+export interface CompressionStats {
+    totalTensors: number;
+    byLevel: Record<CompressionLevel, number>;
+    originalBytes: number;
+    compressedBytes: number;
+    savingsPercent: number;
+}
+export interface CompressionConfig {
+    hotThreshold: number;
+    warmThreshold: number;
+    coolThreshold: number;
+    coldThreshold: number;
+    autoCompress: boolean;
+    compressIntervalMs: number;
+}
+export declare class TensorCompress {
+    private config;
+    private tensors;
+    private totalAccesses;
+    private compressTimer;
+    constructor(config?: Partial<CompressionConfig>);
+    /**
+     * Store a tensor with automatic compression based on access patterns
+     */
+    store(id: string, tensor: Float32Array | number[], level?: CompressionLevel): void;
+    /**
+     * Retrieve and decompress a tensor
+     */
+    get(id: string): Float32Array | null;
+    /**
+     * Check if tensor exists
+     */
+    has(id: string): boolean;
+    /**
+     * Delete a tensor
+     */
+    delete(id: string): boolean;
+    /**
+     * Get all tensor IDs
+     */
+    keys(): string[];
+    /**
+     * Compress tensor to specified level
+     */
+    private compress;
+    /**
+     * Decompress tensor back to Float32Array
+     */
+    private decompress;
+    /**
+     * Float16 conversion (approximate)
+     */
+    private toFloat16;
+    private fromFloat16;
+    private floatToHalf;
+    private halfToFloat;
+    /**
+     * Product Quantization 8-bit
+     */
+    private toPQ8;
+    private fromPQ8;
+    /**
+     * Product Quantization 4-bit (packed)
+     */
+    private toPQ4;
+    private fromPQ4;
+    /**
+     * Binary quantization (1-bit per value)
+     */
+    private toBinary;
+    private fromBinary;
+    /**
+     * Calculate access frequency for a tensor
+     */
+    private getAccessFrequency;
+    /**
+     * Determine optimal compression level based on access frequency
+     */
+    getOptimalLevel(id: string): CompressionLevel;
+    /**
+     * Recompress all tensors based on current access patterns
+     */
+    recompressAll(): CompressionStats;
+    /**
+     * Get compressed size in bytes
+     */
+    private getCompressedSize;
+    /**
+     * Get compression statistics
+     */
+    getStats(): CompressionStats;
+    /**
+     * Start auto-compression timer
+     */
+    private startAutoCompress;
+    /**
+     * Stop auto-compression
+     */
+    stopAutoCompress(): void;
+    /**
+     * Export all tensors for persistence
+     */
+    export(): {
+        tensors: Record<string, any>;
+        totalAccesses: number;
+    };
+    /**
+     * Import tensors from persistence
+     */
+    import(data: {
+        tensors: Record<string, any>;
+        totalAccesses: number;
+    }): void;
+    private restoreTypedArray;
+    /**
+     * Clear all tensors
+     */
+    clear(): void;
+}
+export default TensorCompress;
+//# sourceMappingURL=tensor-compress.d.ts.map

package/dist/core/tensor-compress.d.ts.map

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