agentic-qe 2.5.6 → 2.5.8

package/dist/learning/FederatedManager.d.ts

@@ -0,0 +1,232 @@
+/**
+ * FederatedManager - Team-wide pattern sharing with privacy-preserving federated learning
+ *
+ * Phase 0 M0.5: AQE LLM Independence - Federated Learning Foundation
+ *
+ * Features:
+ * - Ephemeral agents that process patterns locally
+ * - Gradient-only sharing (no raw data leakage)
+ * - Secure aggregation protocol
+ * - Differential privacy (optional)
+ * - 30% faster learning convergence through team-wide sharing
+ */
+import { EventEmitter } from 'events';
+/**
+ * Learned pattern from an agent
+ */
+export interface LearnedPattern {
+    id: string;
+    embedding: number[];
+    quality: number;
+    category: string;
+    sourceAgent: string;
+    timestamp: number;
+}
+/**
+ * Ephemeral agent state that can be exported/imported
+ */
+export interface AgentState {
+    agentId: string;
+    version: number;
+    weights: number[];
+    gradients: number[];
+    patternCount: number;
+    lastUpdate: number;
+}
+/**
+ * Aggregated knowledge from coordinator
+ */
+export interface AggregatedKnowledge {
+    version: number;
+    globalWeights: number[];
+    patternCategories: string[];
+    contributorCount: number;
+    timestamp: number;
+}
+/**
+ * Federated learning configuration
+ */
+export interface FederatedConfig {
+    /** Coordinator ID for this fleet */
+    coordinatorId: string;
+    /** Minimum number of agents for aggregation */
+    minAgentsForAggregation: number;
+    /** Aggregation strategy */
+    aggregationStrategy: 'fedavg' | 'weighted' | 'secure';
+    /** Enable differential privacy */
+    differentialPrivacy: boolean;
+    /** Privacy budget (epsilon) for differential privacy */
+    privacyEpsilon?: number;
+    /** Learning rate for weight updates */
+    learningRate: number;
+    /** Model dimension */
+    dimension: number;
+}
+/**
+ * Federated learning metrics
+ */
+export interface FederatedMetrics {
+    totalAggregations: number;
+    totalPatternsShared: number;
+    activeAgents: number;
+    convergenceRate: number;
+    privacyBudgetUsed: number;
+    lastAggregationTime: number;
+}
+/**
+ * Ephemeral Agent - Local pattern processor with exportable state
+ */
+export declare class EphemeralAgent {
+    private id;
+    private weights;
+    private gradients;
+    private patternCount;
+    private version;
+    private dimension;
+    private learningRate;
+    constructor(id: string, dimension?: number, learningRate?: number);
+    /**
+     * Get agent ID
+     */
+    getId(): string;
+    /**
+     * Process a pattern locally and update gradients
+     */
+    processPattern(embedding: number[], quality: number): void;
+    /**
+     * Apply accumulated gradients to weights
+     */
+    applyGradients(): void;
+    /**
+     * Export agent state for federated aggregation
+     * Only exports gradients (privacy-preserving)
+     */
+    exportState(): AgentState;
+    /**
+     * Import aggregated weights from coordinator
+     */
+    importState(knowledge: AggregatedKnowledge): void;
+    /**
+     * Get current weights for inference
+     */
+    getWeights(): number[];
+}
+/**
+ * Federated Coordinator - Aggregates learning across agents
+ */
+export declare class FederatedCoordinator extends EventEmitter {
+    private id;
+    private config;
+    private globalWeights;
+    private pendingUpdates;
+    private version;
+    private metrics;
+    private patternCategories;
+    constructor(id: string, config?: Partial<FederatedConfig>);
+    /**
+     * Get coordinator ID
+     */
+    getId(): string;
+    /**
+     * Add pattern category
+     */
+    addCategory(category: string): void;
+    /**
+     * Submit agent state for aggregation
+     */
+    submitUpdate(state: AgentState): void;
+    /**
+     * Aggregate pending updates into global model
+     */
+    aggregate(): AggregatedKnowledge;
+    /**
+     * Standard Federated Averaging (FedAvg)
+     */
+    private federatedAveraging;
+    /**
+     * Weighted averaging based on pattern count
+     */
+    private weightedAveraging;
+    /**
+     * Secure aggregation with masking
+     */
+    private secureAggregation;
+    /**
+     * Apply differential privacy noise
+     */
+    private applyDifferentialPrivacy;
+    /**
+     * Update convergence rate metric
+     */
+    private updateConvergenceRate;
+    /**
+     * Export current aggregated knowledge
+     */
+    exportKnowledge(): AggregatedKnowledge;
+    /**
+     * Get federated learning metrics
+     */
+    getMetrics(): FederatedMetrics;
+    /**
+     * Reset coordinator state
+     */
+    reset(): void;
+}
+/**
+ * FederatedManager - Orchestrates federated learning across AQE fleet
+ */
+export declare class FederatedManager extends EventEmitter {
+    private coordinator;
+    private agents;
+    private config;
+    private initialized;
+    constructor(config?: Partial<FederatedConfig>);
+    /**
+     * Initialize the federated learning manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Register an AQE agent for federated learning
+     */
+    registerAgent(agentId: string): EphemeralAgent;
+    /**
+     * Unregister an agent
+     */
+    unregisterAgent(agentId: string): boolean;
+    /**
+     * Share a learned pattern from an agent to the coordinator
+     */
+    sharePattern(agentId: string, pattern: LearnedPattern): Promise<void>;
+    /**
+     * Trigger gradient export and aggregation for an agent
+     */
+    submitAgentUpdate(agentId: string): Promise<void>;
+    /**
+     * Sync an agent with team-wide knowledge
+     */
+    syncFromTeam(agentId: string): Promise<void>;
+    /**
+     * Force aggregation across all registered agents
+     */
+    forceAggregation(): Promise<AggregatedKnowledge>;
+    /**
+     * Get federated learning metrics
+     */
+    getMetrics(): FederatedMetrics & {
+        registeredAgents: number;
+    };
+    /**
+     * Get all registered agent IDs
+     */
+    getAgentIds(): string[];
+    /**
+     * Get current aggregated knowledge
+     */
+    getKnowledge(): AggregatedKnowledge;
+    /**
+     * Shutdown the federated manager
+     */
+    shutdown(): Promise<void>;
+}
+export declare function createFederatedManager(config?: Partial<FederatedConfig>): FederatedManager;
+//# sourceMappingURL=FederatedManager.d.ts.map

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

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