agentic-flow 2.0.1-alpha.2 → 2.0.1-alpha.20

package/dist/mcp/fastmcp/tools/hooks/intelligence-bridge.d.ts

@@ -0,0 +1,307 @@
+/**
+ * Intelligence Bridge - Connects hooks to RuVectorIntelligence layer
+ *
+ * This bridges the gap between hook tools and the full RuVector ecosystem:
+ * - @ruvector/sona: Micro-LoRA, EWC++, ReasoningBank, Trajectories
+ * - @ruvector/attention: MoE, Flash, Hyperbolic, Graph attention
+ * - ruvector core: HNSW indexing (150x faster search)
+ *
+ * Persistence: SQLite-based storage for cross-platform compatibility
+ */
+import { RuVectorIntelligence, type AgentRoutingResult, type Trajectory, type LearningOutcome } from '../../../../intelligence/index.js';
+import { type IntelligenceStore } from '../../../../intelligence/IntelligenceStore.js';
+/**
+ * Get the SQLite store singleton
+ */
+export declare function getStore(): IntelligenceStore;
+/**
+ * Get or create the RuVectorIntelligence singleton
+ */
+export declare function getIntelligence(): Promise<RuVectorIntelligence>;
+/**
+ * Route a task using SONA + MoE Attention + HNSW
+ *
+ * This replaces the simple keyword-based routing with:
+ * 1. HNSW for O(log n) candidate retrieval
+ * 2. Micro-LoRA transformation (~0.05ms)
+ * 3. MoE attention-based ranking
+ */
+export declare function routeTaskIntelligent(task: string, context?: {
+    file?: string;
+    recentFiles?: string[];
+    errorContext?: string;
+}): Promise<{
+    agent: string;
+    confidence: number;
+    routingResults: AgentRoutingResult[];
+    latencyMs: number;
+    usedFeatures: string[];
+}>;
+/**
+ * Begin a trajectory for learning from task execution
+ *
+ * Trajectories track:
+ * - Task context and embeddings
+ * - Agent actions and decisions
+ * - Attention patterns at each step
+ * - Final outcomes for reinforcement
+ */
+export declare function beginTaskTrajectory(task: string, agent: string): Promise<{
+    trajectoryId: number;
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * Record a step in the trajectory
+ */
+export declare function recordTrajectoryStep(trajectoryId: number, action: string, reward: number, context?: {
+    file?: string;
+    errorFixed?: boolean;
+    testPassed?: boolean;
+}): Promise<void>;
+/**
+ * End a trajectory and get learning outcome
+ */
+export declare function endTaskTrajectory(trajectoryId: number, success: boolean, quality?: number): Promise<LearningOutcome | null>;
+/**
+ * Store a pattern by registering it as an agent-like entity
+ */
+export declare function storePattern(task: string, resolution: string, reward: number): Promise<void>;
+/**
+ * Find similar patterns using routing
+ */
+export declare function findSimilarPatterns(task: string, topK?: number): Promise<Array<{
+    task: string;
+    resolution: string;
+    reward: number;
+    similarity: number;
+}>>;
+/**
+ * Get intelligence stats for monitoring
+ */
+export declare function getIntelligenceStats(): Promise<{
+    initialized: boolean;
+    features: string[];
+    trajectoryCount: number;
+    activeTrajectories: number;
+    learningEnabled: boolean;
+    persistedStats?: {
+        trajectories: number;
+        routings: number;
+        patterns: number;
+        operations: number;
+    };
+}>;
+/**
+ * Force a learning cycle (useful for batch learning)
+ */
+export declare function forceLearningCycle(): Promise<string>;
+/**
+ * Compute attention-weighted similarity for advanced routing
+ */
+export declare function computeAttentionSimilarity(query: Float32Array, candidates: Float32Array[]): Promise<number[]>;
+/**
+ * Queue an episode for batch Q-learning (3-4x faster)
+ * Episodes are batched and processed in parallel
+ */
+export declare function queueEpisode(episode: {
+    state: string;
+    action: string;
+    reward: number;
+    nextState: string;
+    done: boolean;
+}): Promise<void>;
+/**
+ * Flush queued episodes for batch processing
+ * Processes in parallel with worker threads
+ */
+export declare function flushEpisodeBatch(): Promise<{
+    processed: number;
+    parallelEnabled: boolean;
+}>;
+/**
+ * Match patterns in parallel across multiple files
+ * Provides 3-4x faster pretrain
+ */
+export declare function matchPatternsParallel(files: Array<{
+    path: string;
+    content: string;
+}>): Promise<Array<{
+    path: string;
+    patterns: string[];
+    similarity: number;
+}>>;
+/**
+ * Index memories in background (non-blocking hooks)
+ */
+export declare function indexMemoriesBackground(memories: Array<{
+    id: string;
+    text: string;
+    metadata?: Record<string, any>;
+}>): Promise<{
+    queued: number;
+    processing: boolean;
+}>;
+/**
+ * Parallel similarity search with sharding
+ */
+export declare function searchParallel(query: string, topK?: number): Promise<Array<{
+    id: string;
+    text: string;
+    similarity: number;
+}>>;
+/**
+ * Analyze multiple files in parallel for routing
+ */
+export declare function analyzeFilesParallel(files: Array<{
+    path: string;
+    content: string;
+}>): Promise<Array<{
+    path: string;
+    agent: string;
+    confidence: number;
+}>>;
+/**
+ * Analyze git commits in parallel for co-edit detection
+ */
+export declare function analyzeCommitsParallel(commits: Array<{
+    hash: string;
+    message: string;
+    files: string[];
+}>): Promise<Array<{
+    hash: string;
+    coEditGroups: string[][];
+    patterns: string[];
+}>>;
+/**
+ * Get parallel stats
+ */
+export declare function getParallelStats(): Promise<{
+    parallelEnabled: boolean;
+    parallelWorkers: number;
+    parallelBusy: number;
+    parallelQueued: number;
+}>;
+/**
+ * Speculatively pre-embed files that are likely to be accessed
+ * Call in post-edit hook for related files
+ */
+export declare function speculativeEmbed(files: string[]): Promise<{
+    queued: number;
+}>;
+/**
+ * Analyze AST of multiple files in parallel
+ * For pre-edit and route hooks
+ */
+export declare function analyzeAST(files: Array<{
+    path: string;
+    content: string;
+}>): Promise<Array<{
+    path: string;
+    functions: string[];
+    imports: string[];
+    exports: string[];
+}>>;
+/**
+ * Analyze code complexity metrics in parallel
+ * For session-end hook to track quality
+ */
+export declare function analyzeComplexity(files: string[]): Promise<Array<{
+    path: string;
+    cyclomatic: number;
+    cognitive: number;
+    lines: number;
+}>>;
+/**
+ * Build dependency graph from import statements
+ * For session-start hook context
+ */
+export declare function buildDependencyGraph(files: string[]): Promise<{
+    nodes: string[];
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+}>;
+/**
+ * Parallel security scan (SAST)
+ * For pre-command hook before commits
+ */
+export declare function securityScan(files: string[]): Promise<Array<{
+    path: string;
+    severity: string;
+    message: string;
+    line: number;
+}>>;
+/**
+ * RAG retrieval with parallel chunk processing
+ * For recall hook
+ */
+export declare function ragRetrieve(query: string, chunks: Array<{
+    id: string;
+    text: string;
+}>, topK?: number): Promise<Array<{
+    id: string;
+    text: string;
+    score: number;
+}>>;
+/**
+ * Rank context by relevance
+ * For suggest-context hook
+ */
+export declare function rankContext(query: string, contexts: Array<{
+    id: string;
+    content: string;
+}>): Promise<Array<{
+    id: string;
+    relevance: number;
+}>>;
+/**
+ * Semantic deduplication
+ * For remember hook to avoid storing duplicates
+ */
+export declare function deduplicate(texts: string[], threshold?: number): Promise<{
+    unique: string[];
+    duplicateGroups: number[][];
+}>;
+/**
+ * Parallel git blame analysis
+ * For co-edit hook
+ */
+export declare function gitBlame(files: string[]): Promise<Array<{
+    path: string;
+    authors: Array<{
+        name: string;
+        lines: number;
+    }>;
+}>>;
+/**
+ * Code churn metrics for routing decisions
+ * For route hook to prioritize high-churn files
+ */
+export declare function gitChurn(patterns: string[], since?: string): Promise<Array<{
+    path: string;
+    commits: number;
+    additions: number;
+    deletions: number;
+}>>;
+/**
+ * Get attention mechanism for specific use case
+ */
+export declare function getAttentionForUseCase(useCase: 'pattern-matching' | 'agent-routing' | 'code-structure' | 'context-summary' | 'multi-agent'): Promise<{
+    type: string;
+    instance: any;
+}>;
+/**
+ * Parallel attention compute across multiple queries
+ */
+export declare function parallelAttentionCompute(queries: Float32Array[], keys: Float32Array[], values: Float32Array[], type?: 'hyperbolic' | 'flash' | 'moe'): Promise<Float32Array[]>;
+/**
+ * Get extended worker pool stats
+ */
+export declare function getExtendedWorkerStats(): Promise<{
+    initialized: boolean;
+    operations: string[];
+}>;
+export type { AgentRoutingResult, Trajectory, LearningOutcome };
+//# sourceMappingURL=intelligence-bridge.d.ts.map

package/dist/mcp/fastmcp/tools/hooks/intelligence-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intelligence-bridge.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/fastmcp/tools/hooks/intelligence-bridge.ts"],"names":[],"mappings":"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"}