ruvector 0.2.21 → 0.2.23

package/dist/core/sona-wrapper.js

@@ -1,282 +0,0 @@
-"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

@@ -1,134 +0,0 @@
-/**
- * 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

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