agentic-qe 1.9.3 → 2.0.0

package/dist/core/memory/NeuralEnhancement.d.ts

@@ -0,0 +1,154 @@
+/**
+ * NeuralEnhancement - Neural Enhancement Layer for RuVector
+ *
+ * Implements AgentDB v2 neural capabilities:
+ * - Multi-head attention mechanism (8 heads) for query enhancement
+ * - Graph Neural Network layer for pattern relationship modeling
+ * - RL-based navigation for optimal traversal paths
+ * - Self-organizing capabilities for index maintenance
+ *
+ * @module core/memory/NeuralEnhancement
+ * @version 2.0.0
+ */
+import { TestPattern, PatternSearchResult, PatternSearchOptions, IPatternStore } from './IPatternStore';
+/**
+ * Neural layer configuration
+ */
+export interface NeuralConfig {
+    /** Number of attention heads (default: 8) */
+    attentionHeads?: number;
+    /** Embedding dimension (default: 384) */
+    embeddingDim?: number;
+    /** Enable Graph Neural Network */
+    enableGNN?: boolean;
+    /** Enable RL-based navigation */
+    enableRLNavigation?: boolean;
+    /** Learning rate for training (default: 0.001) */
+    learningRate?: number;
+    /** Discount factor for Q-learning (default: 0.95) */
+    gamma?: number;
+    /** Exploration rate for epsilon-greedy (default: 0.1) */
+    epsilon?: number;
+}
+/**
+ * Enhanced search options with neural features
+ */
+export interface EnhancedSearchOptions extends PatternSearchOptions {
+    /** Use attention mechanism */
+    useAttention?: boolean;
+    /** Use Graph Neural Network */
+    useGNN?: boolean;
+    /** Softmax temperature for diversity */
+    temperature?: number;
+}
+/**
+ * Attention mechanism output
+ */
+export interface AttentionOutput {
+    /** Enhanced embedding after attention */
+    enhancedEmbedding: number[];
+    /** Attention weights for interpretability */
+    attentionWeights: number[][];
+    /** Confidence score */
+    confidence: number;
+}
+/**
+ * Training feedback for RL
+ */
+export interface TrainingFeedback {
+    /** Pattern ID */
+    patternId: string;
+    /** Query embedding */
+    query: number[];
+    /** Success (1.0) or failure (0.0) */
+    reward: number;
+    /** Traversal path taken */
+    path?: string[];
+    /** Metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Training metrics
+ */
+export interface TrainingMetrics {
+    /** Number of samples processed */
+    samplesProcessed: number;
+    /** Average reward */
+    averageReward: number;
+    /** Loss value */
+    loss: number;
+    /** Training time in ms */
+    duration: number;
+}
+/**
+ * Neural Enhancement Layer
+ *
+ * Provides neural capabilities for RuVector pattern store:
+ * - Multi-head attention for query enhancement
+ * - Graph Neural Network for pattern relationships
+ * - Q-Learning for optimal search paths
+ */
+export declare class NeuralEnhancementLayer {
+    private readonly config;
+    private readonly attention;
+    private readonly gnn;
+    private readonly navigator;
+    private contextPatterns;
+    constructor(config?: NeuralConfig);
+    /**
+     * Apply attention to query embedding
+     */
+    enhanceQuery(embedding: number[], contextPatterns?: TestPattern[]): Promise<AttentionOutput>;
+    /**
+     * Build pattern relationship graph
+     */
+    buildPatternGraph(patterns: TestPattern[]): Promise<void>;
+    /**
+     * Find optimal traversal path using RL
+     */
+    findOptimalPath(start: number[], targets: TestPattern[], k: number): Promise<PatternSearchResult[]>;
+    /**
+     * Train on feedback (success/failure)
+     */
+    train(feedback: TrainingFeedback[]): Promise<TrainingMetrics>;
+    private findNearest;
+    private fallbackSearch;
+    private cosineSimilarity;
+}
+/**
+ * Neural Pattern Store - Enhanced pattern store with neural capabilities
+ *
+ * Wraps an existing IPatternStore with neural enhancements:
+ * - Attention-based query enhancement
+ * - GNN-based pattern relationships
+ * - RL-based optimal search paths
+ */
+export declare class NeuralPatternStore implements IPatternStore {
+    private readonly baseStore;
+    private readonly neural;
+    private patterns;
+    constructor(baseStore: IPatternStore, neural: NeuralEnhancementLayer);
+    initialize(): Promise<void>;
+    storePattern(pattern: TestPattern): Promise<void>;
+    storeBatch(patterns: TestPattern[]): Promise<void>;
+    /**
+     * Enhanced search with neural capabilities
+     */
+    searchSimilar(queryEmbedding: number[], options?: EnhancedSearchOptions): Promise<PatternSearchResult[]>;
+    getPattern(id: string): Promise<TestPattern | null>;
+    deletePattern(id: string): Promise<boolean>;
+    recordUsage(id: string): Promise<void>;
+    buildIndex(): Promise<void>;
+    optimize(): Promise<void>;
+    getStats(): Promise<any>;
+    clear(): Promise<void>;
+    shutdown(): Promise<void>;
+    getImplementationInfo(): any;
+    /**
+     * Train neural layer on feedback
+     */
+    trainNeural(feedback: TrainingFeedback[]): Promise<TrainingMetrics>;
+    private rebuildNeuralGraph;
+    private cosineSimilarity;
+}
+//# sourceMappingURL=NeuralEnhancement.d.ts.map

package/dist/core/memory/NeuralEnhancement.d.ts.map

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