agentdb 3.0.0-alpha.2 → 3.0.0-alpha.4

package/dist/src/wrappers/agentdb-fast.d.ts.map

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

package/dist/src/wrappers/agentdb-fast.js

@@ -1,316 +0,0 @@
-/**
- * AgentDB Fast API
- *
- * Provides programmatic access to AgentDB without CLI overhead
- * Eliminates 2.3s overhead from process spawning and transformers.js init
- */
-import { AgentDB } from '../core/AgentDB.js';
-import { EventEmitter } from 'events';
-/**
- * Fast AgentDB client that avoids CLI overhead
- *
- * Performance:
- * - CLI: ~2,350ms per operation
- * - Direct API: ~10-50ms per operation
- * - Speedup: ~50-200x faster
- */
-export class AgentDBFast extends EventEmitter {
-    db = null;
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- dynamic backend type depends on runtime initialization
-    backend = null;
-    config;
-    initialized = false;
-    embeddingCache = new Map();
-    constructor(config = {}) {
-        super();
-        this.config = {
-            path: config.path || '.agentdb-fast',
-            vectorDimensions: config.vectorDimensions || 384,
-            enableHNSW: config.enableHNSW !== false,
-            hnswM: config.hnswM || 16,
-            hnswEfConstruction: config.hnswEfConstruction || 200
-        };
-    }
-    /**
-     * Initialize database connection (lazy)
-     */
-    async initialize() {
-        if (this.initialized)
-            return;
-        try {
-            // Create AgentDB instance (dimensions are set via vector backend, not constructor)
-            this.db = new AgentDB({
-                dbPath: this.config.path
-            });
-            await this.db.initialize();
-            // Access the vector backend directly (it's a property, not a method)
-            if (this.db.vectorBackend) {
-                this.backend = this.db.vectorBackend;
-            }
-            else {
-                throw new Error('Vector backend not available');
-            }
-            this.initialized = true;
-            this.emit('initialized');
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize AgentDB: ${error.message}`);
-        }
-    }
-    /**
-     * Store an episode (fast, no CLI overhead)
-     */
-    async storeEpisode(episode) {
-        await this.initialize();
-        // Generate embedding if not provided
-        if (!episode.embedding) {
-            episode.embedding = await this.getEmbedding(episode.task);
-        }
-        const episodeId = episode.id || this.generateId('episode');
-        // Use backend insert method
-        if (!this.backend) {
-            throw new Error('Backend not initialized');
-        }
-        await this.backend.insert(episodeId, new Float32Array(episode.embedding), {
-            type: 'episode',
-            sessionId: episode.sessionId,
-            task: episode.task,
-            trajectory: JSON.stringify(episode.trajectory),
-            reward: episode.reward,
-            quality: episode.quality,
-            context: episode.context,
-            timestamp: episode.timestamp || Date.now()
-        });
-        this.emit('episode:stored', episodeId);
-        return episodeId;
-    }
-    /**
-     * Retrieve episodes by task similarity (fast)
-     */
-    async retrieveEpisodes(options) {
-        await this.initialize();
-        const dimensions = this.config.vectorDimensions ?? 384;
-        const queryEmbedding = options.task
-            ? await this.getEmbedding(options.task)
-            : Array(dimensions).fill(0);
-        const k = options.k || 5;
-        // Build filter
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- filter values can be primitives or MongoDB-style query objects
-        const filter = { type: 'episode' };
-        if (options.sessionId)
-            filter.sessionId = options.sessionId;
-        if (options.minReward !== undefined)
-            filter.reward = { $gte: options.minReward };
-        if (options.maxReward !== undefined) {
-            filter.reward = { ...(filter.reward || {}), $lte: options.maxReward };
-        }
-        if (!this.backend) {
-            throw new Error('Backend not initialized');
-        }
-        const results = await this.backend.search(new Float32Array(queryEmbedding), k, { filter: Object.keys(filter).length > 1 ? filter : undefined });
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- backend search returns dynamic result shape
-        return results.map((result) => ({
-            id: result.id,
-            sessionId: result.metadata.sessionId,
-            task: result.metadata.task,
-            trajectory: JSON.parse(result.metadata.trajectory || '[]'),
-            reward: result.metadata.reward,
-            quality: result.metadata.quality,
-            embedding: result.vector,
-            context: result.metadata.context,
-            timestamp: result.metadata.timestamp
-        }));
-    }
-    /**
-     * Store a pattern (for ReasoningBank)
-     */
-    async storePattern(pattern) {
-        await this.initialize();
-        if (!pattern.embedding) {
-            pattern.embedding = await this.getEmbedding(`${pattern.input} ${pattern.output}`);
-        }
-        const patternId = pattern.id || this.generateId('pattern');
-        if (!this.backend) {
-            throw new Error('Backend not initialized');
-        }
-        await this.backend.insert(patternId, new Float32Array(pattern.embedding), {
-            type: 'pattern',
-            task: pattern.task,
-            input: pattern.input,
-            output: pattern.output,
-            quality: pattern.quality,
-            context: pattern.context,
-            timestamp: pattern.timestamp || Date.now()
-        });
-        this.emit('pattern:stored', patternId);
-        return patternId;
-    }
-    /**
-     * Search for similar patterns
-     */
-    async searchPatterns(query, k = 5, minQuality) {
-        await this.initialize();
-        const queryEmbedding = await this.getEmbedding(query);
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- filter values can be primitives or MongoDB-style query objects
-        const filter = { type: 'pattern' };
-        if (minQuality !== undefined) {
-            filter.quality = { $gte: minQuality };
-        }
-        if (!this.backend) {
-            throw new Error('Backend not initialized');
-        }
-        const results = await this.backend.search(new Float32Array(queryEmbedding), k, { filter: Object.keys(filter).length > 1 ? filter : undefined });
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- backend search returns dynamic result shape
-        return results.map((result) => ({
-            id: result.id,
-            task: result.metadata.task,
-            input: result.metadata.input,
-            output: result.metadata.output,
-            quality: result.metadata.quality,
-            embedding: result.vector,
-            context: result.metadata.context,
-            timestamp: result.metadata.timestamp
-        }));
-    }
-    /**
-     * Get database statistics
-     */
-    async getStats() {
-        await this.initialize();
-        if (!this.backend) {
-            throw new Error('Backend not initialized');
-        }
-        const stats = await this.backend.stats();
-        // Count by type - get all results
-        const allResults = await this.backend.search(new Float32Array(this.config.vectorDimensions).fill(0), 10000, // Get all
-        {});
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- backend search returns dynamic result shape
-        const episodes = allResults.filter((r) => r.metadata?.type === 'episode');
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- backend search returns dynamic result shape
-        const patterns = allResults.filter((r) => r.metadata?.type === 'pattern');
-        const avgQuality = 
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any -- backend search returns dynamic result shape
-        patterns.reduce((sum, p) => sum + (p.metadata?.quality || 0), 0) /
-            (patterns.length || 1);
-        return {
-            totalVectors: stats.totalVectors || allResults.length || 0,
-            totalEpisodes: episodes.length,
-            totalPatterns: patterns.length,
-            avgQuality
-        };
-    }
-    /**
-     * Close database connection
-     */
-    async close() {
-        this.removeAllListeners();
-        this.embeddingCache.clear();
-        if (this.db) {
-            await this.db.close();
-            this.db = null;
-            this.backend = null;
-        }
-        this.initialized = false;
-    }
-    /**
-     * Generate embedding for text (with caching)
-     *
-     * Note: This is a simple mock. In production, replace with:
-     * - OpenAI embeddings API
-     * - Local transformer model
-     * - SentenceTransformers
-     */
-    async getEmbedding(text) {
-        // Check cache
-        if (this.embeddingCache.has(text)) {
-            return this.embeddingCache.get(text);
-        }
-        // Simple hash-based embedding (REPLACE IN PRODUCTION)
-        const embedding = this.simpleHashEmbedding(text);
-        // Cache it
-        this.embeddingCache.set(text, embedding);
-        if (this.embeddingCache.size > 1000) {
-            // LRU-style cleanup
-            const firstKey = this.embeddingCache.keys().next().value;
-            if (firstKey) {
-                this.embeddingCache.delete(firstKey);
-            }
-        }
-        return embedding;
-    }
-    /**
-     * Simple hash-based embedding (MOCK - REPLACE IN PRODUCTION)
-     *
-     * Production alternatives:
-     * 1. OpenAI: https://platform.openai.com/docs/guides/embeddings
-     * 2. Transformers.js: https://huggingface.co/docs/transformers.js
-     * 3. SBERT: https://www.sbert.net/
-     */
-    simpleHashEmbedding(text) {
-        const embedding = new Array(this.config.vectorDimensions);
-        // Seed with text hash
-        let hash = 0;
-        for (let i = 0; i < text.length; i++) {
-            hash = (hash << 5) - hash + text.charCodeAt(i);
-            hash = hash & hash;
-        }
-        // Generate pseudo-random embedding
-        for (let i = 0; i < this.config.vectorDimensions; i++) {
-            const seed = hash + i * 2654435761;
-            const x = Math.sin(seed) * 10000;
-            embedding[i] = x - Math.floor(x);
-        }
-        // Normalize
-        const norm = Math.sqrt(embedding.reduce((sum, v) => sum + v * v, 0));
-        return embedding.map(v => v / norm);
-    }
-    /**
-     * Generate unique ID
-     */
-    generateId(prefix) {
-        return `${prefix}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-    }
-}
-/**
- * Convenience function to create a fast AgentDB client
- */
-export function createFastAgentDB(config) {
-    return new AgentDBFast(config);
-}
-/**
- * Performance comparison helper
- */
-export async function benchmarkAgentDB() {
-    const client = createFastAgentDB({ path: '.agentdb-benchmark' });
-    // API benchmark
-    const apiStoreStart = Date.now();
-    await client.storeEpisode({
-        sessionId: 'test-session',
-        task: 'test-task',
-        trajectory: ['step1', 'step2'],
-        reward: 0.8
-    });
-    const apiStoreTime = Date.now() - apiStoreStart;
-    const apiRetrieveStart = Date.now();
-    await client.retrieveEpisodes({ task: 'test-task', k: 5 });
-    const apiRetrieveTime = Date.now() - apiRetrieveStart;
-    await client.close();
-    // CLI times from benchmarks
-    const cliStoreTime = 2350;
-    const cliRetrieveTime = 2400;
-    return {
-        cli: {
-            store: cliStoreTime,
-            retrieve: cliRetrieveTime
-        },
-        api: {
-            store: apiStoreTime,
-            retrieve: apiRetrieveTime
-        },
-        speedup: {
-            store: cliStoreTime / apiStoreTime,
-            retrieve: cliRetrieveTime / apiRetrieveTime
-        }
-    };
-}
-//# sourceMappingURL=agentdb-fast.js.map

package/dist/src/wrappers/agentdb-fast.js.map

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

package/dist/src/wrappers/attention-fallbacks.d.ts

@@ -1,351 +0,0 @@
-/**
- * Attention Module Fallbacks
- *
- * Since @ruvector/attention is completely broken, provide JavaScript fallbacks
- * Performance will be slower but functionality will work
- *
- * Optimized version includes:
- * - SIMD-style loop unrolling (8x with separate accumulators)
- * - Pre-allocated buffer pools for intermediate results
- * - Numerically stable fused softmax operations
- * - TypedArray optimizations (Float32Array)
- * - Batch processing capabilities
- * - Flash attention with improved tiling strategy
- */
-export interface AttentionConfig {
-    hiddenDim: number;
-    numHeads?: number;
-    dropoutRate?: number;
-    useFlash?: boolean;
-}
-/**
- * 8x unrolled scaled add: output[i] = a[i] + scale * b[i]
- */
-export declare function scaledAdd8x(output: Float32Array, a: Float32Array, b: Float32Array, scale: number, length: number): void;
-/**
- * Softmax returning new array (when in-place not desired)
- */
-export declare function softmaxOptimized(input: Float32Array): Float32Array;
-/**
- * Scaled Dot-Product Attention
- * The core attention mechanism
- */
-export declare function scaledDotProductAttention(query: number[], key: number[], value: number[], mask?: number[]): {
-    output: number[];
-    weights: number[];
-};
-/**
- * Optimized scaled dot-product attention using TypedArrays and SIMD-style ops
- */
-export declare function scaledDotProductAttentionOptimized(query: Float32Array, key: Float32Array, value: Float32Array, mask?: Float32Array | null): {
-    output: Float32Array;
-    weights: Float32Array;
-};
-/**
- * Batch scaled dot-product attention for processing multiple queries at once
- * Processes multiple Q-K-V triplets efficiently
- */
-export declare function batchScaledDotProductAttention(queries: Float32Array[], keys: Float32Array[], values: Float32Array[], masks?: (Float32Array | null)[]): {
-    outputs: Float32Array[];
-    weights: Float32Array[];
-};
-/**
- * Full attention computation over sequences (Q, K, V matrices)
- * Returns attention output and weights for all query positions
- */
-export declare function batchSequenceAttention(queries: Float32Array, // [seqLen * dim] flattened
-keys: Float32Array, // [seqLen * dim] flattened
-values: Float32Array, // [seqLen * dim] flattened
-seqLen: number, dim: number, mask?: Float32Array): {
-    output: Float32Array;
-    weights: Float32Array;
-};
-/**
- * Multi-Head Attention (JavaScript fallback)
- *
- * Replaces broken @ruvector/attention.multiHeadAttention
- */
-export declare class MultiHeadAttention {
-    private numHeads;
-    private hiddenDim;
-    private headDim;
-    private queryWeights;
-    private keyWeights;
-    private valueWeights;
-    private outputWeights;
-    constructor(config: AttentionConfig);
-    private initializeWeights;
-    private initializeOutputWeights;
-    forward(query: number[], key: number[], value: number[], mask?: number[]): {
-        output: number[];
-        attentionWeights: number[][];
-    };
-    private project;
-}
-/**
- * Optimized Multi-Head Attention using TypedArrays and pre-allocated buffers
- *
- * Improvements over original:
- * - Float32Array instead of number[]
- * - Pre-allocated weight matrices in contiguous memory
- * - 8x loop unrolling for projections
- * - Buffer pool for intermediate results
- * - Batch processing support
- */
-export declare class MultiHeadAttentionOptimized {
-    private numHeads;
-    private hiddenDim;
-    private headDim;
-    private queryWeights;
-    private keyWeights;
-    private valueWeights;
-    private outputWeights;
-    private headBuffer;
-    private projBuffer;
-    private concatBuffer;
-    constructor(config: AttentionConfig);
-    private initializeProjectionWeights;
-    private initializeOutputWeights;
-    /**
-     * Forward pass with optimized TypedArray operations
-     */
-    forward(query: Float32Array, key: Float32Array, value: Float32Array, mask?: Float32Array | null): {
-        output: Float32Array;
-        attentionWeights: Float32Array[];
-    };
-    /**
-     * Batch forward pass for multiple inputs
-     */
-    batchForward(queries: Float32Array[], keys: Float32Array[], values: Float32Array[], masks?: (Float32Array | null)[]): {
-        outputs: Float32Array[];
-        attentionWeights: Float32Array[][];
-    };
-    /**
-     * Optimized projection using contiguous weight storage and 8x unrolling
-     */
-    private projectOptimized;
-    /**
-     * Release buffers back to pool (call when done with outputs)
-     */
-    releaseBuffer(buffer: Float32Array): void;
-    /**
-     * Get weight matrices (for serialization/loading)
-     */
-    getWeights(): {
-        query: Float32Array;
-        key: Float32Array;
-        value: Float32Array;
-        output: Float32Array;
-    };
-    /**
-     * Set weight matrices (for loading pre-trained weights)
-     */
-    setWeights(weights: {
-        query: Float32Array;
-        key: Float32Array;
-        value: Float32Array;
-        output: Float32Array;
-    }): void;
-}
-/**
- * Flash Attention (optimized fallback)
- *
- * Replaces broken @ruvector/attention.flashAttention
- * Uses tiling/chunking for better memory efficiency
- */
-export declare class FlashAttention {
-    private hiddenDim;
-    private blockSize;
-    constructor(config: AttentionConfig);
-    forward(query: number[][], key: number[][], value: number[][], numHeads?: number): {
-        output: number[][];
-        attentionScores: number[][];
-    };
-}
-/**
- * Flash Attention Configuration
- */
-export interface FlashAttentionConfig extends AttentionConfig {
-    blockSizeQ?: number;
-    blockSizeKV?: number;
-    causal?: boolean;
-}
-/**
- * Optimized Flash Attention using TypedArrays and improved tiling strategy
- *
- * Improvements over original:
- * - Separate Q and KV block sizes for better memory usage
- * - Online softmax computation (memory efficient)
- * - Pre-allocated buffers for all intermediate results
- * - 8x loop unrolling for score computation
- * - Causal masking support
- * - Backward pass placeholder for gradient computation
- */
-export declare class FlashAttentionOptimized {
-    private hiddenDim;
-    private blockSizeQ;
-    private blockSizeKV;
-    private causal;
-    private scoresBuffer;
-    private expBuffer;
-    private outputBuffer;
-    private maxBuffer;
-    private sumBuffer;
-    constructor(config: FlashAttentionConfig);
-    /**
-     * Forward pass with optimized tiling strategy
-     * Uses online softmax for memory efficiency
-     */
-    forward(query: Float32Array, // [seqLen * dim] flattened
-    key: Float32Array, // [seqLen * dim] flattened
-    value: Float32Array, // [seqLen * dim] flattened
-    seqLen: number, dim: number, numHeads?: number): {
-        output: Float32Array;
-        attentionScores: Float32Array;
-    };
-    /**
-     * Compute attention scores for a block pair with 8x unrolling
-     */
-    private computeBlockScores;
-    /**
-     * Online softmax update with output accumulation
-     * This is the core of flash attention's memory efficiency
-     */
-    private updateOnlineSoftmax;
-    /**
-     * Batch forward for processing multiple sequences
-     */
-    batchForward(queries: Float32Array[], keys: Float32Array[], values: Float32Array[], seqLens: number[], dim: number, numHeads?: number): {
-        outputs: Float32Array[];
-        attentionScores: Float32Array[];
-    };
-    /**
-     * Backward pass for gradient computation
-     * Computes dQ, dK, dV from dOutput using the attention scores from forward pass
-     *
-     * Forward pass recap:
-     *   S = Q @ K^T / sqrt(d)     (scaled dot-product scores)
-     *   A = softmax(S)            (attention weights)
-     *   O = A @ V                 (output)
-     *
-     * Backward pass:
-     *   dV = A^T @ dO             (gradient w.r.t. values)
-     *   dA = dO @ V^T             (gradient through output)
-     *   dS = A * (dA - sum(dA * A, axis=-1, keepdims=True))  (softmax backward)
-     *   dS = dS / sqrt(d)         (apply scaling)
-     *   dQ = dS @ K               (gradient w.r.t. queries)
-     *   dK = dS^T @ Q             (gradient w.r.t. keys)
-     */
-    backward(dOutput: Float32Array, query: Float32Array, key: Float32Array, value: Float32Array, attentionScores: Float32Array, seqLen: number, dim: number): {
-        dQuery: Float32Array;
-        dKey: Float32Array;
-        dValue: Float32Array;
-    };
-    /**
-     * Release buffers back to pool
-     */
-    releaseBuffer(buffer: Float32Array): void;
-}
-/**
- * Batch multi-head attention for processing multiple queries efficiently
- * Combines optimized MHA with batch processing
- */
-export declare function batchMultiHeadAttention(attention: MultiHeadAttentionOptimized, queries: Float32Array[], keys: Float32Array[], values: Float32Array[], masks?: (Float32Array | null)[]): {
-    outputs: Float32Array[];
-    attentionWeights: Float32Array[][];
-};
-/**
- * Linear Attention (fallback)
- *
- * O(n) complexity approximation of attention
- */
-export declare class LinearAttention {
-    private hiddenDim;
-    private featureMap;
-    constructor(config: AttentionConfig);
-    forward(query: number[][], key: number[][], value: number[][]): {
-        output: number[][];
-    };
-}
-/**
- * Hyperbolic Attention (simplified fallback)
- *
- * Approximation using hyperbolic geometry
- */
-export declare class HyperbolicAttention {
-    private hiddenDim;
-    private curvature;
-    constructor(config: AttentionConfig);
-    forward(query: number[], key: number[], value: number[]): {
-        output: number[];
-        distance: number;
-    };
-    private hyperbolicDistance;
-}
-/**
- * MoE (Mixture of Experts) Attention (fallback)
- *
- * Routes to different expert attention modules
- */
-export declare class MoEAttention {
-    private experts;
-    private numExperts;
-    private gatingWeights;
-    constructor(config: AttentionConfig & {
-        numExperts?: number;
-    });
-    forward(query: number[], key: number[], value: number[], topK?: number): {
-        output: number[];
-        expertWeights: number[];
-    };
-}
-/**
- * Check if native attention is available
- */
-export declare function isNativeAttentionAvailable(): boolean;
-/**
- * Factory function to create appropriate attention module
- */
-export declare function createAttention(type: 'multi-head' | 'flash' | 'linear' | 'hyperbolic' | 'moe', config: AttentionConfig): MultiHeadAttention | FlashAttention | LinearAttention | HyperbolicAttention | MoEAttention;
-/**
- * Factory function to create optimized attention modules
- */
-export declare function createAttentionOptimized(type: 'multi-head' | 'flash', config: AttentionConfig | FlashAttentionConfig): MultiHeadAttentionOptimized | FlashAttentionOptimized;
-/**
- * Convert number[] to Float32Array
- */
-export declare function toFloat32Array(arr: number[]): Float32Array;
-/**
- * Convert Float32Array to number[]
- */
-export declare function toNumberArray(arr: Float32Array): number[];
-/**
- * Convert 2D number[][] to flattened Float32Array
- */
-export declare function flatten2D(arr: number[][]): Float32Array;
-/**
- * Unflatten Float32Array to 2D array
- */
-export declare function unflatten2D(arr: Float32Array, rows: number, cols: number): number[][];
-/**
- * Get the global buffer pool for external memory management
- */
-export declare function getBufferPool(): {
-    acquire: (size: number) => Float32Array;
-    release: (buffer: Float32Array) => void;
-    clear: () => void;
-};
-/**
- * Benchmark attention implementation
- */
-export declare function benchmarkAttention(attention: MultiHeadAttentionOptimized | FlashAttentionOptimized, config: {
-    seqLen: number;
-    dim: number;
-    iterations: number;
-    numHeads?: number;
-}): {
-    avgTimeMs: number;
-    opsPerSecond: number;
-    memoryUsed: number;
-};
-//# sourceMappingURL=attention-fallbacks.d.ts.map