agentic-qe 2.7.3 → 2.8.0

package/dist/edge/p2p/sharing/PatternBroadcaster.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Pattern Broadcaster for Gossip-Based Distribution
+ *
+ * Broadcasts pattern announcements and updates across the P2P network
+ * using a gossip protocol for efficient distribution. Includes rate limiting,
+ * subscription filtering, and deduplication.
+ *
+ * @module edge/p2p/sharing/PatternBroadcaster
+ * @version 1.0.0
+ */
+import type { AgentChannel } from '../protocol';
+import type { SharedPattern, PatternBroadcast, PeerCapabilities, PatternQuery, SharingRateLimitConfig, SharingEventHandler } from './types';
+import { BroadcastType, PatternCategory } from './types';
+import { PatternIndex } from './PatternIndex';
+/**
+ * Broadcaster configuration
+ */
+export interface PatternBroadcasterConfig {
+    /** Local agent ID */
+    localAgentId: string;
+    /** Pattern index */
+    index: PatternIndex;
+    /** Communication channel */
+    channel?: AgentChannel;
+    /** Rate limiting configuration */
+    rateLimit?: Partial<SharingRateLimitConfig>;
+    /** Time-to-live for broadcasts (hops) */
+    defaultTtl?: number;
+    /** Maximum seen broadcasts to track (for deduplication) */
+    maxSeenBroadcasts?: number;
+    /** Enable gossip protocol */
+    enableGossip?: boolean;
+    /** Gossip fanout (number of peers to forward to) */
+    gossipFanout?: number;
+}
+/**
+ * Subscription filter for incoming broadcasts
+ */
+export interface BroadcastSubscription {
+    /** Subscription ID */
+    id: string;
+    /** Filter by broadcast types */
+    types?: BroadcastType[];
+    /** Filter by categories */
+    categories?: PatternCategory[];
+    /** Filter by domains */
+    domains?: string[];
+    /** Filter by tags */
+    tags?: string[];
+    /** Filter by sender */
+    senders?: string[];
+    /** Exclude senders */
+    excludeSenders?: string[];
+    /** Handler callback */
+    handler: BroadcastHandler;
+}
+/**
+ * Broadcast handler function
+ */
+export type BroadcastHandler = (broadcast: PatternBroadcast) => void | Promise<void>;
+/**
+ * Broadcasts pattern updates across the P2P network
+ *
+ * @example
+ * ```typescript
+ * const broadcaster = new PatternBroadcaster({
+ *   localAgentId: 'my-agent',
+ *   index: patternIndex,
+ *   channel: agentChannel,
+ * });
+ *
+ * // Announce new pattern
+ * await broadcaster.announceNewPattern(pattern);
+ *
+ * // Subscribe to updates
+ * broadcaster.subscribe({
+ *   id: 'my-sub',
+ *   types: [BroadcastType.NEW_PATTERN],
+ *   categories: [PatternCategory.TEST],
+ *   handler: (broadcast) => {
+ *     console.log('New pattern:', broadcast.payload);
+ *   },
+ * });
+ *
+ * // Discover peers
+ * await broadcaster.discoverPeers();
+ * ```
+ */
+export declare class PatternBroadcaster {
+    private localAgentId;
+    private index;
+    private channel?;
+    private rateLimit;
+    private defaultTtl;
+    private maxSeenBroadcasts;
+    private enableGossip;
+    private gossipFanout;
+    private subscriptions;
+    private seenBroadcasts;
+    private rateLimitState;
+    private knownPeers;
+    private eventHandlers;
+    private capabilities;
+    constructor(config: PatternBroadcasterConfig);
+    /**
+     * Announce a new pattern to the network
+     */
+    announceNewPattern(pattern: SharedPattern): Promise<void>;
+    /**
+     * Announce a pattern update
+     */
+    announcePatternUpdate(pattern: SharedPattern, changes: string[]): Promise<void>;
+    /**
+     * Announce a pattern deletion
+     */
+    announcePatternDeletion(patternId: string, reason?: string): Promise<void>;
+    /**
+     * Request patterns from the network
+     */
+    requestPatterns(query?: PatternQuery): Promise<void>;
+    /**
+     * Discover peers on the network
+     */
+    discoverPeers(): Promise<void>;
+    /**
+     * Send a broadcast message
+     */
+    private broadcast;
+    /**
+     * Subscribe to broadcast events
+     */
+    subscribe(subscription: BroadcastSubscription): string;
+    /**
+     * Unsubscribe from broadcast events
+     */
+    unsubscribe(subscriptionId: string): boolean;
+    /**
+     * Get all subscriptions
+     */
+    getSubscriptions(): BroadcastSubscription[];
+    /**
+     * Clear all subscriptions
+     */
+    clearSubscriptions(): void;
+    /**
+     * Handle incoming broadcast
+     */
+    handleBroadcast(broadcast: PatternBroadcast): Promise<void>;
+    /**
+     * Process broadcast by type
+     */
+    private processBroadcast;
+    /**
+     * Handle new pattern announcement
+     */
+    private handleNewPatternAnnouncement;
+    /**
+     * Handle pattern update announcement
+     */
+    private handlePatternUpdateAnnouncement;
+    /**
+     * Handle pattern deletion announcement
+     */
+    private handlePatternDeletionAnnouncement;
+    /**
+     * Handle pattern request
+     */
+    private handlePatternRequest;
+    /**
+     * Handle peer discovery
+     */
+    private handlePeerDiscovery;
+    /**
+     * Forward broadcast to subset of peers (gossip)
+     */
+    private gossipForward;
+    /**
+     * Select peers for gossip forwarding
+     */
+    private selectGossipPeers;
+    /**
+     * Setup channel handlers
+     */
+    private setupChannelHandlers;
+    /**
+     * Set communication channel
+     */
+    setChannel(channel: AgentChannel): void;
+    /**
+     * Notify matching subscriptions
+     */
+    private notifySubscriptions;
+    /**
+     * Check if broadcast matches subscription filters
+     */
+    private matchesSubscription;
+    /**
+     * Check if rate limit allows action
+     */
+    private checkRateLimit;
+    /**
+     * Check pattern reception rate limit
+     */
+    private checkPatternRateLimit;
+    /**
+     * Record a broadcast for rate limiting
+     */
+    private recordBroadcast;
+    /**
+     * Record pattern received for rate limiting
+     */
+    private recordPatternReceived;
+    /**
+     * Reset hourly pattern count (should be called periodically)
+     */
+    resetPatternCount(): void;
+    /**
+     * Check if broadcast has been seen
+     */
+    private hasSeen;
+    /**
+     * Mark broadcast as seen
+     */
+    private markSeen;
+    /**
+     * Create pattern summary from full pattern
+     */
+    private createPatternSummary;
+    /**
+     * Generate unique broadcast ID
+     */
+    private generateBroadcastId;
+    /**
+     * Get known peers
+     */
+    getKnownPeers(): Map<string, PeerCapabilities>;
+    /**
+     * Get peer capabilities
+     */
+    getPeerCapabilities(peerId: string): PeerCapabilities | undefined;
+    /**
+     * Remove peer
+     */
+    removePeer(peerId: string): boolean;
+    /**
+     * Get local capabilities
+     */
+    getCapabilities(): PeerCapabilities;
+    /**
+     * Update local capabilities
+     */
+    updateCapabilities(updates: Partial<PeerCapabilities>): void;
+    /**
+     * Get broadcaster statistics
+     */
+    getStats(): {
+        subscriptions: number;
+        knownPeers: number;
+        seenBroadcasts: number;
+        broadcastsThisMinute: number;
+        patternsReceivedThisHour: number;
+    };
+    /**
+     * Subscribe to events
+     */
+    on(handler: SharingEventHandler): void;
+    /**
+     * Unsubscribe from events
+     */
+    off(handler: SharingEventHandler): void;
+    /**
+     * Emit an event
+     */
+    private emit;
+    /**
+     * Destroy the broadcaster
+     */
+    destroy(): void;
+}
+/**
+ * Create a new pattern broadcaster
+ */
+export declare function createPatternBroadcaster(config: PatternBroadcasterConfig): PatternBroadcaster;
+//# sourceMappingURL=PatternBroadcaster.d.ts.map

package/dist/edge/p2p/sharing/PatternBroadcaster.d.ts.map

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