agentic-qe 2.3.4 → 2.4.0

package/dist/learning/capture/ExperienceExtractor.d.ts

@@ -0,0 +1,219 @@
+/**
+ * ExperienceExtractor - Extract learnable content from agent executions
+ *
+ * Analyzes agent execution events to extract:
+ * - Patterns and techniques used
+ * - Decisions made during execution
+ * - Errors encountered and handled
+ * - Quality metrics and scores
+ * - Vector embeddings for similarity search
+ *
+ * Part of the Nightly-Learner Phase 1 implementation.
+ *
+ * @version 1.0.0
+ * @module src/learning/capture/ExperienceExtractor
+ */
+import { AgentExecutionEvent } from './ExperienceCapture';
+/**
+ * Extracted content from an execution event
+ */
+export interface ExtractedContent {
+    /** Patterns and techniques identified in the execution */
+    patterns: string[];
+    /** Decisions made during execution */
+    decisions: string[];
+    /** Errors encountered */
+    errors: string[];
+    /** Quality score (0-1) */
+    qualityScore: number;
+    /** Vector embedding for similarity search */
+    embedding?: number[];
+    /** Coverage metrics */
+    coverage?: {
+        delta: number;
+        total?: number;
+    };
+    /** Extraction metadata */
+    metadata: {
+        extractedAt: Date;
+        contentHash: string;
+        embeddingDimension?: number;
+        embeddingMethod?: 'hash' | 'ml';
+    };
+}
+/**
+ * Configuration for the experience extractor
+ */
+export interface ExperienceExtractorConfig {
+    /** Enable embedding generation. Default: true */
+    generateEmbeddings?: boolean;
+    /** Use ML-based embeddings. Default: false (uses hash-based) */
+    useMLEmbeddings?: boolean;
+    /** Embedding dimension. Default: 256 */
+    embeddingDimension?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+/**
+ * Statistics for extraction operations
+ */
+export interface ExtractionStats {
+    totalExtractions: number;
+    patternsExtracted: number;
+    decisionsExtracted: number;
+    errorsExtracted: number;
+    embeddingsGenerated: number;
+    avgQualityScore: number;
+    avgExtractionTime: number;
+}
+/**
+ * ExperienceExtractor extracts learnable content from agent executions
+ *
+ * Analyzes execution events to identify patterns, decisions, and quality metrics
+ * that can be used for learning and improvement.
+ *
+ * @example
+ * ```typescript
+ * const extractor = new ExperienceExtractor({
+ *   generateEmbeddings: true,
+ *   useMLEmbeddings: false
+ * });
+ *
+ * const content = await extractor.extract(executionEvent);
+ * console.log('Patterns:', content.patterns);
+ * console.log('Quality:', content.qualityScore);
+ * ```
+ */
+export declare class ExperienceExtractor {
+    private config;
+    private logger;
+    private embeddingGenerator;
+    private totalExtractions;
+    private totalPatterns;
+    private totalDecisions;
+    private totalErrors;
+    private totalEmbeddings;
+    private totalQualityScore;
+    private totalExtractionTime;
+    constructor(config?: ExperienceExtractorConfig);
+    /**
+     * Extract learnable content from an agent execution event
+     *
+     * @param event - Agent execution event to analyze
+     * @returns Extracted content with patterns, decisions, and embeddings
+     */
+    extract(event: AgentExecutionEvent): Promise<ExtractedContent>;
+    /**
+     * Extract patterns used during execution
+     *
+     * Looks for:
+     * - Explicit pattern references in output
+     * - Testing frameworks and strategies
+     * - Code patterns and techniques
+     * - Quality engineering approaches
+     *
+     * @param output - Execution output data
+     * @returns Array of pattern identifiers
+     */
+    extractPatterns(output: Record<string, unknown>): string[];
+    /**
+     * Extract decisions made during execution
+     *
+     * Looks for:
+     * - Strategic choices
+     * - Configuration decisions
+     * - Implementation approaches
+     * - Trade-off evaluations
+     *
+     * @param output - Execution output data
+     * @returns Array of decision descriptions
+     */
+    extractDecisions(output: Record<string, unknown>): string[];
+    /**
+     * Extract errors encountered during execution
+     *
+     * @param event - Execution event
+     * @returns Array of error messages
+     */
+    private extractErrors;
+    /**
+     * Calculate quality score for the execution
+     *
+     * Scoring factors:
+     * - Success/failure (0.5 base)
+     * - Coverage metrics (+0.2)
+     * - Tests generated (+0.1)
+     * - Execution speed (+0.1)
+     * - Error penalties (-0.2)
+     *
+     * @param event - Execution event
+     * @returns Quality score between 0 and 1
+     */
+    calculateQualityScore(event: AgentExecutionEvent): number;
+    /**
+     * Generate embedding for execution content
+     *
+     * Creates a vector embedding of the execution's content for similarity search.
+     * Combines input, output, patterns, and decisions into a single representation.
+     *
+     * @param event - Execution event
+     * @returns Embedding result with vector and metadata
+     */
+    generateEmbedding(event: AgentExecutionEvent): Promise<{
+        embedding: number[];
+        dimension: number;
+        method: 'hash' | 'ml';
+    }>;
+    /**
+     * Extract coverage metrics from event
+     *
+     * @param event - Execution event
+     * @returns Coverage information
+     */
+    private extractCoverage;
+    /**
+     * Serialize execution content to text for embedding
+     *
+     * @param event - Execution event
+     * @returns Text representation
+     */
+    private serializeExecutionContent;
+    /**
+     * Create content hash for deduplication
+     *
+     * @param event - Execution event
+     * @returns Content hash
+     */
+    private createContentHash;
+    /**
+     * Hash a string using simple algorithm
+     *
+     * @param str - String to hash
+     * @returns Hash string
+     */
+    private hashString;
+    /**
+     * Get extraction statistics
+     *
+     * @returns Statistics about extraction operations
+     */
+    getStats(): ExtractionStats;
+    /**
+     * Reset statistics
+     */
+    resetStats(): void;
+    /**
+     * Update configuration
+     *
+     * @param config - New configuration values
+     */
+    updateConfig(config: Partial<ExperienceExtractorConfig>): void;
+    /**
+     * Get current configuration
+     *
+     * @returns Current configuration
+     */
+    getConfig(): Required<ExperienceExtractorConfig>;
+}
+export default ExperienceExtractor;
+//# sourceMappingURL=ExperienceExtractor.d.ts.map

package/dist/learning/capture/ExperienceExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExperienceExtractor.d.ts","sourceRoot":"","sources":["../../../src/learning/capture/ExperienceExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAI1D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,sCAAsC;IACtC,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,yBAAyB;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IAEjB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,uBAAuB;IACvB,QAAQ,CAAC,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,0BAA0B;IAC1B,QAAQ,EAAE;QACR,WAAW,EAAE,IAAI,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,wCAAwC;IACxC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,kBAAkB,CAAqB;IAG/C,OAAO,CAAC,gBAAgB,CAAa;IACrC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,mBAAmB,CAAa;gBAE5B,MAAM,CAAC,EAAE,yBAAyB;IAiB9C;;;;;OAKG;IACG,OAAO,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA4EpE;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE;IA+D1D;;;;;;;;;;;OAWG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE;IAiE3D;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAmCrB;;;;;;;;;;;;OAYG;IACH,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM;IAgEzD;;;;;;;;OAQG;IACG,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC;QAC3D,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IAmCF;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAcvB;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAkCjC;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAUlB;;;;OAIG;IACH,QAAQ,IAAI,eAAe;IAgB3B;;OAEG;IACH,UAAU,IAAI,IAAI;IAUlB;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAAG,IAAI;IAS9D;;;;OAIG;IACH,SAAS,IAAI,QAAQ,CAAC,yBAAyB,CAAC;CAGjD;AAED,eAAe,mBAAmB,CAAC"}