agentic-flow 2.0.1-alpha.5 → 2.0.1-alpha.8

package/dist/intelligence/RuVectorIntelligence.d.ts

@@ -0,0 +1,362 @@
+/**
+ * RuVector Unified Intelligence Layer
+ *
+ * Integrates the FULL power of RuVector ecosystem:
+ *
+ * @ruvector/sona - Self-Learning:
+ *   - Micro-LoRA: Ultra-fast rank-1/2 adaptations (~0.1ms)
+ *   - Base-LoRA: Deeper pattern adaptations
+ *   - EWC++: Elastic Weight Consolidation (catastrophic forgetting prevention)
+ *   - ReasoningBank: Pattern storage/retrieval via findPatterns
+ *   - Trajectory tracking: Learn from execution paths
+ *
+ * @ruvector/attention - Advanced Attention:
+ *   - MultiHeadAttention: Standard transformer attention
+ *   - FlashAttention: Memory-efficient O(n) attention
+ *   - HyperbolicAttention: Poincaré ball geometry for hierarchies
+ *   - MoEAttention: Mixture of Experts routing
+ *   - GraphRoPeAttention: Graph + Rotary Position Embeddings
+ *   - EdgeFeaturedAttention: Edge-aware graph attention
+ *   - DualSpaceAttention: Euclidean + Hyperbolic hybrid
+ *
+ * @ruvector/core - Vector Database:
+ *   - HNSW indexing: 150x faster than brute force
+ *   - Real vector similarity search
+ *   - Cosine/Euclidean/Dot product distance
+ *
+ * Performance:
+ *   - Micro-LoRA adaptation: ~0.1ms
+ *   - FlashAttention: O(n) complexity vs O(n²)
+ *   - HNSW search: O(log n) vs O(n)
+ *   - Background learning: Non-blocking
+ */
+import { type JsSonaConfig, type JsLearnedPattern } from '@ruvector/sona';
+/**
+ * Intelligence Layer Configuration
+ */
+export interface RuVectorIntelligenceConfig {
+    /** Embedding dimension (default: 384 for all-MiniLM-L6-v2) */
+    embeddingDim?: number;
+    /** Hidden dimension for SONA (default: 256) */
+    hiddenDim?: number;
+    /** Enable SONA self-learning (default: true) */
+    enableSona?: boolean;
+    /** SONA configuration */
+    sonaConfig?: Partial<JsSonaConfig>;
+    /** Attention type for agent routing (default: 'moe') */
+    attentionType?: 'multi_head' | 'flash' | 'hyperbolic' | 'moe' | 'graph' | 'dual';
+    /** Number of attention heads (default: 8) */
+    numHeads?: number;
+    /** Number of MoE experts (default: 4) */
+    numExperts?: number;
+    /** Top-K experts to use (default: 2) */
+    topK?: number;
+    /** Hyperbolic curvature for hierarchical structures (default: 1.0) */
+    curvature?: number;
+    /** Enable HNSW vector index (default: true) */
+    enableHnsw?: boolean;
+    /** HNSW M parameter - connections per node (default: 16) */
+    hnswM?: number;
+    /** HNSW ef_construction (default: 200) */
+    hnswEfConstruction?: number;
+    /** Enable trajectory tracking (default: true) */
+    enableTrajectories?: boolean;
+    /** Quality threshold for learning (default: 0.5) */
+    qualityThreshold?: number;
+    /** Background learning interval in ms (default: 60000 = 1 min) */
+    backgroundIntervalMs?: number;
+    /** Maximum trajectories to keep in memory (default: 1000, LRU eviction) */
+    maxTrajectories?: number;
+    /** Trajectory TTL in ms (default: 1800000 = 30 min) */
+    trajectoryTTLMs?: number;
+    /** Maximum agent embeddings to cache (default: 500, LRU eviction) */
+    maxAgentEmbeddings?: number;
+}
+/**
+ * Trajectory for learning
+ */
+export interface Trajectory {
+    id: number;
+    query: string;
+    embedding: number[];
+    steps: TrajectoryStep[];
+    route?: string;
+    contexts: string[];
+    startTime: number;
+}
+export interface TrajectoryStep {
+    action: string;
+    activations: number[];
+    attentionWeights: number[];
+    reward: number;
+    timestamp: number;
+}
+/**
+ * Agent routing result
+ */
+export interface AgentRoutingResult {
+    agentId: string;
+    confidence: number;
+    attentionWeights: Float32Array;
+    expertWeights?: number[];
+    latencyMs: number;
+    usedHnsw: boolean;
+    usedSona: boolean;
+}
+/**
+ * Learning outcome
+ */
+export interface LearningOutcome {
+    trajectoryId: number;
+    success: boolean;
+    quality: number;
+    patternsLearned: number;
+    adaptations: {
+        microLora: boolean;
+        baseLora: boolean;
+        ewc: boolean;
+    };
+}
+/**
+ * RuVector Unified Intelligence Layer
+ *
+ * Combines SONA self-learning, advanced attention mechanisms,
+ * and HNSW vector search for intelligent agent orchestration.
+ */
+/**
+ * Result wrapper for operations that can fail
+ */
+export interface OperationResult<T> {
+    success: boolean;
+    value?: T;
+    error?: string;
+}
+export declare class RuVectorIntelligence {
+    private config;
+    private initialized;
+    private initPromise;
+    private sona;
+    private multiHeadAttention;
+    private flashAttention;
+    private hyperbolicAttention;
+    private moeAttention;
+    private graphAttention;
+    private dualSpaceAttention;
+    private optimizer;
+    private hnswIndex;
+    private trajectories;
+    private trajectoryAccessOrder;
+    private nextTrajectoryId;
+    private agentEmbeddings;
+    private agentAccessOrder;
+    private learningTimer;
+    private cleanupTimer;
+    private stats;
+    constructor(config?: RuVectorIntelligenceConfig);
+    /**
+     * Wait for initialization to complete
+     */
+    waitForInit(): Promise<void>;
+    /**
+     * Initialize all components (async to avoid race conditions)
+     */
+    private initializeAsync;
+    /**
+     * Start cleanup timer for stale trajectories
+     */
+    private startCleanupTimer;
+    /**
+     * Clean up trajectories older than TTL
+     */
+    private cleanupStaleTrajectories;
+    /**
+     * LRU eviction for trajectories when limit exceeded
+     */
+    private evictOldestTrajectory;
+    /**
+     * LRU eviction for agent embeddings when limit exceeded
+     */
+    private evictOldestAgent;
+    /**
+     * Update LRU access order for trajectory
+     */
+    private touchTrajectory;
+    /**
+     * Update LRU access order for agent
+     */
+    private touchAgent;
+    /**
+     * Initialize HNSW index for fast vector search
+     */
+    private initializeHnsw;
+    /**
+     * Register an agent with its embedding
+     *
+     * @param agentId - Unique agent identifier
+     * @param embedding - Agent's semantic embedding
+     * @param metadata - Optional metadata
+     * @returns Operation result indicating success/failure
+     */
+    registerAgent(agentId: string, embedding: number[] | Float32Array, metadata?: Record<string, any>): Promise<OperationResult<void>>;
+    /**
+     * Route a task to the best agent using full intelligence stack
+     *
+     * Uses:
+     * - HNSW for fast candidate retrieval
+     * - Attention mechanism for ranking
+     * - SONA for adaptive learning
+     *
+     * @param taskEmbedding - Task's semantic embedding
+     * @param candidates - Optional candidate agent IDs
+     * @param topK - Number of results
+     */
+    routeTask(taskEmbedding: number[] | Float32Array, candidates?: string[], topK?: number): Promise<AgentRoutingResult[]>;
+    /**
+     * Fallback attention using dot product
+     */
+    private computeFallbackAttention;
+    /**
+     * Cosine similarity between two vectors
+     */
+    private cosineSimilarity;
+    /**
+     * Begin a new trajectory for learning
+     *
+     * @param query - The task query
+     * @param embedding - Query embedding
+     * @returns Operation result with trajectory ID
+     */
+    beginTrajectory(query: string, embedding: number[]): OperationResult<number>;
+    /**
+     * Add a step to trajectory
+     *
+     * @param trajectoryId - Trajectory ID from beginTrajectory
+     * @param action - Action taken (e.g., agent selected)
+     * @param reward - Reward for this step (0-1)
+     * @param activations - Optional activations
+     * @param attentionWeights - Optional attention weights
+     */
+    addTrajectoryStep(trajectoryId: number, action: string, reward: number, activations?: number[], attentionWeights?: number[]): void;
+    /**
+     * Set the route (agent selected) for trajectory
+     */
+    setTrajectoryRoute(trajectoryId: number, route: string): void;
+    /**
+     * Add context to trajectory
+     */
+    addTrajectoryContext(trajectoryId: number, contextId: string): void;
+    /**
+     * End trajectory and submit for learning
+     *
+     * @param trajectoryId - Trajectory ID
+     * @param success - Whether the task succeeded
+     * @param quality - Quality score (0-1)
+     * @returns Learning outcome
+     */
+    endTrajectory(trajectoryId: number, success: boolean, quality: number): LearningOutcome;
+    /**
+     * Find similar learned patterns
+     *
+     * Uses SONA's ReasoningBank for pattern retrieval
+     *
+     * @param embedding - Query embedding
+     * @param k - Number of patterns to return
+     */
+    findPatterns(embedding: number[], k?: number): JsLearnedPattern[];
+    /**
+     * Force a learning cycle
+     */
+    forceLearning(): string;
+    /**
+     * Start background learning timer
+     */
+    private startBackgroundLearning;
+    /**
+     * Get patterns count from SONA stats
+     */
+    private getPatternsCount;
+    /**
+     * Compute attention asynchronously
+     *
+     * Useful for large batches or when non-blocking is required
+     */
+    computeAttentionAsync(query: Float32Array, keys: Float32Array[], values: Float32Array[], type?: 'flash' | 'hyperbolic' | 'standard'): Promise<Float32Array>;
+    /**
+     * Compute Poincaré distance between two embeddings
+     *
+     * Useful for hierarchical agent structures
+     */
+    poincareDistance(a: Float32Array, b: Float32Array): number;
+    /**
+     * Project embedding to Poincaré ball
+     */
+    projectToPoincare(embedding: Float32Array): Float32Array;
+    /**
+     * Get intelligence layer statistics
+     */
+    getStats(): typeof this.stats & {
+        sonaStats?: any;
+    };
+    /**
+     * Enable/disable the intelligence layer
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Check if enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Cleanup resources
+     */
+    dispose(): void;
+}
+/**
+ * Create a default intelligence layer
+ */
+export declare function createIntelligenceLayer(config?: RuVectorIntelligenceConfig): RuVectorIntelligence;
+/**
+ * Presets for common configurations
+ */
+export declare const IntelligencePresets: {
+    /** Fast routing with MoE and minimal learning */
+    fast: {
+        attentionType: "moe";
+        numExperts: number;
+        topK: number;
+        enableTrajectories: boolean;
+        backgroundIntervalMs: number;
+    };
+    /** Balanced performance and learning */
+    balanced: {
+        attentionType: "moe";
+        numExperts: number;
+        topK: number;
+        enableTrajectories: boolean;
+        backgroundIntervalMs: number;
+        qualityThreshold: number;
+    };
+    /** Maximum learning for development */
+    learning: {
+        attentionType: "dual";
+        enableTrajectories: boolean;
+        backgroundIntervalMs: number;
+        qualityThreshold: number;
+        sonaConfig: {
+            microLoraRank: number;
+            baseLoraRank: number;
+            trajectoryCapacity: number;
+        };
+    };
+    /** Hierarchical structures (Poincaré geometry) */
+    hierarchical: {
+        attentionType: "hyperbolic";
+        curvature: number;
+        enableTrajectories: boolean;
+    };
+    /** Graph-based reasoning */
+    graph: {
+        attentionType: "graph";
+        enableTrajectories: boolean;
+    };
+};
+//# sourceMappingURL=RuVectorIntelligence.d.ts.map

package/dist/intelligence/RuVectorIntelligence.d.ts.map

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