agentic-flow 2.0.1 → 2.0.2-alpha

package/dist/core/agentdb-fast.js

@@ -1,308 +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 'agentdb';
-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;
-    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 - use any for flexible config
-            this.db = new AgentDB({
-                dimensions: this.config.vectorDimensions,
-                storagePath: this.config.path
-            });
-            await this.db.initialize();
-            // Access the vector backend as a direct property
-            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
-        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 });
-        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);
-        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 });
-        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
-        {});
-        const episodes = allResults.filter((r) => r.metadata?.type === 'episode');
-        const patterns = allResults.filter((r) => r.metadata?.type === 'pattern');
-        const avgQuality = 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();
-    const episodeId = 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/core/agentdb-fast.js.map

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

package/dist/core/agentdb-wrapper-enhanced.d.ts

@@ -1,240 +0,0 @@
-/**
- * Enhanced AgentDBWrapper - Full integration with Attention & GNN
- *
- * Provides advanced features:
- * - 5 Attention Mechanisms (Flash, Multi-Head, Linear, Hyperbolic, MoE)
- * - GNN Query Refinement (+12.4% recall improvement)
- * - GraphRoPE Position Embeddings
- * - Attention-based Multi-Agent Coordination
- *
- * @module agentdb-wrapper-enhanced
- * @version 2.0.0-alpha
- */
-import { AgentDB } from 'agentdb';
-import type { AgentDBConfig, VectorEntry, VectorSearchOptions, VectorSearchResult, MemoryInsertOptions, MemoryUpdateOptions, MemoryDeleteOptions, MemoryGetOptions, AgentDBStats, BatchInsertResult, AttentionResult, AttentionType, GraphContext, GNNRefinementResult, AdvancedSearchOptions } from '../types/agentdb.js';
-/**
- * Enhanced wrapper class with full Attention & GNN support
- *
- * @example Flash Attention
- * ```typescript
- * const wrapper = new EnhancedAgentDBWrapper({
- *   dimension: 768,
- *   enableAttention: true,
- *   attentionConfig: {
- *     type: 'flash',
- *     numHeads: 8,
- *     headDim: 64
- *   }
- * });
- *
- * await wrapper.initialize();
- *
- * // 4x faster with 75% memory reduction!
- * const results = await wrapper.attentionSearch(query, candidates, 'flash');
- * ```
- *
- * @example GNN Query Refinement
- * ```typescript
- * const wrapper = new EnhancedAgentDBWrapper({
- *   dimension: 768,
- *   enableGNN: true,
- *   gnnConfig: {
- *     numLayers: 3,
- *     hiddenDim: 256,
- *     numHeads: 8
- *   }
- * });
- *
- * // +12.4% recall improvement!
- * const results = await wrapper.gnnEnhancedSearch(query, {
- *   k: 10,
- *   graphContext: agentMemoryGraph
- * });
- * ```
- */
-export declare class EnhancedAgentDBWrapper {
-    private agentDB;
-    private config;
-    private initialized;
-    private dimension;
-    private namespace;
-    private reflexionController;
-    private embedder;
-    private vectorBackend;
-    private attentionService;
-    private gnnService;
-    private metrics;
-    _agentDB?: any;
-    _embedder?: any;
-    _vectorBackend?: any;
-    _attentionService?: any;
-    _gnnService?: any;
-    constructor(config?: AgentDBConfig);
-    /**
-     * Initialize AgentDB, AttentionService, and GNNService
-     */
-    initialize(): Promise<void>;
-    /**
-     * Initialize AttentionService with runtime detection
-     */
-    private initializeAttentionService;
-    /**
-     * Initialize GNNService for query refinement
-     */
-    private initializeGNNService;
-    /**
-     * Log initialization summary
-     */
-    private logInitializationSummary;
-    /**
-     * Ensure wrapper is initialized
-     */
-    private ensureInitialized;
-    /**
-     * Validate vector dimension
-     */
-    private validateVectorDimension;
-    /**
-     * Generate unique ID
-     */
-    private generateId;
-    insert(options: MemoryInsertOptions): Promise<{
-        id: string;
-        timestamp: number;
-    }>;
-    vectorSearch(query: Float32Array, options?: VectorSearchOptions): Promise<VectorSearchResult[]>;
-    update(options: MemoryUpdateOptions): Promise<boolean>;
-    delete(options: MemoryDeleteOptions): Promise<boolean>;
-    get(options: MemoryGetOptions): Promise<VectorEntry | null>;
-    batchInsert(entries: MemoryInsertOptions[]): Promise<BatchInsertResult>;
-    getStats(): Promise<AgentDBStats>;
-    close(): Promise<void>;
-    getRawInstance(): AgentDB;
-    /**
-     * Attention-based search with configurable mechanism
-     *
-     * @param query - Query vector
-     * @param candidates - Pre-retrieved candidates from HNSW
-     * @param mechanism - Attention type to use
-     * @returns AttentionResult with performance metrics
-     *
-     * @example Flash Attention (4x faster)
-     * ```typescript
-     * const result = await wrapper.attentionSearch(query, candidates, 'flash');
-     * console.log(`Speedup: ${result.mechanism}, Time: ${result.executionTimeMs}ms`);
-     * ```
-     */
-    attentionSearch(query: Float32Array, candidates: VectorSearchResult[], mechanism?: AttentionType): Promise<AttentionResult>;
-    /**
-     * Multi-Head Attention (Standard Transformer)
-     *
-     * Complexity: O(n²)
-     * Best for: General-purpose attention, standard retrieval
-     * Performance: ~15ms P50 for 512 tokens
-     */
-    multiHeadAttention(Q: Float32Array, K: Float32Array, V: Float32Array): Promise<AttentionResult>;
-    /**
-     * Flash Attention (Memory-Efficient)
-     *
-     * Complexity: O(n²) with O(n) memory
-     * Best for: Long sequences, memory-constrained environments
-     * Performance: ~3ms P50 for 512 tokens (4x faster than multi-head!)
-     * Memory: 75% reduction
-     */
-    flashAttention(Q: Float32Array, K: Float32Array, V: Float32Array): Promise<AttentionResult>;
-    /**
-     * Linear Attention (O(N) Complexity)
-     *
-     * Complexity: O(n)
-     * Best for: Very long sequences (>2048 tokens)
-     * Performance: ~18ms P50 for 2048 tokens
-     */
-    linearAttention(Q: Float32Array, K: Float32Array, V: Float32Array): Promise<AttentionResult>;
-    /**
-     * Hyperbolic Attention (Hierarchical Reasoning)
-     *
-     * Complexity: O(n²) in hyperbolic space
-     * Best for: Tree-structured data, agent hierarchies
-     * Performance: ~8ms P50 for 512 tokens
-     */
-    hyperbolicAttention(Q: Float32Array, K: Float32Array, V: Float32Array, curvature?: number): Promise<AttentionResult>;
-    /**
-     * Mixture-of-Experts (MoE) Attention
-     *
-     * Complexity: Sparse O(n²)
-     * Best for: Multi-agent systems with specialized agents
-     * Performance: ~20ms P50 for 512 tokens
-     */
-    moeAttention(Q: Float32Array, K: Float32Array, V: Float32Array, numExperts?: number): Promise<AttentionResult>;
-    /**
-     * GraphRoPE Attention (Graph-aware Position Embeddings)
-     *
-     * Complexity: O(n²) with graph structure
-     * Best for: Multi-agent coordination with topology awareness
-     * Use case: Mesh, hierarchical, ring topologies
-     */
-    graphRoPEAttention(Q: Float32Array, K: Float32Array, V: Float32Array, graphStructure: GraphContext): Promise<AttentionResult>;
-    /**
-     * GNN-enhanced search with +12.4% recall improvement
-     *
-     * @param query - Query vector
-     * @param options - Advanced search options with graph context
-     * @returns GNN refinement result with performance metrics
-     *
-     * @example
-     * ```typescript
-     * const result = await wrapper.gnnEnhancedSearch(query, {
-     *   k: 10,
-     *   graphContext: { nodes, edges }
-     * });
-     * console.log(`Recall improvement: +${result.improvementPercent}%`);
-     * ```
-     */
-    gnnEnhancedSearch(query: Float32Array, options: AdvancedSearchOptions): Promise<GNNRefinementResult>;
-    /**
-     * GNN-based re-ranking of candidates
-     */
-    private gnnRerank;
-    /**
-     * Build graph edges between candidates based on similarity
-     */
-    private buildCandidateGraph;
-    /**
-     * Stack multiple vectors into single tensor
-     */
-    private stackVectors;
-    /**
-     * Unstack tensor into individual vectors
-     */
-    private unstackVectors;
-    /**
-     * Calculate recall@k metric
-     */
-    private calculateRecall;
-    /**
-     * Calculate cosine similarity
-     */
-    private cosineSimilarity;
-    /**
-     * Get performance metrics
-     */
-    getPerformanceMetrics(): {
-        averageAttentionTime: number;
-        averageGNNTime: number;
-        attentionCalls: number;
-        gnnCalls: number;
-        totalAttentionTime: number;
-        totalGNNTime: number;
-        averageSpeedup: number;
-        averageRecallImprovement: number;
-    };
-    /**
-     * Get attention service for direct access
-     */
-    getAttentionService(): any;
-    /**
-     * Get GNN service for direct access
-     */
-    getGNNService(): any;
-}
-//# sourceMappingURL=agentdb-wrapper-enhanced.d.ts.map

package/dist/core/agentdb-wrapper-enhanced.d.ts.map

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