agentic-qe 2.2.0 → 2.2.1

package/dist/learning/GossipPatternSharingProtocol.d.ts

@@ -0,0 +1,228 @@
+/**
+ * GossipPatternSharingProtocol - Pattern-Specific Gossip Protocol
+ *
+ * Extends ExperienceSharingProtocol to specialize in sharing learned patterns
+ * between agents for collaborative learning and knowledge distribution.
+ *
+ * Features:
+ * - Pattern compression/decompression for efficient network transfer
+ * - Priority-based pattern selection (high-value patterns first)
+ * - Anti-entropy reconciliation for pattern consistency
+ * - Pattern-specific metrics (patterns shared, received, conflicts)
+ * - Integration with AgentDB for persistent pattern storage
+ * - Quality-based pattern filtering
+ *
+ * @module learning/GossipPatternSharingProtocol
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+import { ExperienceSharingConfig } from './ExperienceSharingProtocol';
+import { LearnedPattern } from './types';
+import { VectorClock } from '../memory/DistributedPatternLibrary';
+/**
+ * Shared pattern with metadata for cross-agent transfer
+ */
+export interface SharedPattern {
+    id: string;
+    pattern: LearnedPattern;
+    sourceAgentId: string;
+    vectorClock: VectorClock;
+    priority: number;
+    shareCount: number;
+    compressedContent?: string;
+    isCompressed: boolean;
+    size: number;
+    checksum: string;
+    createdAt: number;
+    expiresAt: number;
+}
+/**
+ * Pattern sharing configuration
+ */
+export interface PatternSharingConfig extends ExperienceSharingConfig {
+    /** Enable pattern compression (default: true) */
+    enablePatternCompression?: boolean;
+    /** Compression threshold in bytes (default: 1KB) */
+    compressionThreshold?: number;
+    /** Minimum pattern quality to share (0-1) */
+    minPatternQuality?: number;
+    /** Minimum pattern success rate to share (0-1) */
+    minSuccessRate?: number;
+    /** Anti-entropy reconciliation interval in ms */
+    antiEntropyInterval?: number;
+    /** Enable anti-entropy reconciliation */
+    enableAntiEntropy?: boolean;
+}
+/**
+ * Pattern sharing statistics
+ */
+export interface PatternSharingStats {
+    patternsShared: number;
+    patternsReceived: number;
+    patternConflictsResolved: number;
+    compressionRatio: number;
+    bytesCompressed: number;
+    bytesDecompressed: number;
+    antiEntropyRounds: number;
+    patternsSynchronized: number;
+    averagePatternQuality: number;
+    highValuePatternsShared: number;
+}
+/**
+ * Anti-entropy reconciliation result
+ */
+export interface AntiEntropyResult {
+    peersSynced: number;
+    patternsSent: number;
+    patternsReceived: number;
+    conflictsResolved: number;
+    duration: number;
+}
+/**
+ * Pattern sharing event types
+ */
+export type PatternSharingEvent = {
+    type: 'pattern_shared';
+    patternId: string;
+    targetPeers: string[];
+    compressed: boolean;
+} | {
+    type: 'pattern_received';
+    patternId: string;
+    sourceAgentId: string;
+    quality: number;
+} | {
+    type: 'pattern_conflict_resolved';
+    patternId: string;
+    resolution: 'local' | 'remote' | 'merge';
+} | {
+    type: 'anti_entropy_completed';
+    result: AntiEntropyResult;
+};
+/**
+ * GossipPatternSharingProtocol - Specialized gossip protocol for pattern sharing
+ *
+ * This protocol extends the base experience sharing with pattern-specific
+ * optimizations and features:
+ * - Intelligent pattern compression based on size
+ * - Quality-based priority scoring
+ * - Anti-entropy to ensure all agents eventually have all patterns
+ * - Pattern-specific conflict resolution
+ * - Metrics for pattern sharing effectiveness
+ */
+export declare class GossipPatternSharingProtocol extends EventEmitter {
+    private readonly logger;
+    private readonly config;
+    private patterns;
+    private vectorClock;
+    private stats;
+    private isRunning;
+    private antiEntropyTimer?;
+    private compressionManager;
+    private seenPatterns;
+    private peers;
+    private readonly DEFAULT_PATTERN_COMPRESSION;
+    private readonly DEFAULT_COMPRESSION_THRESHOLD;
+    private readonly DEFAULT_MIN_PATTERN_QUALITY;
+    private readonly DEFAULT_MIN_SUCCESS_RATE;
+    private readonly DEFAULT_ANTI_ENTROPY_INTERVAL;
+    private readonly DEFAULT_ENABLE_ANTI_ENTROPY;
+    constructor(config: PatternSharingConfig);
+    /**
+     * Start the pattern sharing protocol
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the pattern sharing protocol
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a peer for pattern sharing
+     */
+    registerPeer(peerId: string): Promise<void>;
+    /**
+     * Unregister a peer
+     */
+    unregisterPeer(peerId: string): Promise<void>;
+    /**
+     * Share a learned pattern with peers
+     */
+    sharePattern(pattern: LearnedPattern, priority?: number): Promise<string>;
+    /**
+     * Receive a pattern from another agent
+     */
+    receivePattern(sharedPattern: SharedPattern): Promise<boolean>;
+    /**
+     * Get high-value patterns for a specific context
+     */
+    getRelevantPatterns(contexts: string[], limit?: number): Promise<SharedPattern[]>;
+    /**
+     * Perform anti-entropy reconciliation round
+     *
+     * Anti-entropy ensures eventual consistency by periodically
+     * synchronizing all patterns with all peers, even if gossip
+     * messages were lost or peers were temporarily disconnected.
+     */
+    private performAntiEntropyRound;
+    /**
+     * Synchronize patterns with a specific peer
+     */
+    private syncWithPeer;
+    /**
+     * Select high-priority patterns for sharing
+     */
+    private selectHighPriorityPatterns;
+    /**
+     * Calculate pattern priority based on quality, usage, and success rate
+     */
+    private calculatePatternPriority;
+    /**
+     * Resolve conflict between two pattern versions
+     */
+    private resolvePatternConflict;
+    /**
+     * Compare two vector clocks
+     */
+    private compareVectorClocks;
+    /**
+     * Merge remote vector clock into local
+     */
+    private mergeVectorClocks;
+    /**
+     * Calculate checksum for pattern
+     */
+    private calculateChecksum;
+    /**
+     * Update compression ratio statistics
+     */
+    private updateCompressionRatio;
+    /**
+     * Update average pattern quality statistics
+     */
+    private updateAverageQuality;
+    /**
+     * Get pattern sharing statistics
+     */
+    getStats(): PatternSharingStats;
+    /**
+     * Get all stored patterns
+     */
+    getAllPatterns(): SharedPattern[];
+    /**
+     * Get pattern count
+     */
+    getPatternCount(): number;
+    /**
+     * Clear all patterns
+     */
+    clear(): void;
+    /**
+     * Export patterns for persistence
+     */
+    exportPatterns(): SharedPattern[];
+    /**
+     * Import patterns from persistence
+     */
+    importPatterns(patterns: SharedPattern[]): Promise<number>;
+}
+//# sourceMappingURL=GossipPatternSharingProtocol.d.ts.map

package/dist/learning/GossipPatternSharingProtocol.d.ts.map

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