agentdb 3.0.0-alpha.10 → 3.0.0-alpha.12

package/dist/src/controllers/attention/AttentionWASM.d.ts

@@ -0,0 +1,98 @@
+/**
+ * AttentionWASM - WASM/NAPI module management
+ *
+ * Handles:
+ * - Module loading (WASM/NAPI)
+ * - Runtime detection
+ * - Warm-up
+ * - Fallback handling
+ */
+/**
+ * NAPI Attention Module Interface
+ */
+export interface NAPIAttentionModule {
+    multiHeadAttention?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number, mask?: Float32Array): {
+        output: Float32Array;
+        weights?: Float32Array;
+    };
+    flashAttention?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number, mask?: Float32Array): Float32Array;
+    flashAttentionV2?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number, options: any): {
+        output: Float32Array;
+        speedup?: number;
+        baselineTimeMs?: number;
+    };
+    linearAttention?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number): Float32Array;
+    hyperbolicAttention?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number, curvature: number): Float32Array;
+    moeAttention?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number, numExperts: number, topK: number, mask?: Float32Array): Float32Array;
+}
+/**
+ * WASM Attention Module Interface
+ */
+export interface WASMAttentionModule {
+    default(): Promise<void>;
+    dispose?(): Promise<void>;
+    multiHeadAttention?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number, mask?: Float32Array): {
+        output: Float32Array;
+        weights?: Float32Array;
+    };
+    flashAttention?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number, mask?: Float32Array): Float32Array;
+    flashAttentionV2?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number, options: any): {
+        output: Float32Array;
+        speedup?: number;
+        baselineTimeMs?: number;
+    };
+    linearAttention?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number): Float32Array;
+    hyperbolicAttention?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number, curvature: number): Float32Array;
+    moeAttention?(query: Float32Array, key: Float32Array, value: Float32Array, numHeads: number, headDim: number, numExperts: number, topK: number, mask?: Float32Array): Float32Array;
+}
+/**
+ * Runtime environment detection
+ */
+export type RuntimeEnvironment = 'nodejs' | 'browser' | 'unknown';
+/**
+ * AttentionWASMManager - Manages WASM/NAPI module loading
+ */
+export declare class AttentionWASMManager {
+    private runtime;
+    private napiModule;
+    private wasmModule;
+    constructor();
+    /**
+     * Initialize and load appropriate modules
+     */
+    initialize(): Promise<void>;
+    /**
+     * Load NAPI module for Node.js runtime
+     */
+    private loadNAPIModule;
+    /**
+     * Load WASM module for browser runtime with caching
+     * Uses global cache to share instances across AttentionService instances
+     */
+    private loadWASMModule;
+    /**
+     * Dispose WASM module
+     */
+    dispose(): Promise<void>;
+    /**
+     * Get runtime environment
+     */
+    getRuntime(): RuntimeEnvironment;
+    /**
+     * Get NAPI module
+     */
+    getNAPIModule(): NAPIAttentionModule | null;
+    /**
+     * Get WASM module
+     */
+    getWASMModule(): WASMAttentionModule | null;
+    /**
+     * Check if NAPI is available
+     */
+    hasNAPI(): boolean;
+    /**
+     * Check if WASM is available
+     */
+    hasWASM(): boolean;
+}
+//# sourceMappingURL=AttentionWASM.d.ts.map

package/dist/src/controllers/attention/AttentionWASM.d.ts.map

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

package/dist/src/controllers/attention/AttentionWASM.js

@@ -0,0 +1,147 @@
+/**
+ * AttentionWASM - WASM/NAPI module management
+ *
+ * Handles:
+ * - Module loading (WASM/NAPI)
+ * - Runtime detection
+ * - Warm-up
+ * - Fallback handling
+ */
+/**
+ * Global WASM instance cache (shared across all AttentionService instances)
+ * Prevents re-initialization overhead (2-5s → <10ms cold start)
+ */
+const wasmInstanceCache = new Map();
+/**
+ * Detect the current runtime environment
+ */
+function detectRuntime() {
+    // Check for Node.js
+    if (typeof process !== 'undefined' && process.versions && process.versions.node) {
+        return 'nodejs';
+    }
+    // Check for browser (with proper type guards)
+    if (typeof globalThis !== 'undefined') {
+        const global = globalThis;
+        if (typeof global.window !== 'undefined' && typeof global.document !== 'undefined') {
+            return 'browser';
+        }
+    }
+    return 'unknown';
+}
+/**
+ * AttentionWASMManager - Manages WASM/NAPI module loading
+ */
+export class AttentionWASMManager {
+    runtime;
+    napiModule = null;
+    wasmModule = null;
+    constructor() {
+        this.runtime = detectRuntime();
+    }
+    /**
+     * Initialize and load appropriate modules
+     */
+    async initialize() {
+        if (this.runtime === 'nodejs') {
+            await this.loadNAPIModule();
+        }
+        else if (this.runtime === 'browser') {
+            await this.loadWASMModule();
+        }
+        else {
+            console.warn('⚠️  Unknown runtime environment, using fallback implementation');
+        }
+    }
+    /**
+     * Load NAPI module for Node.js runtime
+     */
+    async loadNAPIModule() {
+        try {
+            // Try to import @ruvector/attention (NAPI bindings)
+            // @ts-expect-error - Optional dependency
+            this.napiModule = await import('@ruvector/attention');
+            console.log('✅ Loaded @ruvector/attention NAPI module');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.warn(`⚠️  Failed to load @ruvector/attention: ${errorMessage}`);
+            console.warn('   Falling back to JavaScript implementation');
+            this.napiModule = null;
+        }
+    }
+    /**
+     * Load WASM module for browser runtime with caching
+     * Uses global cache to share instances across AttentionService instances
+     */
+    async loadWASMModule() {
+        const cacheKey = 'ruvector-attention-wasm';
+        // Check cache first (optimization: 2-5s → <10ms)
+        if (wasmInstanceCache.has(cacheKey)) {
+            this.wasmModule = wasmInstanceCache.get(cacheKey);
+            console.log('✅ Loaded WASM from cache (<10ms)');
+            return;
+        }
+        try {
+            // Try to import ruvector-attention-wasm
+            const mod = await import('ruvector-attention-wasm').catch(() => null);
+            if (!mod) {
+                throw new Error('WASM module not available');
+            }
+            // Initialize WASM once
+            if (typeof mod.default === 'function') {
+                await mod.default();
+            }
+            this.wasmModule = mod;
+            wasmInstanceCache.set(cacheKey, mod);
+            console.log('✅ Loaded and cached WASM module');
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.warn(`⚠️  Failed to load ruvector-attention-wasm: ${errorMessage}`);
+            console.warn('   Falling back to JavaScript implementation');
+            this.wasmModule = null;
+        }
+    }
+    /**
+     * Dispose WASM module
+     */
+    async dispose() {
+        if (this.wasmModule && typeof this.wasmModule.dispose === 'function') {
+            await this.wasmModule.dispose();
+        }
+        this.napiModule = null;
+        this.wasmModule = null;
+    }
+    /**
+     * Get runtime environment
+     */
+    getRuntime() {
+        return this.runtime;
+    }
+    /**
+     * Get NAPI module
+     */
+    getNAPIModule() {
+        return this.napiModule;
+    }
+    /**
+     * Get WASM module
+     */
+    getWASMModule() {
+        return this.wasmModule;
+    }
+    /**
+     * Check if NAPI is available
+     */
+    hasNAPI() {
+        return this.napiModule !== null;
+    }
+    /**
+     * Check if WASM is available
+     */
+    hasWASM() {
+        return this.wasmModule !== null;
+    }
+}
+//# sourceMappingURL=AttentionWASM.js.map

package/dist/src/controllers/attention/AttentionWASM.js.map

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

package/dist/src/controllers/attention/CrossAttentionController.d.ts

@@ -0,0 +1,141 @@
+/**
+ * CrossAttentionController - Cross-Attention Mechanism for Memory Systems
+ *
+ * Implements cross-attention between a query and different memory contexts,
+ * allowing the system to attend to multiple namespaces or memory sources
+ * and integrate information across them.
+ *
+ * Features:
+ * - Multiple context namespace support
+ * - Query-context integration
+ * - Flexible aggregation strategies
+ * - Efficient retrieval with vector backends
+ */
+import type { VectorBackend } from '../../backends/VectorBackend.js';
+/**
+ * Configuration for cross-attention computation
+ */
+export interface CrossAttentionConfig {
+    /** Number of top results to return per context */
+    topK?: number;
+    /** Minimum attention score threshold (0-1) */
+    minScore?: number;
+    /** Temperature for softmax scaling */
+    temperature?: number;
+    /** Aggregation strategy for multi-context attention */
+    aggregation?: 'average' | 'max' | 'weighted';
+}
+/**
+ * Individual attention score for a context entry
+ */
+export interface CrossAttentionScore {
+    /** Context entry ID */
+    id: string;
+    /** Context namespace */
+    context: string;
+    /** Computed attention score (0-1 after softmax) */
+    score: number;
+    /** Raw similarity score before softmax */
+    rawScore?: number;
+}
+/**
+ * Result of cross-attention computation
+ */
+export interface CrossAttentionResult {
+    /** Attention scores for each context entry */
+    scores: CrossAttentionScore[];
+    /** Attended output vector (integrated from context) */
+    attended: number[];
+    /** Per-context contribution weights */
+    contextWeights?: Record<string, number>;
+    /** Execution time in milliseconds */
+    executionTimeMs: number;
+}
+/**
+ * Memory entry with embedding for cross-attention
+ */
+export interface ContextEntry {
+    id: string;
+    embedding: number[];
+    content?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Cross-attention controller for computing attention across memory contexts
+ */
+export declare class CrossAttentionController {
+    private vectorBackend;
+    private contextStores;
+    private dimension;
+    private config;
+    constructor(vectorBackend?: VectorBackend | null, config?: CrossAttentionConfig);
+    /**
+     * Add an entry to a specific context namespace
+     */
+    addToContext(contextName: string, entry: ContextEntry): void;
+    /**
+     * Remove an entry from a context
+     */
+    removeFromContext(contextName: string, id: string): boolean;
+    /**
+     * Clear a specific context
+     */
+    clearContext(contextName: string): void;
+    /**
+     * Clear all contexts
+     */
+    clearAllContexts(): void;
+    /**
+     * List available context namespaces
+     */
+    listContexts(): string[];
+    /**
+     * Compute cross-attention between query and a specific context
+     *
+     * @param query - Query vector for attention computation
+     * @param contextName - Name of the context to attend to
+     * @param options - Override default configuration options
+     * @returns Cross-attention result with scores and attended output
+     */
+    computeCrossAttention(query: number[], contextName: string, options?: CrossAttentionConfig): Promise<CrossAttentionResult>;
+    /**
+     * Compute cross-attention across multiple contexts
+     *
+     * @param query - Query vector for attention computation
+     * @param contextNames - Names of contexts to attend to (all if empty)
+     * @param options - Override default configuration options
+     * @returns Cross-attention result with aggregated output
+     */
+    computeMultiContextAttention(query: number[], contextNames?: string[], options?: CrossAttentionConfig): Promise<CrossAttentionResult>;
+    /**
+     * Compute dot product between two vectors
+     */
+    private computeDotProduct;
+    /**
+     * Apply softmax normalization to scores
+     */
+    private applySoftmax;
+    /**
+     * Compute attended output as weighted sum
+     */
+    private computeAttendedOutput;
+    /**
+     * Aggregate attended outputs from multiple contexts
+     */
+    private aggregateAttendedOutputs;
+    /**
+     * Get the total number of entries across all contexts
+     */
+    get totalEntryCount(): number;
+    /**
+     * Get statistics about the cross-attention controller
+     */
+    getStats(): {
+        contextCount: number;
+        totalEntries: number;
+        dimension: number;
+        hasVectorBackend: boolean;
+        contextsInfo: Record<string, number>;
+    };
+}
+//# sourceMappingURL=CrossAttentionController.d.ts.map

package/dist/src/controllers/attention/CrossAttentionController.d.ts.map

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