agentdb 1.6.0 → 2.0.0-alpha.1

package/dist/backends/ruvector/RuVectorBackend.js.map

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

package/dist/backends/ruvector/RuVectorLearning.d.ts

@@ -0,0 +1,104 @@
+/**
+ * RuVectorLearning - GNN-Enhanced Vector Search
+ *
+ * Integrates Graph Neural Networks for query enhancement using @ruvector/gnn.
+ * Requires optional @ruvector/gnn package.
+ *
+ * Features:
+ * - Query enhancement using neighbor context with multi-head attention
+ * - Differentiable search with soft weights
+ * - Hierarchical forward pass through GNN layers
+ * - Graceful degradation when GNN not available
+ *
+ * Note: @ruvector/gnn provides stateless GNN layers (inference only).
+ * Training is handled separately by the consuming application.
+ */
+export interface LearningConfig {
+    inputDim: number;
+    hiddenDim: number;
+    heads: number;
+    dropout?: number;
+}
+export interface EnhancementOptions {
+    temperature?: number;
+    k?: number;
+}
+export declare class RuVectorLearning {
+    private gnnLayer;
+    private config;
+    private initialized;
+    private differentiableSearch;
+    private hierarchicalForward;
+    constructor(config: LearningConfig);
+    /**
+     * Initialize GNN layer with optional dependency handling
+     */
+    initialize(): Promise<void>;
+    /**
+     * Enhance query embedding using neighbor context
+     *
+     * Uses Graph Attention Network to aggregate information from
+     * nearest neighbors, weighted by their relevance scores.
+     *
+     * @param query - Query embedding to enhance
+     * @param neighbors - Neighbor embeddings
+     * @param weights - Edge weights (relevance scores)
+     * @returns Enhanced query embedding
+     */
+    enhance(query: Float32Array, neighbors: Float32Array[], weights: number[]): Float32Array;
+    /**
+     * Differentiable search with soft attention
+     *
+     * Uses soft attention mechanism instead of hard top-k selection.
+     * Returns indices and weights that can be used for gradient-based optimization.
+     *
+     * @param query - Query embedding
+     * @param candidates - Candidate embeddings
+     * @param options - Search options
+     * @returns Search result with indices and soft weights
+     */
+    search(query: Float32Array, candidates: Float32Array[], options?: EnhancementOptions): {
+        indices: number[];
+        weights: number[];
+    };
+    /**
+     * Hierarchical forward pass through multiple GNN layers
+     *
+     * Used for HNSW-style hierarchical search where embeddings
+     * are organized by graph layers.
+     *
+     * @param query - Query embedding
+     * @param layerEmbeddings - Embeddings organized by layer
+     * @returns Final enhanced embedding
+     */
+    enhanceHierarchical(query: Float32Array, layerEmbeddings: Float32Array[][]): Float32Array;
+    /**
+     * Serialize GNN layer to JSON
+     *
+     * Allows saving/loading the GNN layer configuration.
+     *
+     * @returns JSON string representation
+     */
+    toJson(): string;
+    /**
+     * Create GNN layer from JSON
+     *
+     * @param json - JSON string from toJson()
+     * @returns New RuVectorLearning instance
+     */
+    static fromJson(json: string, config: LearningConfig): Promise<RuVectorLearning>;
+    /**
+     * Get current state
+     */
+    getState(): {
+        initialized: boolean;
+        config: LearningConfig;
+        hiddenDim: number;
+        heads: number;
+    };
+    /**
+     * Ensure GNN is initialized before operations
+     */
+    private ensureInitialized;
+}
+//# sourceMappingURL=RuVectorLearning.d.ts.map

package/dist/backends/ruvector/RuVectorLearning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuVectorLearning.d.ts","sourceRoot":"","sources":["../../../src/backends/ruvector/RuVectorLearning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,CAAC,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,oBAAoB,CAAM;IAClC,OAAO,CAAC,mBAAmB,CAAM;gBAErB,MAAM,EAAE,cAAc;IAOlC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BjC;;;;;;;;;;OAUG;IACH,OAAO,CACL,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,YAAY,EAAE,EACzB,OAAO,EAAE,MAAM,EAAE,GAChB,YAAY;IAsBf;;;;;;;;;;OAUG;IACH,MAAM,CACJ,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,YAAY,EAAE,EAC1B,OAAO,GAAE,kBAAuB,GAC/B;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;IAyB3C;;;;;;;;;OASG;IACH,mBAAmB,CACjB,KAAK,EAAE,YAAY,EACnB,eAAe,EAAE,YAAY,EAAE,EAAE,GAChC,YAAY;IAwBf;;;;;;OAMG;IACH,MAAM,IAAI,MAAM;IAKhB;;;;;OAKG;WACU,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAatF;;OAEG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,OAAO,CAAC;QACrB,MAAM,EAAE,cAAc,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf;IASD;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAK1B"}

package/dist/backends/ruvector/RuVectorLearning.js

@@ -0,0 +1,177 @@
+/**
+ * RuVectorLearning - GNN-Enhanced Vector Search
+ *
+ * Integrates Graph Neural Networks for query enhancement using @ruvector/gnn.
+ * Requires optional @ruvector/gnn package.
+ *
+ * Features:
+ * - Query enhancement using neighbor context with multi-head attention
+ * - Differentiable search with soft weights
+ * - Hierarchical forward pass through GNN layers
+ * - Graceful degradation when GNN not available
+ *
+ * Note: @ruvector/gnn provides stateless GNN layers (inference only).
+ * Training is handled separately by the consuming application.
+ */
+export class RuVectorLearning {
+    gnnLayer; // RuvectorLayer from @ruvector/gnn
+    config;
+    initialized = false;
+    differentiableSearch;
+    hierarchicalForward;
+    constructor(config) {
+        this.config = {
+            ...config,
+            dropout: config.dropout ?? 0.1,
+        };
+    }
+    /**
+     * Initialize GNN layer with optional dependency handling
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        try {
+            // Dynamic import with runtime property access
+            const gnnModule = await import('@ruvector/gnn');
+            this.gnnLayer = new gnnModule.RuvectorLayer(this.config.inputDim, this.config.hiddenDim, this.config.heads, this.config.dropout);
+            this.differentiableSearch = gnnModule.differentiableSearch;
+            this.hierarchicalForward = gnnModule.hierarchicalForward;
+            this.initialized = true;
+        }
+        catch (error) {
+            throw new Error(`GNN initialization failed. Please install: npm install @ruvector/gnn\n` +
+                `Error: ${error.message}`);
+        }
+    }
+    /**
+     * Enhance query embedding using neighbor context
+     *
+     * Uses Graph Attention Network to aggregate information from
+     * nearest neighbors, weighted by their relevance scores.
+     *
+     * @param query - Query embedding to enhance
+     * @param neighbors - Neighbor embeddings
+     * @param weights - Edge weights (relevance scores)
+     * @returns Enhanced query embedding
+     */
+    enhance(query, neighbors, weights) {
+        this.ensureInitialized();
+        if (neighbors.length === 0) {
+            return query;
+        }
+        try {
+            // Forward pass through GNN layer
+            const result = this.gnnLayer.forward(Array.from(query), neighbors.map(n => Array.from(n)), weights);
+            return new Float32Array(result);
+        }
+        catch (error) {
+            console.warn(`[RuVectorLearning] Enhancement failed: ${error.message}`);
+            return query;
+        }
+    }
+    /**
+     * Differentiable search with soft attention
+     *
+     * Uses soft attention mechanism instead of hard top-k selection.
+     * Returns indices and weights that can be used for gradient-based optimization.
+     *
+     * @param query - Query embedding
+     * @param candidates - Candidate embeddings
+     * @param options - Search options
+     * @returns Search result with indices and soft weights
+     */
+    search(query, candidates, options = {}) {
+        this.ensureInitialized();
+        const k = options.k ?? Math.min(5, candidates.length);
+        const temperature = options.temperature ?? 1.0;
+        try {
+            const result = this.differentiableSearch(Array.from(query), candidates.map(c => Array.from(c)), k, temperature);
+            return result;
+        }
+        catch (error) {
+            console.warn(`[RuVectorLearning] Differentiable search failed: ${error.message}`);
+            // Fallback: return top-k indices with uniform weights
+            return {
+                indices: Array.from({ length: k }, (_, i) => i),
+                weights: Array.from({ length: k }, () => 1.0 / k)
+            };
+        }
+    }
+    /**
+     * Hierarchical forward pass through multiple GNN layers
+     *
+     * Used for HNSW-style hierarchical search where embeddings
+     * are organized by graph layers.
+     *
+     * @param query - Query embedding
+     * @param layerEmbeddings - Embeddings organized by layer
+     * @returns Final enhanced embedding
+     */
+    enhanceHierarchical(query, layerEmbeddings) {
+        this.ensureInitialized();
+        if (layerEmbeddings.length === 0) {
+            return query;
+        }
+        try {
+            // Serialize GNN layer for hierarchical processing
+            const layerJson = this.gnnLayer.toJson();
+            const result = this.hierarchicalForward(Array.from(query), layerEmbeddings.map(layer => layer.map(e => Array.from(e))), [layerJson] // Single layer for now
+            );
+            return new Float32Array(result);
+        }
+        catch (error) {
+            console.warn(`[RuVectorLearning] Hierarchical enhancement failed: ${error.message}`);
+            return query;
+        }
+    }
+    /**
+     * Serialize GNN layer to JSON
+     *
+     * Allows saving/loading the GNN layer configuration.
+     *
+     * @returns JSON string representation
+     */
+    toJson() {
+        this.ensureInitialized();
+        return this.gnnLayer.toJson();
+    }
+    /**
+     * Create GNN layer from JSON
+     *
+     * @param json - JSON string from toJson()
+     * @returns New RuVectorLearning instance
+     */
+    static async fromJson(json, config) {
+        const learning = new RuVectorLearning(config);
+        await learning.initialize();
+        try {
+            const gnnModule = await import('@ruvector/gnn');
+            learning.gnnLayer = gnnModule.RuvectorLayer.fromJson(json);
+            return learning;
+        }
+        catch (error) {
+            throw new Error(`Failed to load GNN from JSON: ${error.message}`);
+        }
+    }
+    /**
+     * Get current state
+     */
+    getState() {
+        return {
+            initialized: this.initialized,
+            config: this.config,
+            hiddenDim: this.config.hiddenDim,
+            heads: this.config.heads,
+        };
+    }
+    /**
+     * Ensure GNN is initialized before operations
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('RuVectorLearning not initialized. Call initialize() first.');
+        }
+    }
+}
+//# sourceMappingURL=RuVectorLearning.js.map

package/dist/backends/ruvector/RuVectorLearning.js.map

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

package/dist/backends/ruvector/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * RuVector Backend - Exports
+ *
+ * High-performance vector storage with optional GNN learning.
+ */
+export { RuVectorBackend } from './RuVectorBackend.js';
+export { RuVectorLearning } from './RuVectorLearning.js';
+export type { LearningConfig, EnhancementOptions } from './RuVectorLearning.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backends/ruvector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backends/ruvector/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/backends/ruvector/index.js

@@ -0,0 +1,8 @@
+/**
+ * RuVector Backend - Exports
+ *
+ * High-performance vector storage with optional GNN learning.
+ */
+export { RuVectorBackend } from './RuVectorBackend.js';
+export { RuVectorLearning } from './RuVectorLearning.js';
+//# sourceMappingURL=index.js.map

package/dist/backends/ruvector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backends/ruvector/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/browser/AdvancedFeatures.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Advanced Features for AgentDB Browser
+ *
+ * Includes:
+ * - GNN (Graph Neural Networks) - Graph attention and message passing
+ * - MMR (Maximal Marginal Relevance) - Diversity ranking
+ * - SVD (Singular Value Decomposition) - Tensor compression
+ * - Batch operations and utilities
+ */
+export interface GNNNode {
+    id: number;
+    features: Float32Array;
+    neighbors: number[];
+}
+export interface GNNEdge {
+    from: number;
+    to: number;
+    weight: number;
+}
+export interface GNNConfig {
+    hiddenDim: number;
+    numHeads: number;
+    dropout: number;
+    learningRate: number;
+    attentionType: 'gat' | 'gcn' | 'sage';
+}
+/**
+ * Graph Neural Network with attention mechanism
+ */
+export declare class GraphNeuralNetwork {
+    private config;
+    private nodes;
+    private edges;
+    private attentionWeights;
+    constructor(config?: Partial<GNNConfig>);
+    /**
+     * Add node to graph
+     */
+    addNode(id: number, features: Float32Array): void;
+    /**
+     * Add edge to graph
+     */
+    addEdge(from: number, to: number, weight?: number): void;
+    /**
+     * Graph Attention Network (GAT) message passing
+     */
+    graphAttention(nodeId: number): Float32Array;
+    /**
+     * Compute attention score between two nodes
+     */
+    private computeAttentionScore;
+    /**
+     * Message passing for all nodes
+     */
+    messagePass(): Map<number, Float32Array>;
+    /**
+     * Update node features after message passing
+     */
+    update(newFeatures: Map<number, Float32Array>): void;
+    /**
+     * Compute graph embeddings for query enhancement
+     */
+    computeGraphEmbedding(nodeId: number, hops?: number): Float32Array;
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        numNodes: number;
+        numEdges: number;
+        avgDegree: number;
+        config: GNNConfig;
+    };
+}
+export interface MMRConfig {
+    lambda: number;
+    metric: 'cosine' | 'euclidean';
+}
+/**
+ * Maximal Marginal Relevance for diversity ranking
+ */
+export declare class MaximalMarginalRelevance {
+    private config;
+    constructor(config?: Partial<MMRConfig>);
+    /**
+     * Rerank results for diversity
+     * @param query Query vector
+     * @param candidates Candidate vectors with scores
+     * @param k Number of results to return
+     * @returns Reranked indices
+     */
+    rerank(query: Float32Array, candidates: Array<{
+        id: number;
+        vector: Float32Array;
+        score: number;
+    }>, k: number): number[];
+    /**
+     * Similarity computation
+     */
+    private similarity;
+    private cosineSimilarity;
+    private euclideanDistance;
+    /**
+     * Set lambda (relevance vs diversity trade-off)
+     */
+    setLambda(lambda: number): void;
+}
+/**
+ * Simple SVD implementation for dimension reduction
+ */
+export declare class TensorCompression {
+    /**
+     * Reduce dimensionality using truncated SVD
+     * @param vectors Array of vectors to compress
+     * @param targetDim Target dimension
+     * @returns Compressed vectors
+     */
+    static compress(vectors: Float32Array[], targetDim: number): Float32Array[];
+    /**
+     * Compute mean vector
+     */
+    private static computeMean;
+    /**
+     * Compute covariance matrix
+     */
+    private static computeCovariance;
+    /**
+     * Power iteration for computing top eigenvectors
+     */
+    private static powerIteration;
+}
+/**
+ * Efficient batch processing utilities
+ */
+export declare class BatchProcessor {
+    /**
+     * Batch cosine similarity computation
+     */
+    static batchCosineSimilarity(query: Float32Array, vectors: Float32Array[]): Float32Array;
+    /**
+     * Batch vector normalization
+     */
+    static batchNormalize(vectors: Float32Array[]): Float32Array[];
+}
+//# sourceMappingURL=AdvancedFeatures.d.ts.map

package/dist/browser/AdvancedFeatures.d.ts.map

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