agentdb 3.0.0-alpha.9 → 3.1.0

package/dist/src/compatibility/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Backwards Compatibility Layer - Main Exports
+ *
+ * Provides v1.x to v2.0 compatibility for AgenticFlow
+ */
+export { VersionDetector } from './VersionDetector';
+export { V1toV2Adapter } from './V1toV2Adapter';
+export { DeprecationWarnings } from './DeprecationWarnings';
+export { MigrationUtilities } from './MigrationUtilities';
+export type { APIVersion, CompatibilityConfig, V1Config, V2Config, DeprecationWarning, DeprecationConfig, MigrationReport, ValidationResult, VersionDetectionResult } from './types';
+export declare const analyzeMigration: (code: string) => import("./types").MigrationReport;
+export declare const migrateCode: (code: string) => string;
+export declare const convertConfig: (v1Config: any) => import("./types").V2Config;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/compatibility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compatibility/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,QAAQ,EACR,QAAQ,EACR,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,SAAS,CAAC;AAKjB,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,sCAE5C,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,WAEvC,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,UAAU,GAAG,+BAE1C,CAAC"}

package/dist/src/compatibility/index.js

@@ -0,0 +1,21 @@
+/**
+ * Backwards Compatibility Layer - Main Exports
+ *
+ * Provides v1.x to v2.0 compatibility for AgenticFlow
+ */
+export { VersionDetector } from './VersionDetector';
+export { V1toV2Adapter } from './V1toV2Adapter';
+export { DeprecationWarnings } from './DeprecationWarnings';
+export { MigrationUtilities } from './MigrationUtilities';
+// Re-export convenience functions for quick migration analysis
+import { MigrationUtilities } from './MigrationUtilities';
+export const analyzeMigration = (code) => {
+    return MigrationUtilities.analyzeCode(code);
+};
+export const migrateCode = (code) => {
+    return MigrationUtilities.generateMigrationScript(code);
+};
+export const convertConfig = (v1Config) => {
+    return MigrationUtilities.convertV1ConfigToV2(v1Config);
+};
+//# sourceMappingURL=index.js.map

package/dist/src/compatibility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/compatibility/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAc1D,+DAA+D;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,EAAE;IAC/C,OAAO,kBAAkB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE;IAC1C,OAAO,kBAAkB,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAa,EAAE,EAAE;IAC7C,OAAO,kBAAkB,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAC1D,CAAC,CAAC"}

package/dist/src/compatibility/types.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Type definitions for v1.x to v2.0 compatibility layer
+ */
+export type APIVersion = '1.x' | '2.0';
+export interface CompatibilityConfig {
+    version?: APIVersion;
+    preferV2?: boolean;
+    deprecationWarnings?: boolean;
+    strictMode?: boolean;
+    logDeprecations?: string;
+    features?: {
+        agentDB?: boolean;
+        attention?: boolean;
+        gnnLearning?: boolean;
+        causalReasoning?: boolean;
+        reasoningBank?: boolean;
+    };
+    enableOptimizations?: boolean;
+    preserveV1Behavior?: boolean;
+}
+export interface V1Config {
+    memoryPath?: string;
+    optimizeMemory?: boolean;
+    topology?: 'mesh' | 'hierarchical' | 'ring' | 'star';
+    maxAgents?: number;
+    strategy?: string;
+    provider?: string;
+    model?: string;
+    deprecationWarnings?: boolean;
+    strictMode?: boolean;
+}
+export interface V2Config {
+    backend: 'agentdb';
+    version: '2.0';
+    memory: {
+        path: string;
+        backend: 'ruvector' | 'sqlite';
+        enableHNSW?: boolean;
+        enableQuantization?: boolean;
+        cacheSize?: number;
+        batchSize?: number;
+    };
+    swarm: {
+        topology: 'mesh' | 'hierarchical' | 'ring' | 'star';
+        maxAgents: number;
+        strategy: 'auto' | 'balanced' | 'specialized';
+    };
+    routing: {
+        provider: string;
+        model: string;
+        optimization: 'quality' | 'balanced' | 'cost' | 'speed';
+    };
+    intelligence?: {
+        attentionMechanisms?: string[];
+        gnnLearning?: boolean;
+        causalReasoning?: boolean;
+        reasoningBank?: boolean;
+    };
+    compatibility?: {
+        v1Mode: boolean;
+        preserveV1Behavior: boolean;
+        emitWarnings: boolean;
+    };
+}
+export interface DeprecationWarning {
+    api: string;
+    message: string;
+    migration: string;
+    documentation: string;
+    severity: 'info' | 'warning' | 'error';
+    timestamp: number;
+}
+export interface DeprecationConfig {
+    emitWarnings?: boolean;
+    throwOnDeprecated?: boolean;
+    logToFile?: string;
+    severity?: 'silent' | 'soft' | 'prominent';
+}
+export interface MigrationReport {
+    v1APIsFound: Array<{
+        api: string;
+        occurrences: number;
+        replacement: string;
+    }>;
+    suggestedMigrations: Array<{
+        from: string;
+        to: string;
+        difficulty: 'easy' | 'medium' | 'hard';
+        automatic: boolean;
+    }>;
+    estimatedEffort: 'none' | 'low' | 'medium' | 'high';
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface VersionDetectionResult {
+    version: APIVersion;
+    confidence: number;
+    indicators: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/compatibility/types.d.ts.map

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

package/dist/src/compatibility/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for v1.x to v2.0 compatibility layer
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/compatibility/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/compatibility/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/controllers/AttentionService.d.ts

@@ -3,15 +3,11 @@
  *
  * Provides state-of-the-art attention mechanisms with runtime detection:
  * - MultiHeadAttention (standard transformer attention)
- * - FlashAttention (memory-efficient attention, 7.47x speedup)
+ * - FlashAttention (memory-efficient attention)
  * - HyperbolicAttention (hyperbolic space attention)
  * - MoEAttention (Mixture-of-Experts attention)
  * - LinearAttention (linear complexity attention)
  *
- * ADR-064 Phase 1: Native Flash Attention integration with @ruvector/attention
- * bindings for 7.47x speedup. High-level API (applyFlashAttention, applyMultiHeadAttention,
- * applyMoE) works with number[] arrays for ergonomic MCP tool usage.
- *
  * Features:
  * - Automatic runtime detection (Node.js NAPI vs Browser WASM)
  * - Zero-copy Float32Array processing
@@ -19,112 +15,43 @@
  * - Performance monitoring hooks
  * - Type-safe interfaces
  */
+import { AttentionConfig, AttentionOptions, AttentionResult } from './attention/AttentionConfig.js';
+import { AttentionStats, AttentionMetrics } from './attention/AttentionMetrics.js';
+import { RuntimeEnvironment } from './attention/AttentionWASM.js';
+import type { GraphEdges } from '../types/graph.js';
+export type { AttentionConfig, AttentionOptions, AttentionResult, AttentionStats, AttentionMetrics };
 /**
- * Configuration for attention mechanisms
- */
-export interface AttentionConfig {
-    /** Number of attention heads */
-    numHeads: number;
-    /** Dimension of each head */
-    headDim: number;
-    /** Total embedding dimension (usually numHeads * headDim) */
-    embedDim: number;
-    /** Dropout probability (0-1) */
-    dropout?: number;
-    /** Whether to use bias in linear projections */
-    bias?: boolean;
-    /** Use Flash Attention optimization if available */
-    useFlash?: boolean;
-    /** Use Linear Attention for O(n) complexity */
-    useLinear?: boolean;
-    /** Use Hyperbolic space for hierarchical data */
-    useHyperbolic?: boolean;
-    /** Use Mixture-of-Experts routing */
-    useMoE?: boolean;
-    /** Number of experts for MoE (default: 8) */
-    numExperts?: number;
-    /** Top-k experts to activate in MoE (default: 2) */
-    topK?: number;
-    /** Force native bindings (true) or JS fallback (false). Default: auto-detect. */
-    useNative?: boolean;
-}
-/**
- * Options for attention operations (alias for AttentionConfig)
- */
-export type AttentionOptions = AttentionConfig;
-/**
- * Result from attention computation
- */
-export interface AttentionResult {
-    /** Output embeddings after attention */
-    output: Float32Array;
-    /** Attention weights (optional, for visualization) */
-    weights?: Float32Array;
-    /** Execution time in milliseconds */
-    executionTimeMs: number;
-    /** Which mechanism was used */
-    mechanism: 'multi-head' | 'flash' | 'linear' | 'hyperbolic' | 'moe';
-    /** Runtime environment */
-    runtime: 'napi' | 'wasm' | 'fallback';
-}
-/**
- * Statistics about attention operations
- */
-export interface AttentionStats {
-    /** Total attention operations performed */
-    totalOps: number;
-    /** Average execution time in milliseconds */
-    avgExecutionTimeMs: number;
-    /** Peak memory usage in bytes */
-    peakMemoryBytes: number;
-    /** Mechanism usage counts */
-    mechanismCounts: Record<string, number>;
-    /** Runtime usage counts */
-    runtimeCounts: Record<string, number>;
-}
-/**
- * Performance metrics for attention operations (alias for AttentionStats)
- */
-export type AttentionMetrics = AttentionStats;
-/**
- * Runtime environment detection
- */
-type RuntimeEnvironment = 'nodejs' | 'browser' | 'unknown';
-/**
- * AttentionService - Main controller for attention mechanisms
+ * AttentionService - Main orchestration layer for attention mechanisms
  *
- * ADR-062 Phase 2: Enhanced with explicit native binding detection,
- * engine type reporting, and @ruvector/graph-transformer integration.
+ * Delegates to specialized classes:
+ * - AttentionConfigManager: Configuration and constants
+ * - AttentionMetricsTracker: Performance monitoring
+ * - AttentionCacheManager: Buffer pooling and mask caching
+ * - AttentionWASMManager: WASM/NAPI module loading
+ * - AttentionCoreCompute: Core computation algorithms
  */
 export declare class AttentionService {
-    private config;
-    private runtime;
-    private napiModule;
-    private wasmModule;
+    private configManager;
+    private metricsTracker;
+    private cacheManager;
+    private wasmManager;
+    private coreCompute;
+    private sparsificationService?;
+    private mincutService?;
     private initialized;
-    private engineType;
-    private stats;
+    private initPromise;
+    private warmedUp;
     constructor(config: AttentionConfig);
-    /**
-     * Get the active engine type: 'napi', 'wasm', or 'fallback'
-     */
-    getEngineType(): string;
     /**
      * Initialize the attention service
      * Automatically detects and loads the appropriate backend (NAPI or WASM)
+     * Thread-safe with promise guard to prevent concurrent initialization
      */
     initialize(): Promise<void>;
     /**
-     * Load NAPI module for Node.js runtime
-     *
-     * ADR-062: Tries native @ruvector/attention first, then
-     * @ruvector/graph-transformer sublinear attention as a secondary path.
+     * Internal initialization implementation
      */
-    private loadNAPIModule;
-    /**
-     * Load WASM module for browser runtime
-     */
-    private loadWASMModule;
+    private _doInitialize;
     /**
      * Compute multi-head attention
      *
@@ -137,64 +64,59 @@ export declare class AttentionService {
     multiHeadAttention(query: Float32Array, key: Float32Array, value: Float32Array, mask?: Float32Array): Promise<AttentionResult>;
     /**
      * Compute Flash Attention (memory-efficient)
-     *
-     * Flash Attention reduces memory usage from O(n²) to O(n) for sequence length n
-     *
-     * @param query - Query vectors
-     * @param key - Key vectors
-     * @param value - Value vectors
-     * @param mask - Optional attention mask
-     * @returns Attention output and metadata
      */
     flashAttention(query: Float32Array, key: Float32Array, value: Float32Array, mask?: Float32Array): Promise<AttentionResult>;
+    /**
+     * Compute Flash Attention v2 (optimized memory-efficient attention)
+     */
+    flashAttentionV2(query: Float32Array, key: Float32Array, value: Float32Array, options?: {
+        mask?: Float32Array;
+        causal?: boolean;
+        windowSize?: number;
+        dropout?: number;
+    }): Promise<AttentionResult & {
+        speedup?: number;
+        baselineTimeMs?: number;
+    }>;
     /**
      * Compute Linear Attention (O(n) complexity)
-     *
-     * Linear attention approximates standard attention with linear complexity
-     *
-     * @param query - Query vectors
-     * @param key - Key vectors
-     * @param value - Value vectors
-     * @returns Attention output and metadata
      */
     linearAttention(query: Float32Array, key: Float32Array, value: Float32Array): Promise<AttentionResult>;
     /**
      * Compute Hyperbolic Attention (for hierarchical data)
-     *
-     * Hyperbolic attention operates in hyperbolic space, suitable for tree-like structures
-     *
-     * @param query - Query vectors
-     * @param key - Key vectors
-     * @param value - Value vectors
-     * @param curvature - Hyperbolic space curvature (default: -1.0)
-     * @returns Attention output and metadata
      */
     hyperbolicAttention(query: Float32Array, key: Float32Array, value: Float32Array, curvature?: number): Promise<AttentionResult>;
     /**
-     * Compute Mixture-of-Experts (MoE) Attention
+     * Compute Fused Attention (optimized single-pass attention)
      *
-     * MoE routes inputs to different expert attention mechanisms
+     * Fused attention combines softmax and weighted sum in a single pass
+     * for 20-25% performance improvement through better cache locality.
      *
-     * @param query - Query vectors
-     * @param key - Key vectors
-     * @param value - Value vectors
-     * @param mask - Optional attention mask
-     * @returns Attention output and metadata
-     */
-    moeAttention(query: Float32Array, key: Float32Array, value: Float32Array, mask?: Float32Array): Promise<AttentionResult>;
-    /**
-     * Fallback JavaScript implementation of multi-head attention
-     * Used when native modules are not available
-     */
-    private multiHeadAttentionFallback;
+     * @param query - Query vectors [seqLen * embedDim]
+     * @param key - Key vectors [seqLen * embedDim]
+     * @param value - Value vectors [seqLen * embedDim]
+     * @param options - Fused attention options
+     * @returns Attention output and performance metrics
+     */
+    fusedAttention(query: Float32Array, key: Float32Array, value: Float32Array, options?: {
+        blockSize?: number;
+        mask?: Float32Array;
+        compareBaseline?: boolean;
+    }): Promise<{
+        output: Float32Array;
+        speedup?: number;
+        baselineTimeMs?: number;
+        fusedTimeMs?: number;
+    }>;
     /**
-     * Fallback JavaScript implementation of linear attention
+     * Compute Mixture-of-Experts (MoE) Attention
      */
-    private linearAttentionFallback;
+    moeAttention(query: Float32Array, key: Float32Array, value: Float32Array, mask?: Float32Array): Promise<AttentionResult>;
     /**
-     * Update performance statistics
+     * Warm up JIT with small dummy computation
+     * Eliminates first-call JIT spikes (50-100ms → 5-10ms)
      */
-    private updateStats;
+    private warmUp;
     /**
      * Get performance statistics
      */
@@ -203,6 +125,44 @@ export declare class AttentionService {
      * Reset performance statistics
      */
     resetStats(): void;
+    /**
+     * Dispose of resources and clean up
+     * Call this when AttentionService is no longer needed
+     */
+    dispose(): Promise<void>;
+    /**
+     * Compute Sparse Attention
+     *
+     * Uses graph sparsification to reduce the number of attention edges,
+     * achieving 10-100x speedup for large graphs (N > 10K nodes).
+     *
+     * @param query - Query vector for attention scoring
+     * @param graphEdges - Graph adjacency list (node -> neighbors)
+     * @param options - Sparse attention options
+     * @returns Attention result with sparsity metadata
+     */
+    sparseAttention(query: Float32Array, graphEdges: GraphEdges, options?: {
+        useMincut?: boolean;
+        sparsificationRatio?: number;
+        method?: 'ppr' | 'random-walk' | 'spectral';
+        topK?: number;
+    }): Promise<AttentionResult>;
+    /**
+     * Compute Partitioned Attention
+     *
+     * Uses graph mincut algorithms to partition the graph, then applies
+     * attention within each partition independently. Achieves 50-80% memory
+     * reduction through intelligent clustering.
+     *
+     * @param query - Query vector for attention scoring
+     * @param graphEdges - Graph adjacency list
+     * @param options - Partitioned attention options
+     * @returns Attention result with partitioning metadata
+     */
+    partitionedAttention(query: Float32Array, graphEdges: GraphEdges, options?: {
+        method?: 'stoer-wagner' | 'karger' | 'flow-based';
+        maxPartitionSize?: number;
+    }): Promise<AttentionResult>;
     /**
      * Get service information
      */
@@ -213,68 +173,5 @@ export declare class AttentionService {
         hasWASM: boolean;
         config: AttentionConfig;
     };
-    /**
-     * Apply Flash Attention to query against key/value context vectors.
-     * Returns attention-weighted output (7.47x faster with native bindings).
-     *
-     * @param query  - Query vector (number[])
-     * @param keys   - Key vectors (number[][])
-     * @param values - Value vectors (number[][])
-     * @param options - Optional head count and dropout rate
-     * @returns Attention-weighted output vector
-     */
-    applyFlashAttention(query: number[], keys: number[][], values: number[][], options?: {
-        headCount?: number;
-        dropoutRate?: number;
-    }): Promise<number[]>;
-    /**
-     * Apply Multi-Head Attention for 5x better relevance scoring.
-     *
-     * @param query    - Query vector (number[])
-     * @param context  - Context vectors (number[][])
-     * @param numHeads - Number of attention heads (default: 8)
-     * @returns Attention output and per-context weight matrix
-     */
-    applyMultiHeadAttention(query: number[], context: number[][], numHeads?: number): Promise<{
-        attention: number[];
-        weights: number[][];
-    }>;
-    /**
-     * Apply Mixture-of-Experts routing for dynamic expert selection.
-     *
-     * @param input   - Input vector (number[])
-     * @param experts - Number of expert models
-     * @param topK    - Top-K experts to use (default: 2)
-     * @returns Output vector and expert gating weights
-     */
-    applyMoE(input: number[], experts: number, topK?: number): Promise<{
-        output: number[];
-        expertWeights: number[];
-    }>;
-    /**
-     * JS fallback for Flash Attention (dot-product attention over key/value pairs).
-     */
-    private applyAttentionJS;
-    /**
-     * JS fallback for Multi-Head Attention.
-     */
-    private applyMultiHeadJS;
-    /**
-     * JS fallback for Mixture of Experts.
-     */
-    private applyMoEJS;
-    /**
-     * Compute gating weights for MoE (top-K selection with softmax).
-     */
-    private computeGatingWeights;
-    /**
-     * Reshape flat weight buffer into per-context weight matrix.
-     */
-    private reshapeWeights;
-    /**
-     * Compute fallback attention weights via cosine similarity.
-     */
-    private computeFallbackWeights;
 }
-export {};
 //# sourceMappingURL=AttentionService.d.ts.map

package/dist/src/controllers/AttentionService.d.ts.map

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