agentic-qe 2.1.1 → 2.2.0

package/dist/learning/ExperienceSharingProtocol.d.ts

@@ -0,0 +1,243 @@
+/**
+ * ExperienceSharingProtocol - Inter-Agent Learning Experience Sharing
+ *
+ * Enables agents to share learning experiences using gossip protocol
+ * for distributed, eventually consistent knowledge transfer.
+ *
+ * Features:
+ * - Gossip-based experience propagation
+ * - Experience compression and deduplication
+ * - Priority-based sharing (high-value experiences first)
+ * - Conflict resolution for overlapping experiences
+ * - Bandwidth-aware transmission
+ *
+ * @module learning/ExperienceSharingProtocol
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+import { TaskExperience, TaskState } from './types';
+import { VectorClock } from '../memory/DistributedPatternLibrary';
+/**
+ * Shared experience with metadata for cross-agent transfer
+ */
+export interface SharedExperience {
+    id: string;
+    experience: TaskExperience;
+    sourceAgentId: string;
+    vectorClock: VectorClock;
+    priority: number;
+    shareCount: number;
+    createdAt: number;
+    expiresAt: number;
+    checksum: string;
+}
+/**
+ * Experience sharing configuration
+ */
+export interface ExperienceSharingConfig {
+    /** This agent's ID */
+    agentId: string;
+    /** Maximum experiences to store */
+    maxExperiences?: number;
+    /** TTL for shared experiences in milliseconds */
+    experienceTTL?: number;
+    /** Gossip interval in milliseconds */
+    gossipInterval?: number;
+    /** Number of peers to gossip with each round */
+    fanout?: number;
+    /** Minimum priority to share (0-1) */
+    minSharePriority?: number;
+    /** Enable experience compression */
+    enableCompression?: boolean;
+    /** Maximum bandwidth in bytes per second */
+    maxBandwidth?: number;
+}
+/**
+ * Experience sharing statistics
+ */
+export interface SharingStats {
+    experiencesShared: number;
+    experiencesReceived: number;
+    duplicatesFiltered: number;
+    expiredPurged: number;
+    bytesTransferred: number;
+    activeConnections: number;
+    lastGossipRound: number;
+}
+/**
+ * Peer connection for experience sharing
+ */
+export interface PeerConnection {
+    peerId: string;
+    agentType: string;
+    vectorClock: VectorClock;
+    lastSeen: number;
+    experienceCount: number;
+    isActive: boolean;
+}
+/**
+ * Experience sharing event types
+ */
+export type SharingEvent = {
+    type: 'experience_shared';
+    experienceId: string;
+    targetPeers: string[];
+} | {
+    type: 'experience_received';
+    experienceId: string;
+    sourceAgentId: string;
+} | {
+    type: 'peer_connected';
+    peerId: string;
+} | {
+    type: 'peer_disconnected';
+    peerId: string;
+} | {
+    type: 'conflict_resolved';
+    experienceId: string;
+    resolution: 'local' | 'remote' | 'merge';
+};
+/**
+ * ExperienceSharingProtocol - Gossip-based experience sharing between agents
+ *
+ * This protocol enables agents to learn from each other's experiences
+ * through decentralized, eventually consistent knowledge transfer.
+ *
+ * Key features:
+ * - Gossip protocol for scalable experience propagation
+ * - Vector clock-based conflict resolution
+ * - Priority-based experience selection
+ * - Automatic deduplication and expiration
+ * - Bandwidth throttling for network efficiency
+ */
+export declare class ExperienceSharingProtocol extends EventEmitter {
+    private readonly logger;
+    private readonly config;
+    private experiences;
+    private peers;
+    private vectorClock;
+    private stats;
+    private gossipTimer?;
+    private isRunning;
+    private seenExperiences;
+    private readonly DEFAULT_MAX_EXPERIENCES;
+    private readonly DEFAULT_EXPERIENCE_TTL;
+    private readonly DEFAULT_GOSSIP_INTERVAL;
+    private readonly DEFAULT_FANOUT;
+    private readonly DEFAULT_MIN_SHARE_PRIORITY;
+    private readonly DEFAULT_MAX_BANDWIDTH;
+    constructor(config: ExperienceSharingConfig);
+    /**
+     * Start the experience sharing protocol
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the experience sharing protocol
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a peer for experience sharing
+     */
+    registerPeer(peerId: string, agentType: string): Promise<void>;
+    /**
+     * Unregister a peer
+     */
+    unregisterPeer(peerId: string): Promise<void>;
+    /**
+     * Share an experience from this agent
+     */
+    shareExperience(experience: TaskExperience, priority?: number): Promise<string>;
+    /**
+     * Receive an experience from another agent
+     */
+    receiveExperience(sharedExperience: SharedExperience): Promise<boolean>;
+    /**
+     * Get experiences relevant to a specific state/context
+     */
+    getRelevantExperiences(state: TaskState, limit?: number): Promise<SharedExperience[]>;
+    /**
+     * Get all experiences from a specific agent
+     */
+    getAgentExperiences(agentId: string): Promise<SharedExperience[]>;
+    /**
+     * Get sharing statistics
+     */
+    getStats(): SharingStats;
+    /**
+     * Get connected peers
+     */
+    getPeers(): PeerConnection[];
+    /**
+     * Get experience count
+     */
+    getExperienceCount(): number;
+    /**
+     * Clear all experiences
+     */
+    clear(): void;
+    /**
+     * Export experiences for persistence
+     */
+    exportExperiences(): SharedExperience[];
+    /**
+     * Import experiences from persistence
+     */
+    importExperiences(experiences: SharedExperience[]): Promise<number>;
+    /**
+     * Perform a gossip round
+     */
+    private performGossipRound;
+    /**
+     * Gossip with a specific peer
+     */
+    private gossipWithPeer;
+    /**
+     * Select experiences to share based on priority and share count
+     */
+    private selectExperiencesToShare;
+    /**
+     * Select random peers for gossip
+     */
+    private selectRandomPeers;
+    /**
+     * Calculate experience priority based on reward and novelty
+     */
+    private calculateExperiencePriority;
+    /**
+     * Calculate relevance between two states
+     */
+    private calculateStateRelevance;
+    /**
+     * Resolve conflict between two experiences
+     */
+    private resolveConflict;
+    /**
+     * Compare two vector clocks
+     */
+    private compareVectorClocks;
+    /**
+     * Merge remote vector clock into local
+     */
+    private mergeVectorClocks;
+    /**
+     * Generate unique experience ID
+     */
+    private generateExperienceId;
+    /**
+     * Calculate checksum for experience
+     */
+    private calculateChecksum;
+    /**
+     * Simple hash function for IDs and checksums
+     */
+    private hashString;
+    /**
+     * Enforce maximum experience limit
+     */
+    private enforceExperienceLimit;
+    /**
+     * Get count of active peers
+     */
+    private getActivePeerCount;
+}
+//# sourceMappingURL=ExperienceSharingProtocol.d.ts.map

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

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