@weavelogic/knowledge-graph-agent 0.6.0 → 0.7.1

package/dist/integrations/agentic-flow/adapters/reasoning-bank-adapter.d.ts

@@ -0,0 +1,209 @@
+/**
+ * ReasoningBank Adapter
+ *
+ * Provides integration with agentic-flow's ReasoningBank for trajectory
+ * tracking, verdict judgment, and experience learning.
+ *
+ * The ReasoningBank stores task execution trajectories and uses them to
+ * inform future decisions through verdict judgment and memory distillation.
+ *
+ * Implements the MemoryStore interface from the Learning Loop system to
+ * provide persistent semantic memory capabilities.
+ *
+ * @module integrations/agentic-flow/adapters/reasoning-bank-adapter
+ */
+import { BaseAdapter } from './base-adapter.js';
+import type { ExtractedMemory, MemoryType, MemoryStore } from '../../../learning/types.js';
+/**
+ * A single step in a task execution trajectory
+ */
+export interface TrajectoryStep {
+    /** Action taken */
+    action: string;
+    /** Observation/result of the action */
+    observation: string;
+    /** Timestamp of the step */
+    timestamp: Date;
+    /** Duration in milliseconds */
+    duration?: number;
+    /** Confidence in this step (0-1) */
+    confidence?: number;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A complete trajectory representing a task execution
+ */
+export interface Trajectory {
+    /** Unique trajectory identifier */
+    id: string;
+    /** Task identifier */
+    taskId: string;
+    /** Sequence of steps in the trajectory */
+    steps: TrajectoryStep[];
+    /** Final outcome */
+    outcome: 'success' | 'failure' | 'partial';
+    /** When the trajectory was stored */
+    storedAt: Date;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+}
+/**
+ * Input for storing a trajectory
+ */
+export interface TrajectoryInput {
+    /** Task identifier */
+    taskId: string;
+    /** Sequence of steps */
+    steps: TrajectoryStep[];
+    /** Final outcome */
+    outcome: 'success' | 'failure' | 'partial';
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * A verdict judgment for a task approach
+ */
+export interface Verdict {
+    /** Recommendation for the task */
+    recommendation: 'proceed' | 'caution' | 'avoid';
+    /** Confidence in the verdict (0-1) */
+    confidence: number;
+    /** Reasoning behind the verdict */
+    reasoning: string;
+    /** Warnings based on historical failures */
+    warnings: string[];
+    /** Suggested approach based on successful trajectories */
+    suggestedApproach?: string;
+    /** Similar trajectories that informed this verdict */
+    similarTrajectories: Array<{
+        id: string;
+        outcome: 'success' | 'failure' | 'partial';
+        similarity: number;
+    }>;
+}
+/**
+ * Task description for verdict judgment
+ */
+export interface TaskDescription {
+    /** Task description text */
+    description: string;
+    /** Task type/category */
+    type?: string;
+    /** Additional context */
+    context?: Record<string, unknown>;
+}
+/**
+ * Configuration for the ReasoningBank adapter
+ */
+export interface ReasoningBankConfig {
+    /** Path for persisting reasoning bank data */
+    persistPath: string;
+    /** Enable the adapter */
+    enabled: boolean;
+    /** Memory namespace for storage */
+    namespace: string;
+    /** Maximum trajectories to store */
+    maxTrajectories: number;
+    /** Similarity threshold for verdict judgment */
+    similarityThreshold: number;
+    /** TTL for trajectories in milliseconds (0 = no expiry) */
+    trajectoryTtl: number;
+    /** Enable memory distillation */
+    enableDistillation: boolean;
+    /** Distillation interval in hours */
+    distillationInterval: number;
+    /** Distillation frequency (number of trajectories before distillation) */
+    distillationFrequency: number;
+    /** Threshold for verdict judgments (0-1) */
+    verdictThreshold: number;
+}
+/**
+ * Result of memory distillation operation
+ */
+export interface DistillationResult {
+    /** Number of memories removed */
+    memoriesRemoved: number;
+    /** Number of memories consolidated */
+    memoriesConsolidated: number;
+    /** Number of patterns extracted */
+    patternsExtracted: number;
+    /** Storage space saved in bytes */
+    storageSaved: number;
+}
+/**
+ * Adapter for integrating with agentic-flow's ReasoningBank
+ *
+ * Provides trajectory storage, verdict judgment, and experience learning
+ * capabilities for knowledge graph agents.
+ *
+ * Extends BaseAdapter for dynamic module loading and implements MemoryStore
+ * for integration with the Learning Loop system.
+ */
+export declare class ReasoningBankAdapter extends BaseAdapter<unknown> implements MemoryStore {
+    private readonly emitter;
+    private config;
+    private trajectories;
+    private trajectoryIndex;
+    private memories;
+    private distillationCounter;
+    constructor(config?: Partial<ReasoningBankConfig>);
+    getFeatureName(): string;
+    isAvailable(): boolean;
+    initialize(): Promise<void>;
+    getConfig(): ReasoningBankConfig;
+    store(memory: ExtractedMemory): Promise<void>;
+    retrieve(id: string): Promise<ExtractedMemory | null>;
+    findByType(type: MemoryType, limit?: number): Promise<ExtractedMemory[]>;
+    findByTags(tags: string[], limit?: number): Promise<ExtractedMemory[]>;
+    findSimilar(embedding: number[], limit?: number): Promise<ExtractedMemory[]>;
+    getStatsForDay(date: Date): Promise<{
+        extracted: number;
+        applied: number;
+        byType: Record<MemoryType, number>;
+    }>;
+    delete(id: string): Promise<boolean>;
+    /**
+     * Search memories by query string
+     * @param query - Search query
+     * @param limit - Maximum results to return
+     */
+    search(query: string, limit?: number): Promise<ExtractedMemory[]>;
+    private cosineSimilarity;
+    storeTrajectory(input: TrajectoryInput): Promise<string>;
+    getTrajectory(id: string): Promise<Trajectory | null>;
+    findSimilarTrajectories(description: string, limit?: number): Promise<Array<Trajectory & {
+        similarity: number;
+    }>>;
+    judgeVerdict(task: TaskDescription): Promise<Verdict>;
+    distillMemories(): Promise<DistillationResult>;
+    extractPatterns(memories: ExtractedMemory[]): Promise<Array<{
+        pattern: string;
+        frequency: number;
+        confidence: number;
+    }>>;
+    getStats(): Promise<{
+        memories: number;
+        trajectories: number;
+        patterns: number;
+    }>;
+    getStatistics(): {
+        total: number;
+        byOutcome: Record<string, number>;
+        byType: Record<string, number>;
+    };
+    clear(): Promise<void>;
+    on(event: string, listener: (...args: unknown[]) => void): this;
+    off(event: string, listener: (...args: unknown[]) => void): this;
+    private autoInitialize;
+    private createId;
+    private extractKeywords;
+    private evictOldestTrajectories;
+    private createDefaultVerdict;
+    private extractWarningsFromFailures;
+    private generateApproachFromSuccesses;
+    private calculateVerdictConfidence;
+    private generateReasoning;
+}
+export declare function createReasoningBankAdapter(config?: Partial<ReasoningBankConfig>): Promise<ReasoningBankAdapter>;
+//# sourceMappingURL=reasoning-bank-adapter.d.ts.map

package/dist/integrations/agentic-flow/adapters/reasoning-bank-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-bank-adapter.d.ts","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/adapters/reasoning-bank-adapter.ts"],"names":[],"mappings":"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"}

package/dist/integrations/agentic-flow/benchmark/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Agentic-Flow Benchmark Utilities
+ *
+ * Export benchmarking tools for vector store performance analysis.
+ *
+ * @module integrations/agentic-flow/benchmark
+ */
+export { VectorStoreBenchmark, createVectorStoreBenchmark, quickBenchmark, formatBenchmarkReport, formatComparisonReport, type BenchmarkResult, type BenchmarkSuiteResult, type BenchmarkConfig, type MemoryStats, type IBenchmarkableStore, type OperationComparison, type ComparisonResult, } from './vector-benchmark.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/agentic-flow/benchmark/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/integrations/agentic-flow/benchmark/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,cAAc,EACd,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/integrations/agentic-flow/benchmark/vector-benchmark.d.ts

@@ -0,0 +1,253 @@
+/**
+ * Vector Store Benchmark
+ *
+ * Provides comprehensive benchmarking utilities for comparing
+ * vector store implementations and measuring performance.
+ *
+ * Features:
+ * - Upsert, search, and hybrid search benchmarks
+ * - Statistical analysis with percentiles
+ * - Comparison reports between implementations
+ * - Memory usage tracking
+ *
+ * @module integrations/agentic-flow/benchmark/vector-benchmark
+ */
+/**
+ * Benchmark result for a single operation type
+ */
+export interface BenchmarkResult {
+    /** Operation name */
+    name: string;
+    /** Number of operations performed */
+    operations: number;
+    /** Total time in milliseconds */
+    totalTimeMs: number;
+    /** Average time per operation in milliseconds */
+    avgTimeMs: number;
+    /** Operations per second */
+    opsPerSecond: number;
+    /** 50th percentile (median) latency in milliseconds */
+    p50Ms: number;
+    /** 95th percentile latency in milliseconds */
+    p95Ms: number;
+    /** 99th percentile latency in milliseconds */
+    p99Ms: number;
+    /** Minimum latency in milliseconds */
+    minMs: number;
+    /** Maximum latency in milliseconds */
+    maxMs: number;
+    /** Standard deviation in milliseconds */
+    stdDevMs: number;
+    /** Error count */
+    errors: number;
+}
+/**
+ * Full benchmark suite results
+ */
+export interface BenchmarkSuiteResult {
+    /** Name of the store being benchmarked */
+    storeName: string;
+    /** Timestamp of benchmark run */
+    timestamp: Date;
+    /** Individual benchmark results */
+    results: BenchmarkResult[];
+    /** Total benchmark duration in milliseconds */
+    totalDuration: number;
+    /** Memory usage statistics */
+    memory?: MemoryStats;
+    /** Configuration used for benchmark */
+    config: BenchmarkConfig;
+}
+/**
+ * Memory usage statistics
+ */
+export interface MemoryStats {
+    /** Initial memory usage in bytes */
+    initial: number;
+    /** Peak memory usage in bytes */
+    peak: number;
+    /** Final memory usage in bytes */
+    final: number;
+    /** Memory delta (final - initial) in bytes */
+    delta: number;
+}
+/**
+ * Benchmark configuration
+ */
+export interface BenchmarkConfig {
+    /** Number of operations per benchmark */
+    operations: number;
+    /** Vector dimensions */
+    dimensions: number;
+    /** Number of warmup operations */
+    warmupOperations: number;
+    /** Enable memory tracking */
+    trackMemory: boolean;
+    /** Number of results for search benchmarks */
+    searchK: number;
+    /** Search threshold */
+    searchThreshold: number;
+    /** Batch size for batch operations */
+    batchSize: number;
+}
+/**
+ * Interface for vector store to benchmark
+ */
+export interface IBenchmarkableStore {
+    upsert(nodeId: string, content: string, embedding: Float32Array, metadata?: Record<string, unknown>): Promise<void>;
+    upsertBatch?(entries: Array<{
+        nodeId: string;
+        content: string;
+        embedding: Float32Array;
+        metadata?: Record<string, unknown>;
+    }>): Promise<void>;
+    search(queryEmbedding: Float32Array, limit?: number, threshold?: number): Promise<Array<{
+        nodeId: string;
+        content: string;
+        similarity: number;
+        metadata: Record<string, unknown>;
+    }>>;
+    hybridSearch?(query: string, queryEmbedding: Float32Array, options?: {
+        limit?: number;
+    }): Promise<Array<{
+        nodeId: string;
+        content: string;
+        similarity: number;
+        metadata: Record<string, unknown>;
+    }>>;
+    delete?(nodeId: string): Promise<void>;
+    getStats?(): Promise<unknown>;
+}
+/**
+ * Vector Store Benchmark class
+ *
+ * Provides comprehensive benchmarking for vector store implementations.
+ *
+ * @example
+ * ```typescript
+ * const benchmark = new VectorStoreBenchmark({
+ *   operations: 1000,
+ *   dimensions: 384,
+ * });
+ *
+ * const results = await benchmark.runBenchmark(store);
+ * console.log('Upsert ops/sec:', results.results[0].opsPerSecond);
+ *
+ * // Compare two stores
+ * const comparison = await benchmark.compare(storeA, storeB);
+ * console.log('Speedup:', comparison.speedup);
+ * ```
+ */
+export declare class VectorStoreBenchmark {
+    private config;
+    constructor(config?: Partial<BenchmarkConfig>);
+    /**
+     * Run full benchmark suite on a store
+     *
+     * @param store - Vector store to benchmark
+     * @param storeName - Name for the store in results
+     * @returns Benchmark suite results
+     */
+    runBenchmark(store: IBenchmarkableStore, storeName?: string): Promise<BenchmarkSuiteResult>;
+    /**
+     * Compare two store implementations
+     *
+     * @param storeA - First store (baseline)
+     * @param storeB - Second store (comparison)
+     * @param nameA - Name for first store
+     * @param nameB - Name for second store
+     * @returns Comparison results
+     */
+    compare(storeA: IBenchmarkableStore, storeB: IBenchmarkableStore, nameA?: string, nameB?: string): Promise<ComparisonResult>;
+    /**
+     * Warmup phase to eliminate cold start effects
+     */
+    private warmup;
+    /**
+     * Benchmark upsert operations
+     */
+    private benchmarkUpsert;
+    /**
+     * Benchmark batch upsert operations
+     */
+    private benchmarkBatchUpsert;
+    /**
+     * Benchmark search operations
+     */
+    private benchmarkSearch;
+    /**
+     * Benchmark hybrid search operations
+     */
+    private benchmarkHybridSearch;
+    /**
+     * Benchmark delete operations
+     */
+    private benchmarkDelete;
+    /**
+     * Calculate statistical metrics from timing data
+     */
+    private calculateStats;
+    /**
+     * Generate random embedding vector
+     */
+    private generateRandomEmbedding;
+    /**
+     * Update peak memory tracking
+     */
+    private updatePeakMemory;
+    /**
+     * Generate recommendation based on comparison results
+     */
+    private generateRecommendation;
+    /**
+     * Get current configuration
+     */
+    getConfig(): BenchmarkConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(config: Partial<BenchmarkConfig>): void;
+}
+/**
+ * Comparison between two operations
+ */
+export interface OperationComparison {
+    operation: string;
+    baselineOpsPerSec: number;
+    comparisonOpsPerSec: number;
+    speedup: number;
+    baselineP50: number;
+    comparisonP50: number;
+    latencyReduction: number;
+}
+/**
+ * Full comparison result
+ */
+export interface ComparisonResult {
+    baseline: BenchmarkSuiteResult;
+    comparison: BenchmarkSuiteResult;
+    comparisons: OperationComparison[];
+    avgSpeedup: number;
+    recommendation: string;
+}
+/**
+ * Create a benchmark instance with default configuration
+ */
+export declare function createVectorStoreBenchmark(config?: Partial<BenchmarkConfig>): VectorStoreBenchmark;
+/**
+ * Quick benchmark for a single store
+ *
+ * @param store - Store to benchmark
+ * @param operations - Number of operations (default: 1000)
+ * @returns Benchmark results
+ */
+export declare function quickBenchmark(store: IBenchmarkableStore, operations?: number): Promise<BenchmarkSuiteResult>;
+/**
+ * Format benchmark results as a string report
+ */
+export declare function formatBenchmarkReport(result: BenchmarkSuiteResult): string;
+/**
+ * Format comparison results as a string report
+ */
+export declare function formatComparisonReport(result: ComparisonResult): string;
+//# sourceMappingURL=vector-benchmark.d.ts.map

package/dist/integrations/agentic-flow/benchmark/vector-benchmark.d.ts.map

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

package/dist/integrations/agentic-flow/config.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Agentic-Flow Configuration
+ *
+ * Configuration management for optional agentic-flow integration.
+ * Provides feature flags and environment-based configuration loading.
+ *
+ * @module integrations/agentic-flow/config
+ */
+/**
+ * Configuration for agentic-flow integration features
+ */
+export interface AgenticFlowConfig {
+    /**
+     * Whether agentic-flow integration is enabled
+     */
+    enabled: boolean;
+    /**
+     * Use AgentDB for vector storage (150x faster GNN-enhanced search)
+     */
+    useAgentDB: boolean;
+    /**
+     * Use ReasoningBank for adaptive learning and memory distillation
+     */
+    useReasoningBank: boolean;
+    /**
+     * Use AgentBooster for dynamic capability enhancement
+     */
+    useAgentBooster: boolean;
+    /**
+     * Use ModelRouter for intelligent LLM routing
+     */
+    useModelRouter: boolean;
+    /**
+     * Use QUIC transport for high-performance data synchronization
+     */
+    useQUICTransport: boolean;
+    /**
+     * Use FederationHub for multi-agent coordination
+     */
+    useFederationHub: boolean;
+}
+/**
+ * Default configuration with all features disabled
+ */
+export declare const defaultConfig: AgenticFlowConfig;
+/**
+ * Load configuration from environment variables
+ *
+ * Environment variables:
+ * - KG_AGENTIC_FLOW: Enable agentic-flow integration
+ * - KG_USE_AGENTDB: Enable AgentDB vector store
+ * - KG_USE_REASONING_BANK: Enable ReasoningBank
+ * - KG_USE_AGENT_BOOSTER: Enable AgentBooster
+ * - KG_USE_MODEL_ROUTER: Enable ModelRouter
+ * - KG_USE_QUIC_TRANSPORT: Enable QUIC transport
+ * - KG_USE_FEDERATION_HUB: Enable FederationHub
+ *
+ * @returns Configuration loaded from environment
+ */
+export declare function loadConfigFromEnv(): AgenticFlowConfig;
+/**
+ * Get the current agentic-flow configuration
+ *
+ * @returns Current configuration
+ */
+export declare function getAgenticFlowConfig(): AgenticFlowConfig;
+/**
+ * Set or update the agentic-flow configuration
+ *
+ * @param config - Partial configuration to merge
+ */
+export declare function setAgenticFlowConfig(config: Partial<AgenticFlowConfig>): void;
+/**
+ * Reset configuration to defaults
+ */
+export declare function resetAgenticFlowConfig(): void;
+/**
+ * Initialize configuration from environment
+ *
+ * Call this at application startup to load environment-based configuration.
+ */
+export declare function initializeConfig(): void;
+/**
+ * Check if agentic-flow package is available
+ *
+ * Uses require.resolve to check for package availability without importing.
+ *
+ * @returns True if agentic-flow is installed
+ */
+export declare function isAgenticFlowAvailable(): boolean;
+/**
+ * Check if agentic-flow is both available and enabled
+ *
+ * @returns True if agentic-flow can be used
+ */
+export declare function isAgenticFlowEnabled(): boolean;
+/**
+ * Validate configuration consistency
+ *
+ * Checks that enabled features have their dependencies met.
+ *
+ * @param config - Configuration to validate
+ * @returns Validation result with any warnings
+ */
+export declare function validateConfig(config: AgenticFlowConfig): {
+    valid: boolean;
+    warnings: string[];
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/integrations/agentic-flow/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/integrations/agentic-flow/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IAEpB;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,iBAQ3B,CAAC;AAOF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,IAAI,iBAAiB,CAUrD;AAOD;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAE7E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAGvC;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAShD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,iBAAiB,GAAG;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAgCA"}