agentic-flow 2.0.1 → 2.0.2-alpha

package/dist/core/agentdb-wrapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"agentdb-wrapper.js","sourceRoot":"","sources":["../../src/core/agentdb-wrapper.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * AgentDBWrapper - Clean API over raw AgentDB v2.0.0-alpha.2.11\n *\n * Provides a unified interface for:\n * - Vector search with HNSW indexing\n * - Memory operations (insert, search, update, delete)\n * - TypeScript-first type safety\n * - Error handling and validation\n *\n * Note: AgentDB is optional - falls back gracefully on Windows\n *\n * @module agentdb-wrapper\n */\n\nlet AgentDB: any = null;\nlet agentdbAvailable = false;\n\ntry {\n  const mod = await import('agentdb');\n  AgentDB = mod.AgentDB;\n  agentdbAvailable = true;\n} catch {\n  console.warn('[AgentDB] Not available - some features disabled');\n}\n\nimport type {\n  AgentDBConfig,\n  VectorEntry,\n  VectorSearchOptions,\n  VectorSearchResult,\n  MemoryInsertOptions,\n  MemoryUpdateOptions,\n  MemoryDeleteOptions,\n  MemoryGetOptions,\n  AgentDBStats,\n  BatchInsertResult,\n  ValidationError,\n  DatabaseError,\n  IndexError,\n  HNSWConfig,\n} from '../types/agentdb.js';\n\n/**\n * Main wrapper class for AgentDB operations\n *\n * @example\n * ```typescript\n * const wrapper = new AgentDBWrapper({\n *   dbPath: ':memory:',\n *   dimension: 384,\n *   hnswConfig: { M: 16, efConstruction: 200 }\n * });\n *\n * await wrapper.initialize();\n *\n * // Insert a vector\n * const vector = new Float32Array(384);\n * await wrapper.insert({ vector, metadata: { type: 'test' } });\n *\n * // Search\n * const results = await wrapper.vectorSearch(queryVector, { k: 10 });\n *\n * await wrapper.close();\n * ```\n */\nexport class AgentDBWrapper {\n  private agentDB!: any;\n  private config: AgentDBConfig;\n  private initialized = false;\n  private dimension: number;\n  private namespace: string;\n  private reflexionController: any;\n  private embedder: any;\n  private vectorBackend: any;\n\n  // For testing - allow dependency injection\n  public _agentDB?: any;\n  public _embedder?: any;\n  public _vectorBackend?: any;\n\n  /**\n   * Create a new AgentDBWrapper instance\n   *\n   * @param config - Configuration options\n   */\n  constructor(config: AgentDBConfig = {}) {\n    this.config = {\n      dbPath: config.dbPath || ':memory:',\n      namespace: config.namespace || 'default',\n      dimension: config.dimension || 384,\n      hnswConfig: {\n        M: config.hnswConfig?.M || 16,\n        efConstruction: config.hnswConfig?.efConstruction || 200,\n        efSearch: config.hnswConfig?.efSearch || 100,\n      },\n      enableAttention: config.enableAttention || false,\n      attentionConfig: config.attentionConfig,\n      autoInit: config.autoInit !== false, // Default true\n    };\n\n    this.dimension = this.config.dimension!;\n    this.namespace = this.config.namespace!;\n\n    // Auto-initialize if configured\n    if (this.config.autoInit) {\n      this.initialize().catch((err) => {\n        console.error('Auto-initialization failed:', err);\n      });\n    }\n  }\n\n  /**\n   * Initialize the AgentDB instance and dependencies\n   *\n   * @throws {DatabaseError} If initialization fails\n   */\n  async initialize(): Promise<void> {\n    if (this.initialized) {\n      return;\n    }\n\n    if (!agentdbAvailable || !AgentDB) {\n      throw new Error('AgentDB not available - install with: npm install agentdb (requires native build tools)');\n    }\n\n    try {\n      // Use injected dependencies for testing, otherwise create real instances\n      if (this._agentDB) {\n        this.agentDB = this._agentDB;\n        this.embedder = this._embedder;\n        this.vectorBackend = this._vectorBackend;\n      } else {\n        // Create real AgentDB instance\n        this.agentDB = new AgentDB({\n          dbPath: this.config.dbPath,\n          namespace: this.namespace,\n          enableAttention: this.config.enableAttention,\n          attentionConfig: this.config.attentionConfig,\n        });\n\n        await this.agentDB.initialize();\n\n        // Get controllers\n        this.reflexionController = this.agentDB.getController('reflexion');\n        this.embedder = this.reflexionController?.embedder;\n        this.vectorBackend = this.reflexionController?.vectorBackend;\n      }\n\n      // Initialize embedder if available\n      if (this.embedder && this.embedder.initialize) {\n        await this.embedder.initialize();\n      }\n\n      this.initialized = true;\n    } catch (error) {\n      throw new Error(\n        `Failed to initialize AgentDB: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Ensure wrapper is initialized before operations\n   *\n   * @throws {Error} If not initialized\n   */\n  private ensureInitialized(): void {\n    if (!this.initialized) {\n      throw new Error(\n        'AgentDBWrapper not initialized. Call initialize() first.'\n      );\n    }\n  }\n\n  /**\n   * Validate vector dimension\n   *\n   * @param vector - Vector to validate\n   * @throws {ValidationError} If dimension is invalid\n   */\n  private validateVectorDimension(vector: Float32Array): void {\n    if (vector.length !== this.dimension) {\n      throw new Error(\n        `Invalid vector dimension: expected ${this.dimension}, got ${vector.length}`\n      );\n    }\n  }\n\n  /**\n   * Generate a unique ID\n   *\n   * @returns A unique identifier\n   */\n  private generateId(): string {\n    return `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;\n  }\n\n  /**\n   * Insert a vector with metadata into the database\n   *\n   * @param options - Insert options\n   * @returns The inserted entry with ID\n   * @throws {ValidationError} If vector dimension is invalid\n   * @throws {DatabaseError} If insertion fails\n   */\n  async insert(\n    options: MemoryInsertOptions\n  ): Promise<{ id: string; timestamp: number }> {\n    this.ensureInitialized();\n    this.validateVectorDimension(options.vector);\n\n    const id = options.id || this.generateId();\n    const timestamp = Date.now();\n\n    const metadata = {\n      ...options.metadata,\n      timestamp,\n      namespace: options.namespace || this.namespace,\n    };\n\n    try {\n      const controller = this._agentDB\n        ? this._agentDB.getController('reflexion')\n        : this.reflexionController;\n\n      await controller.store({\n        id,\n        vector: options.vector,\n        metadata,\n      });\n\n      return { id, timestamp };\n    } catch (error) {\n      throw new Error(\n        `Failed to insert vector: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Search for similar vectors using HNSW indexing\n   *\n   * @param query - Query vector\n   * @param options - Search options\n   * @returns Array of search results sorted by similarity (descending)\n   * @throws {ValidationError} If query dimension is invalid\n   */\n  async vectorSearch(\n    query: Float32Array,\n    options: VectorSearchOptions = {}\n  ): Promise<VectorSearchResult[]> {\n    this.ensureInitialized();\n    this.validateVectorDimension(query);\n\n    const {\n      k = 10,\n      metric = 'cosine',\n      filter,\n      includeVectors = false,\n      hnswParams,\n    } = options;\n\n    try {\n      const controller = this._agentDB\n        ? this._agentDB.getController('reflexion')\n        : this.reflexionController;\n\n      const results = await controller.retrieve(query, {\n        k,\n        metric,\n        filter,\n        includeVectors,\n        hnswParams,\n      });\n\n      return results.map((result: any) => ({\n        id: result.id,\n        score: result.score,\n        metadata: result.metadata,\n        ...(includeVectors && { vector: result.vector }),\n      }));\n    } catch (error) {\n      throw new Error(\n        `Vector search failed: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Update a vector and/or its metadata\n   *\n   * @param options - Update options\n   * @returns True if update succeeded\n   * @throws {ValidationError} If vector dimension is invalid\n   * @throws {DatabaseError} If vector not found\n   */\n  async update(options: MemoryUpdateOptions): Promise<boolean> {\n    this.ensureInitialized();\n\n    if (options.vector) {\n      this.validateVectorDimension(options.vector);\n    }\n\n    try {\n      const controller = this._agentDB\n        ? this._agentDB.getController('reflexion')\n        : this.reflexionController;\n\n      const updateData: any = {};\n\n      if (options.vector) {\n        updateData.vector = options.vector;\n      }\n\n      if (options.metadata) {\n        updateData.metadata = options.metadata;\n      }\n\n      const result = await controller.update(options.id, updateData);\n\n      if (!result) {\n        throw new Error(`Vector not found: ${options.id}`);\n      }\n\n      return result;\n    } catch (error) {\n      throw error;\n    }\n  }\n\n  /**\n   * Delete a vector by ID\n   *\n   * @param options - Delete options\n   * @returns True if deletion succeeded, false if not found\n   */\n  async delete(options: MemoryDeleteOptions): Promise<boolean> {\n    this.ensureInitialized();\n\n    try {\n      const controller = this._agentDB\n        ? this._agentDB.getController('reflexion')\n        : this.reflexionController;\n\n      const result = await controller.delete(options.id);\n      return result;\n    } catch (error) {\n      throw new Error(\n        `Delete failed: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Get a vector by ID\n   *\n   * @param options - Get options\n   * @returns Vector entry or null if not found\n   */\n  async get(options: MemoryGetOptions): Promise<VectorEntry | null> {\n    this.ensureInitialized();\n\n    try {\n      const controller = this._agentDB\n        ? this._agentDB.getController('reflexion')\n        : this.reflexionController;\n\n      const result = await controller.get(options.id);\n\n      if (!result) {\n        return null;\n      }\n\n      const entry: VectorEntry = {\n        id: result.id,\n        vector: result.vector,\n        metadata: result.metadata,\n      };\n\n      // Exclude vector if not requested\n      if (options.includeVector === false) {\n        delete entry.vector;\n      }\n\n      return entry;\n    } catch (error) {\n      throw new Error(\n        `Get failed: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Insert multiple vectors in a batch\n   *\n   * @param entries - Array of entries to insert\n   * @returns Batch insert result with success/failure counts\n   */\n  async batchInsert(\n    entries: MemoryInsertOptions[]\n  ): Promise<BatchInsertResult> {\n    this.ensureInitialized();\n\n    const startTime = Date.now();\n    const result: BatchInsertResult = {\n      inserted: 0,\n      failed: [],\n      duration: 0,\n    };\n\n    const controller = this._agentDB\n      ? this._agentDB.getController('reflexion')\n      : this.reflexionController;\n\n    for (let i = 0; i < entries.length; i++) {\n      const entry = entries[i];\n\n      try {\n        await this.insert(entry);\n        result.inserted++;\n      } catch (error) {\n        result.failed.push({\n          index: i,\n          id: entry.id,\n          error: error instanceof Error ? error.message : String(error),\n        });\n      }\n    }\n\n    result.duration = Date.now() - startTime;\n    return result;\n  }\n\n  /**\n   * Get database statistics\n   *\n   * @returns Database statistics including vector count and index info\n   */\n  async getStats(): Promise<AgentDBStats> {\n    this.ensureInitialized();\n\n    try {\n      const backend = this._vectorBackend || this.vectorBackend;\n\n      const stats = await backend.getStats();\n\n      return {\n        vectorCount: stats.vectorCount || 0,\n        dimension: this.dimension,\n        databaseSize: stats.databaseSize || 0,\n        hnswStats: stats.hnswStats,\n        memoryUsage: stats.memoryUsage,\n        indexBuildTime: stats.indexBuildTime,\n      };\n    } catch (error) {\n      throw new Error(\n        `Failed to get stats: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Close the database connection\n   */\n  async close(): Promise<void> {\n    if (!this.initialized) {\n      return;\n    }\n\n    try {\n      const db = this._agentDB || this.agentDB;\n      await db.close();\n      this.initialized = false;\n    } catch (error) {\n      throw new Error(\n        `Failed to close database: ${error instanceof Error ? error.message : String(error)}`\n      );\n    }\n  }\n\n  /**\n   * Get the underlying AgentDB instance (for advanced usage)\n   *\n   * @returns The raw AgentDB instance\n   */\n  getRawInstance(): any {\n    this.ensureInitialized();\n    return this.agentDB;\n  }\n}\n"]}

package/dist/core/attention-fallbacks.d.ts

@@ -1,111 +0,0 @@
-/**
- * Attention Module Fallbacks
- *
- * Since @ruvector/attention is completely broken, provide JavaScript fallbacks
- * Performance will be slower but functionality will work
- */
-export interface AttentionConfig {
-    hiddenDim: number;
-    numHeads?: number;
-    dropoutRate?: number;
-    useFlash?: boolean;
-}
-/**
- * Scaled Dot-Product Attention
- * The core attention mechanism
- */
-export declare function scaledDotProductAttention(query: number[], key: number[], value: number[], mask?: number[]): {
-    output: number[];
-    weights: number[];
-};
-/**
- * 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;
-}
-/**
- * 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[][];
-    };
-}
-/**
- * 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;
-//# sourceMappingURL=attention-fallbacks.d.ts.map

package/dist/core/attention-native.d.ts

@@ -1,115 +0,0 @@
-/**
- * Native Attention Wrappers
- *
- * Properly wraps @ruvector/attention native Rust implementations
- * with TypedArray conversions and proper error handling
- *
- * Note: @ruvector/attention is optional - falls back gracefully
- */
-declare let attentionAvailable: boolean;
-export { attentionAvailable };
-export interface AttentionConfig {
-    hiddenDim: number;
-    numHeads?: number;
-    dropoutRate?: number;
-    useFlash?: boolean;
-}
-/**
- * Native Multi-Head Attention (uses Rust implementation)
- *
- * This wrapper properly converts between JavaScript arrays and TypedArrays
- * required by the native Rust implementation.
- */
-export declare class MultiHeadAttention {
-    private nativeInstance;
-    private hiddenDim;
-    private numHeads;
-    constructor(config: AttentionConfig);
-    /**
-     * Forward pass using native Rust implementation
-     */
-    forward(query: number[] | Float32Array, key: number[] | Float32Array, value: number[] | Float32Array, mask?: number[] | Float32Array): {
-        output: number[];
-        attentionWeights: number[][];
-    };
-    /**
-     * Get dimensions
-     */
-    get dim(): number;
-    get headDim(): number;
-}
-/**
- * Native Flash Attention (uses Rust implementation)
- *
- * Memory-efficient attention with tiling/chunking
- */
-export declare class FlashAttention {
-    private nativeInstance;
-    private hiddenDim;
-    constructor(config: AttentionConfig);
-    /**
-     * Forward pass with batch support
-     */
-    forward(query: number[][] | Float32Array[], key: number[][] | Float32Array[], value: number[][] | Float32Array[], numHeads?: number): {
-        output: number[][];
-        attentionScores: number[][];
-    };
-}
-/**
- * Native Linear Attention (uses Rust implementation)
- *
- * O(n) complexity approximation of attention
- */
-export declare class LinearAttention {
-    private nativeInstance;
-    private hiddenDim;
-    constructor(config: AttentionConfig);
-    forward(query: number[][] | Float32Array[], key: number[][] | Float32Array[], value: number[][] | Float32Array[]): {
-        output: number[][];
-    };
-}
-/**
- * Native Hyperbolic Attention (uses Rust implementation)
- */
-export declare class HyperbolicAttention {
-    private nativeInstance;
-    private hiddenDim;
-    constructor(config: AttentionConfig);
-    forward(query: number[] | Float32Array, key: number[] | Float32Array, value: number[] | Float32Array): {
-        output: number[];
-        distance: number;
-    };
-}
-/**
- * Native MoE Attention (uses Rust implementation)
- *
- * Mixture of Experts with top-k routing
- */
-export declare class MoEAttention {
-    private nativeInstance;
-    private hiddenDim;
-    private numExperts;
-    constructor(config: AttentionConfig & {
-        numExperts?: number;
-    });
-    forward(query: number[] | Float32Array, key: number[] | Float32Array, value: number[] | Float32Array, topK?: number): {
-        output: number[];
-        expertWeights: number[];
-    };
-}
-/**
- * Scaled Dot-Product Attention (pure JavaScript, always works)
- */
-export declare function scaledDotProductAttention(query: number[], key: number[], value: number[], mask?: number[]): {
-    output: number[];
-    weights: 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;
-//# sourceMappingURL=attention-native.d.ts.map

package/dist/core/attention-native.d.ts.map

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

package/dist/core/attention-native.js

@@ -1,280 +0,0 @@
-/**
- * Native Attention Wrappers
- *
- * Properly wraps @ruvector/attention native Rust implementations
- * with TypedArray conversions and proper error handling
- *
- * Note: @ruvector/attention is optional - falls back gracefully
- */
-let nativeAttention = null;
-let attentionAvailable = false;
-try {
-    nativeAttention = await import('@ruvector/attention');
-    attentionAvailable = true;
-}
-catch {
-    console.warn('[attention-native] @ruvector/attention not available');
-}
-export { attentionAvailable };
-/**
- * Convert regular array to Float32Array if needed
- */
-function toFloat32Array(input) {
-    if (input instanceof Float32Array) {
-        return input;
-    }
-    return new Float32Array(input);
-}
-/**
- * Convert Float32Array to regular array for JS compatibility
- */
-function toArray(input) {
-    return Array.from(input);
-}
-/**
- * Native Multi-Head Attention (uses Rust implementation)
- *
- * This wrapper properly converts between JavaScript arrays and TypedArrays
- * required by the native Rust implementation.
- */
-export class MultiHeadAttention {
-    nativeInstance;
-    hiddenDim;
-    numHeads;
-    constructor(config) {
-        this.hiddenDim = config.hiddenDim;
-        this.numHeads = config.numHeads || 8;
-        try {
-            // Create native Rust instance
-            this.nativeInstance = new nativeAttention.MultiHeadAttention(this.hiddenDim, this.numHeads);
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize native MultiHeadAttention: ${error.message}`);
-        }
-    }
-    /**
-     * Forward pass using native Rust implementation
-     */
-    forward(query, key, value, mask) {
-        try {
-            // Convert to Float32Array for native code
-            const q = toFloat32Array(query);
-            const k = toFloat32Array(key);
-            const v = toFloat32Array(value);
-            const m = mask ? toFloat32Array(mask) : undefined;
-            // Call native compute method
-            const result = this.nativeInstance.compute(q, k, v, m);
-            // Convert result back to regular arrays
-            return {
-                output: toArray(result),
-                attentionWeights: [[]] // Native doesn't return weights separately
-            };
-        }
-        catch (error) {
-            throw new Error(`MultiHeadAttention forward failed: ${error.message}`);
-        }
-    }
-    /**
-     * Get dimensions
-     */
-    get dim() {
-        return this.nativeInstance.dim;
-    }
-    get headDim() {
-        return this.nativeInstance.headDim;
-    }
-}
-/**
- * Native Flash Attention (uses Rust implementation)
- *
- * Memory-efficient attention with tiling/chunking
- */
-export class FlashAttention {
-    nativeInstance;
-    hiddenDim;
-    constructor(config) {
-        this.hiddenDim = config.hiddenDim;
-        try {
-            this.nativeInstance = new nativeAttention.FlashAttention(this.hiddenDim);
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize native FlashAttention: ${error.message}`);
-        }
-    }
-    /**
-     * Forward pass with batch support
-     */
-    forward(query, key, value, numHeads = 8) {
-        try {
-            // Convert batch to Float32Array
-            const q = query.map(toFloat32Array);
-            const k = key.map(toFloat32Array);
-            const v = value.map(toFloat32Array);
-            // Call native compute
-            const result = this.nativeInstance.compute(q, k, v, numHeads);
-            // Convert result back
-            return {
-                output: result.map((r) => toArray(r)),
-                attentionScores: [[]]
-            };
-        }
-        catch (error) {
-            throw new Error(`FlashAttention forward failed: ${error.message}`);
-        }
-    }
-}
-/**
- * Native Linear Attention (uses Rust implementation)
- *
- * O(n) complexity approximation of attention
- */
-export class LinearAttention {
-    nativeInstance;
-    hiddenDim;
-    constructor(config) {
-        this.hiddenDim = config.hiddenDim;
-        try {
-            // LinearAttention constructor: (hiddenDim, seqLen)
-            // We'll use hiddenDim for both since seqLen varies per forward call
-            this.nativeInstance = new nativeAttention.LinearAttention(this.hiddenDim, this.hiddenDim);
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize native LinearAttention: ${error.message}`);
-        }
-    }
-    forward(query, key, value) {
-        try {
-            const q = query.map(toFloat32Array);
-            const k = key.map(toFloat32Array);
-            const v = value.map(toFloat32Array);
-            const result = this.nativeInstance.compute(q, k, v);
-            return {
-                output: result.map((r) => toArray(r))
-            };
-        }
-        catch (error) {
-            throw new Error(`LinearAttention forward failed: ${error.message}`);
-        }
-    }
-}
-/**
- * Native Hyperbolic Attention (uses Rust implementation)
- */
-export class HyperbolicAttention {
-    nativeInstance;
-    hiddenDim;
-    constructor(config) {
-        this.hiddenDim = config.hiddenDim;
-        try {
-            this.nativeInstance = new nativeAttention.HyperbolicAttention(this.hiddenDim);
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize native HyperbolicAttention: ${error.message}`);
-        }
-    }
-    forward(query, key, value) {
-        try {
-            const q = toFloat32Array(query);
-            const k = toFloat32Array(key);
-            const v = toFloat32Array(value);
-            const result = this.nativeInstance.compute(q, k, v);
-            return {
-                output: toArray(result.output),
-                distance: result.distance
-            };
-        }
-        catch (error) {
-            throw new Error(`HyperbolicAttention forward failed: ${error.message}`);
-        }
-    }
-}
-/**
- * Native MoE Attention (uses Rust implementation)
- *
- * Mixture of Experts with top-k routing
- */
-export class MoEAttention {
-    nativeInstance;
-    hiddenDim;
-    numExperts;
-    constructor(config) {
-        this.hiddenDim = config.hiddenDim;
-        this.numExperts = config.numExperts || 4;
-        try {
-            // MoEAttention constructor may have different signature in different versions
-            this.nativeInstance = new nativeAttention.MoEAttention(this.hiddenDim);
-        }
-        catch (error) {
-            throw new Error(`Failed to initialize native MoEAttention: ${error.message}`);
-        }
-    }
-    forward(query, key, value, topK = 2) {
-        try {
-            const q = toFloat32Array(query);
-            const k = toFloat32Array(key);
-            const v = toFloat32Array(value);
-            const result = this.nativeInstance.compute(q, k, v, topK);
-            return {
-                output: toArray(result.output),
-                expertWeights: toArray(result.expertWeights)
-            };
-        }
-        catch (error) {
-            throw new Error(`MoEAttention forward failed: ${error.message}`);
-        }
-    }
-}
-/**
- * Scaled Dot-Product Attention (pure JavaScript, always works)
- */
-export function scaledDotProductAttention(query, key, value, mask) {
-    const dk = query.length;
-    // Compute attention scores: Q · K^T / sqrt(dk)
-    let score = 0;
-    for (let i = 0; i < dk; i++) {
-        score += query[i] * key[i];
-    }
-    score /= Math.sqrt(dk);
-    // Apply mask if provided
-    if (mask && mask[0] === 0) {
-        score = -Infinity;
-    }
-    // Softmax (single score version)
-    const expScore = Math.exp(score);
-    const weight = expScore;
-    // Weighted value
-    const output = value.map(v => v * weight);
-    return { output, weights: [weight] };
-}
-/**
- * Check if native attention is available
- */
-export function isNativeAttentionAvailable() {
-    try {
-        const test = new nativeAttention.MultiHeadAttention(128, 4);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Factory function to create appropriate attention module
- */
-export function createAttention(type, config) {
-    switch (type) {
-        case 'multi-head':
-            return new MultiHeadAttention(config);
-        case 'flash':
-            return new FlashAttention(config);
-        case 'linear':
-            return new LinearAttention(config);
-        case 'hyperbolic':
-            return new HyperbolicAttention(config);
-        case 'moe':
-            return new MoEAttention(config);
-        default:
-            return new MultiHeadAttention(config);
-    }
-}
-//# sourceMappingURL=attention-native.js.map

package/dist/core/attention-native.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"attention-native.js","sourceRoot":"","sources":["../../src/core/attention-native.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Native Attention Wrappers\n *\n * Properly wraps @ruvector/attention native Rust implementations\n * with TypedArray conversions and proper error handling\n *\n * Note: @ruvector/attention is optional - falls back gracefully\n */\n\nlet nativeAttention: any = null;\nlet attentionAvailable = false;\n\ntry {\n  nativeAttention = await import('@ruvector/attention');\n  attentionAvailable = true;\n} catch {\n  console.warn('[attention-native] @ruvector/attention not available');\n}\n\nexport { attentionAvailable };\n\nexport interface AttentionConfig {\n  hiddenDim: number;\n  numHeads?: number;\n  dropoutRate?: number;\n  useFlash?: boolean;\n}\n\n/**\n * Convert regular array to Float32Array if needed\n */\nfunction toFloat32Array(input: number[] | Float32Array): Float32Array {\n  if (input instanceof Float32Array) {\n    return input;\n  }\n  return new Float32Array(input);\n}\n\n/**\n * Convert Float32Array to regular array for JS compatibility\n */\nfunction toArray(input: Float32Array): number[] {\n  return Array.from(input);\n}\n\n/**\n * Native Multi-Head Attention (uses Rust implementation)\n *\n * This wrapper properly converts between JavaScript arrays and TypedArrays\n * required by the native Rust implementation.\n */\nexport class MultiHeadAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n  private numHeads: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n    this.numHeads = config.numHeads || 8;\n\n    try {\n      // Create native Rust instance\n      this.nativeInstance = new nativeAttention.MultiHeadAttention(\n        this.hiddenDim,\n        this.numHeads\n      );\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native MultiHeadAttention: ${error.message}`);\n    }\n  }\n\n  /**\n   * Forward pass using native Rust implementation\n   */\n  forward(\n    query: number[] | Float32Array,\n    key: number[] | Float32Array,\n    value: number[] | Float32Array,\n    mask?: number[] | Float32Array\n  ): { output: number[]; attentionWeights: number[][] } {\n    try {\n      // Convert to Float32Array for native code\n      const q = toFloat32Array(query);\n      const k = toFloat32Array(key);\n      const v = toFloat32Array(value);\n      const m = mask ? toFloat32Array(mask) : undefined;\n\n      // Call native compute method\n      const result = this.nativeInstance.compute(q, k, v, m);\n\n      // Convert result back to regular arrays\n      return {\n        output: toArray(result),\n        attentionWeights: [[]] // Native doesn't return weights separately\n      };\n    } catch (error: any) {\n      throw new Error(`MultiHeadAttention forward failed: ${error.message}`);\n    }\n  }\n\n  /**\n   * Get dimensions\n   */\n  get dim(): number {\n    return this.nativeInstance.dim;\n  }\n\n  get headDim(): number {\n    return this.nativeInstance.headDim;\n  }\n}\n\n/**\n * Native Flash Attention (uses Rust implementation)\n *\n * Memory-efficient attention with tiling/chunking\n */\nexport class FlashAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n\n    try {\n      this.nativeInstance = new nativeAttention.FlashAttention(this.hiddenDim);\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native FlashAttention: ${error.message}`);\n    }\n  }\n\n  /**\n   * Forward pass with batch support\n   */\n  forward(\n    query: number[][] | Float32Array[],\n    key: number[][] | Float32Array[],\n    value: number[][] | Float32Array[],\n    numHeads: number = 8\n  ): { output: number[][]; attentionScores: number[][] } {\n    try {\n      // Convert batch to Float32Array\n      const q = query.map(toFloat32Array);\n      const k = key.map(toFloat32Array);\n      const v = value.map(toFloat32Array);\n\n      // Call native compute\n      const result = this.nativeInstance.compute(q, k, v, numHeads);\n\n      // Convert result back\n      return {\n        output: result.map((r: Float32Array) => toArray(r)),\n        attentionScores: [[]]\n      };\n    } catch (error: any) {\n      throw new Error(`FlashAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Native Linear Attention (uses Rust implementation)\n *\n * O(n) complexity approximation of attention\n */\nexport class LinearAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n\n    try {\n      // LinearAttention constructor: (hiddenDim, seqLen)\n      // We'll use hiddenDim for both since seqLen varies per forward call\n      this.nativeInstance = new nativeAttention.LinearAttention(\n        this.hiddenDim,\n        this.hiddenDim\n      );\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native LinearAttention: ${error.message}`);\n    }\n  }\n\n  forward(\n    query: number[][] | Float32Array[],\n    key: number[][] | Float32Array[],\n    value: number[][] | Float32Array[]\n  ): { output: number[][] } {\n    try {\n      const q = query.map(toFloat32Array);\n      const k = key.map(toFloat32Array);\n      const v = value.map(toFloat32Array);\n\n      const result = this.nativeInstance.compute(q, k, v);\n\n      return {\n        output: result.map((r: Float32Array) => toArray(r))\n      };\n    } catch (error: any) {\n      throw new Error(`LinearAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Native Hyperbolic Attention (uses Rust implementation)\n */\nexport class HyperbolicAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n\n  constructor(config: AttentionConfig) {\n    this.hiddenDim = config.hiddenDim;\n\n    try {\n      this.nativeInstance = new nativeAttention.HyperbolicAttention(this.hiddenDim);\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native HyperbolicAttention: ${error.message}`);\n    }\n  }\n\n  forward(\n    query: number[] | Float32Array,\n    key: number[] | Float32Array,\n    value: number[] | Float32Array\n  ): { output: number[]; distance: number } {\n    try {\n      const q = toFloat32Array(query);\n      const k = toFloat32Array(key);\n      const v = toFloat32Array(value);\n\n      const result = this.nativeInstance.compute(q, k, v);\n\n      return {\n        output: toArray(result.output),\n        distance: result.distance\n      };\n    } catch (error: any) {\n      throw new Error(`HyperbolicAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Native MoE Attention (uses Rust implementation)\n *\n * Mixture of Experts with top-k routing\n */\nexport class MoEAttention {\n  private nativeInstance: any;\n  private hiddenDim: number;\n  private numExperts: number;\n\n  constructor(config: AttentionConfig & { numExperts?: number }) {\n    this.hiddenDim = config.hiddenDim;\n    this.numExperts = config.numExperts || 4;\n\n    try {\n      // MoEAttention constructor may have different signature in different versions\n      this.nativeInstance = new (nativeAttention.MoEAttention as any)(\n        this.hiddenDim\n      );\n    } catch (error: any) {\n      throw new Error(`Failed to initialize native MoEAttention: ${error.message}`);\n    }\n  }\n\n  forward(\n    query: number[] | Float32Array,\n    key: number[] | Float32Array,\n    value: number[] | Float32Array,\n    topK: number = 2\n  ): { output: number[]; expertWeights: number[] } {\n    try {\n      const q = toFloat32Array(query);\n      const k = toFloat32Array(key);\n      const v = toFloat32Array(value);\n\n      const result = this.nativeInstance.compute(q, k, v, topK);\n\n      return {\n        output: toArray(result.output),\n        expertWeights: toArray(result.expertWeights)\n      };\n    } catch (error: any) {\n      throw new Error(`MoEAttention forward failed: ${error.message}`);\n    }\n  }\n}\n\n/**\n * Scaled Dot-Product Attention (pure JavaScript, always works)\n */\nexport function scaledDotProductAttention(\n  query: number[],\n  key: number[],\n  value: number[],\n  mask?: number[]\n): { output: number[]; weights: number[] } {\n  const dk = query.length;\n\n  // Compute attention scores: Q · K^T / sqrt(dk)\n  let score = 0;\n  for (let i = 0; i < dk; i++) {\n    score += query[i] * key[i];\n  }\n  score /= Math.sqrt(dk);\n\n  // Apply mask if provided\n  if (mask && mask[0] === 0) {\n    score = -Infinity;\n  }\n\n  // Softmax (single score version)\n  const expScore = Math.exp(score);\n  const weight = expScore;\n\n  // Weighted value\n  const output = value.map(v => v * weight);\n\n  return { output, weights: [weight] };\n}\n\n/**\n * Check if native attention is available\n */\nexport function isNativeAttentionAvailable(): boolean {\n  try {\n    const test = new nativeAttention.MultiHeadAttention(128, 4);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Factory function to create appropriate attention module\n */\nexport function createAttention(\n  type: 'multi-head' | 'flash' | 'linear' | 'hyperbolic' | 'moe',\n  config: AttentionConfig\n): MultiHeadAttention | FlashAttention | LinearAttention | HyperbolicAttention | MoEAttention {\n  switch (type) {\n    case 'multi-head':\n      return new MultiHeadAttention(config);\n    case 'flash':\n      return new FlashAttention(config);\n    case 'linear':\n      return new LinearAttention(config);\n    case 'hyperbolic':\n      return new HyperbolicAttention(config);\n    case 'moe':\n      return new MoEAttention(config);\n    default:\n      return new MultiHeadAttention(config);\n  }\n}\n"]}