agentic-qe 2.2.0 → 2.2.2

package/dist/learning/PrivacyManager.d.ts

@@ -0,0 +1,197 @@
+/**
+ * PrivacyManager - Privacy Controls for Learning Data
+ *
+ * Implements privacy levels and data protection for the learning system:
+ * - PUBLIC: Full sharing, all data visible
+ * - TEAM: Share within team namespace only
+ * - PRIVATE: No sharing, local learning only
+ * - PARANOID: No persistence, in-memory only, auto-wipe
+ *
+ * Features:
+ * - Code snippet sanitization
+ * - Agent ID anonymization for cross-team sharing
+ * - Data retention policies
+ * - Encryption for sensitive patterns
+ * - Integration with ExperienceSharingProtocol
+ *
+ * @module learning/PrivacyManager
+ * @version 1.0.0
+ */
+import { TaskExperience, LearnedPattern } from './types';
+import { SharedExperience } from './ExperienceSharingProtocol';
+/**
+ * Privacy levels for learning data
+ */
+export declare enum PrivacyLevel {
+    /** Full sharing, all data visible */
+    PUBLIC = "PUBLIC",
+    /** Share within team namespace only */
+    TEAM = "TEAM",
+    /** No sharing, local learning only */
+    PRIVATE = "PRIVATE",
+    /** No persistence, in-memory only, auto-wipe */
+    PARANOID = "PARANOID"
+}
+/**
+ * Privacy configuration
+ */
+export interface PrivacyConfig {
+    /** Privacy level */
+    level: PrivacyLevel;
+    /** Team/organization namespace (required for TEAM level) */
+    teamNamespace?: string;
+    /** Encryption key for sensitive data (required for PRIVATE/PARANOID) */
+    encryptionKey?: string;
+    /** Data retention period in milliseconds (0 = forever) */
+    retentionPeriod?: number;
+    /** Whether to sanitize code snippets in experiences */
+    sanitizeCode?: boolean;
+    /** Whether to anonymize agent IDs for cross-team sharing */
+    anonymizeAgentIds?: boolean;
+    /** Maximum experience age in milliseconds before auto-deletion (PARANOID) */
+    maxExperienceAge?: number;
+    /** Patterns to redact from code (regex patterns) */
+    redactionPatterns?: string[];
+}
+/**
+ * Sanitized experience with privacy controls applied
+ */
+export interface SanitizedExperience {
+    original: TaskExperience;
+    sanitized: TaskExperience;
+    redactions: string[];
+    anonymized: boolean;
+    encrypted: boolean;
+}
+/**
+ * Data retention policy result
+ */
+export interface RetentionPolicyResult {
+    shouldRetain: boolean;
+    reason: string;
+    expiresAt?: Date;
+}
+/**
+ * PrivacyManager - Manages privacy controls for learning data
+ */
+export declare class PrivacyManager {
+    private readonly logger;
+    private config;
+    private anonymizationMap;
+    private encryptionAlgorithm;
+    private encryptionKey?;
+    private cleanupTimer?;
+    constructor(config: PrivacyConfig);
+    /**
+     * Validate privacy configuration
+     */
+    private validateConfig;
+    /**
+     * Generate a random encryption key
+     */
+    private generateEncryptionKey;
+    /**
+     * Derive encryption key from password
+     */
+    private deriveKey;
+    /**
+     * Get current privacy level
+     */
+    getPrivacyLevel(): PrivacyLevel;
+    /**
+     * Check if experience sharing is allowed
+     */
+    canShareExperiences(): boolean;
+    /**
+     * Check if persistence is allowed
+     */
+    canPersist(): boolean;
+    /**
+     * Check if an experience can be shared with a specific agent
+     */
+    canShareWith(targetAgentId: string, targetTeamNamespace?: string): boolean;
+    /**
+     * Sanitize an experience based on privacy settings
+     */
+    sanitizeExperience(experience: TaskExperience): SanitizedExperience;
+    /**
+     * Sanitize a shared experience before sharing
+     */
+    sanitizeSharedExperience(sharedExperience: SharedExperience): SharedExperience;
+    /**
+     * Sanitize a learned pattern
+     */
+    sanitizePattern(pattern: LearnedPattern): LearnedPattern;
+    /**
+     * Anonymize an agent ID
+     */
+    anonymizeAgentId(agentId: string): string;
+    /**
+     * De-anonymize an agent ID (if mapping exists)
+     */
+    deAnonymizeAgentId(anonymousId: string): string | undefined;
+    /**
+     * Sanitize a string by applying redaction patterns
+     */
+    private sanitizeString;
+    /**
+     * Sanitize an object recursively
+     */
+    private sanitizeObject;
+    /**
+     * Encrypt action data
+     */
+    private encryptActionData;
+    /**
+     * Decrypt action data
+     */
+    decryptActionData(encryptedAction: any): any;
+    /**
+     * Encrypt a pattern for storage
+     */
+    encryptPattern(pattern: string): string;
+    /**
+     * Decrypt a pattern from storage
+     */
+    decryptPattern(encryptedPattern: string): string;
+    /**
+     * Apply data retention policy
+     */
+    applyRetentionPolicy(timestamp: Date | number): RetentionPolicyResult;
+    /**
+     * Start cleanup timer for PARANOID mode
+     */
+    private startCleanupTimer;
+    /**
+     * Stop cleanup timer
+     */
+    stopCleanupTimer(): void;
+    /**
+     * Clear all anonymization mappings
+     */
+    clearAnonymizationMappings(): void;
+    /**
+     * Get privacy configuration
+     */
+    getConfig(): Required<PrivacyConfig>;
+    /**
+     * Update privacy configuration
+     */
+    updateConfig(config: Partial<PrivacyConfig>): void;
+    /**
+     * Dispose of resources
+     */
+    dispose(): void;
+    /**
+     * Export privacy statistics
+     */
+    getStats(): {
+        privacyLevel: PrivacyLevel;
+        canShare: boolean;
+        canPersist: boolean;
+        retentionPeriod: number;
+        anonymizedAgents: number;
+        redactionPatterns: number;
+    };
+}
+//# sourceMappingURL=PrivacyManager.d.ts.map

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

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