agentic-qe 2.1.2 → 2.2.1

package/dist/learning/ExplainableLearning.d.ts

@@ -0,0 +1,191 @@
+/**
+ * ExplainableLearning - Explainable AI for Reinforcement Learning Decisions
+ *
+ * Provides human-readable explanations for RL agent decisions, tracking:
+ * - Action selection rationale (Q-values, exploration vs exploitation)
+ * - Confidence scores based on experience history
+ * - Contributing experiences that influenced decisions
+ * - Decision factors and alternative actions
+ *
+ * Supports transparency and trust in agent decision-making for issue #118
+ */
+import { TaskState, AgentAction, TaskExperience } from './types';
+/**
+ * Decision type: exploration or exploitation
+ */
+export type DecisionType = 'exploration' | 'exploitation';
+/**
+ * Explanation for action selection
+ */
+export interface ActionExplanation {
+    /** The selected action */
+    selectedAction: AgentAction;
+    /** Decision type (exploration or exploitation) */
+    decisionType: DecisionType;
+    /** Q-value of the selected action */
+    qValue: number;
+    /** Confidence score (0-1) based on experience */
+    confidence: number;
+    /** Human-readable reasoning */
+    reasoning: string;
+    /** Alternative actions considered */
+    alternatives: ActionAlternative[];
+    /** Contributing experiences that led to this decision */
+    contributingExperiences: ContributingExperience[];
+    /** Decision factors that influenced selection */
+    decisionFactors: DecisionFactor[];
+    /** Timestamp of decision */
+    timestamp: Date;
+}
+/**
+ * Alternative action that was considered
+ */
+export interface ActionAlternative {
+    /** The alternative action */
+    action: AgentAction;
+    /** Q-value of this alternative */
+    qValue: number;
+    /** Confidence score for this alternative */
+    confidence: number;
+    /** Why it wasn't selected */
+    reason: string;
+}
+/**
+ * Experience that contributed to the decision
+ */
+export interface ContributingExperience {
+    /** Experience ID */
+    experienceId: string;
+    /** Task type */
+    taskType: string;
+    /** Reward received */
+    reward: number;
+    /** How similar this experience is to current state (0-1) */
+    similarity: number;
+    /** Timestamp of experience */
+    timestamp: Date;
+}
+/**
+ * Factor that influenced the decision
+ */
+export interface DecisionFactor {
+    /** Factor name */
+    name: string;
+    /** Factor value */
+    value: number | string;
+    /** Impact on decision (0-1) */
+    impact: number;
+    /** Description of this factor */
+    description: string;
+}
+/**
+ * Structured explanation format for programmatic use
+ */
+export interface StructuredExplanation {
+    /** Action explanation */
+    explanation: ActionExplanation;
+    /** State representation */
+    state: TaskState;
+    /** All available actions */
+    availableActions: AgentAction[];
+    /** Exploration rate at time of decision */
+    explorationRate: number;
+}
+/**
+ * Natural language explanation format
+ */
+export interface NaturalLanguageExplanation {
+    /** Summary sentence */
+    summary: string;
+    /** Detailed explanation paragraphs */
+    details: string[];
+    /** Key metrics */
+    metrics: Record<string, string>;
+    /** Recommendations */
+    recommendations: string[];
+}
+/**
+ * ExplainableLearning - Generates explanations for RL decisions
+ */
+export declare class ExplainableLearning {
+    private readonly logger;
+    constructor();
+    /**
+     * Generate explanation for action selection
+     *
+     * @param state - Current task state
+     * @param selectedAction - The action that was selected
+     * @param availableActions - All available actions
+     * @param qValues - Q-values for state-action pairs
+     * @param explorationRate - Current exploration rate
+     * @param experiences - Historical experiences for this agent
+     * @param wasExploration - Whether this was an exploration decision
+     * @returns Complete action explanation
+     */
+    explainAction(state: TaskState, selectedAction: AgentAction, availableActions: AgentAction[], qValues: Map<string, number>, explorationRate: number, experiences: TaskExperience[], wasExploration: boolean): ActionExplanation;
+    /**
+     * Calculate confidence score based on experience history
+     * Higher confidence when:
+     * - More experiences with similar states
+     * - Higher success rate
+     * - More recent positive experiences
+     */
+    private calculateConfidence;
+    /**
+     * Get experience statistics for state-action pair
+     */
+    private getExperienceStats;
+    /**
+     * Generate human-readable reasoning
+     */
+    private generateReasoning;
+    /**
+     * Identify alternative actions and explain why they weren't selected
+     */
+    private identifyAlternatives;
+    /**
+     * Find experiences that contributed to this decision
+     */
+    private findContributingExperiences;
+    /**
+     * Calculate similarity between two states (0-1)
+     */
+    private calculateStateSimilarity;
+    /**
+     * Analyze decision factors
+     */
+    private analyzeDecisionFactors;
+    /**
+     * Export explanation in structured format
+     */
+    exportStructured(explanation: ActionExplanation, state: TaskState, availableActions: AgentAction[], explorationRate: number): StructuredExplanation;
+    /**
+     * Export explanation in natural language format
+     */
+    exportNaturalLanguage(explanation: ActionExplanation): NaturalLanguageExplanation;
+    /**
+     * Generate summary sentence
+     */
+    private generateSummary;
+    /**
+     * Generate detailed explanation paragraphs
+     */
+    private generateDetails;
+    /**
+     * Generate key metrics
+     */
+    private generateMetrics;
+    /**
+     * Generate recommendations for user
+     */
+    private generateRecommendations;
+    /**
+     * Encode state to string key (matches LearningEngine encoding)
+     */
+    private encodeState;
+    /**
+     * Encode action to string key (matches LearningEngine encoding)
+     */
+    private encodeAction;
+}
+//# sourceMappingURL=ExplainableLearning.d.ts.map

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

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

package/dist/learning/ExplainableLearning.js

@@ -0,0 +1,441 @@
+"use strict";
+/**
+ * ExplainableLearning - Explainable AI for Reinforcement Learning Decisions
+ *
+ * Provides human-readable explanations for RL agent decisions, tracking:
+ * - Action selection rationale (Q-values, exploration vs exploitation)
+ * - Confidence scores based on experience history
+ * - Contributing experiences that influenced decisions
+ * - Decision factors and alternative actions
+ *
+ * Supports transparency and trust in agent decision-making for issue #118
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExplainableLearning = void 0;
+const Logger_1 = require("../utils/Logger");
+/**
+ * ExplainableLearning - Generates explanations for RL decisions
+ */
+class ExplainableLearning {
+    constructor() {
+        this.logger = Logger_1.Logger.getInstance();
+        this.logger.info('ExplainableLearning initialized');
+    }
+    /**
+     * Generate explanation for action selection
+     *
+     * @param state - Current task state
+     * @param selectedAction - The action that was selected
+     * @param availableActions - All available actions
+     * @param qValues - Q-values for state-action pairs
+     * @param explorationRate - Current exploration rate
+     * @param experiences - Historical experiences for this agent
+     * @param wasExploration - Whether this was an exploration decision
+     * @returns Complete action explanation
+     */
+    explainAction(state, selectedAction, availableActions, qValues, explorationRate, experiences, wasExploration) {
+        const selectedActionKey = this.encodeAction(selectedAction);
+        const selectedQValue = qValues.get(selectedActionKey) ?? 0;
+        // Determine decision type
+        const decisionType = wasExploration ? 'exploration' : 'exploitation';
+        // Calculate confidence based on experience
+        const confidence = this.calculateConfidence(state, selectedAction, experiences);
+        // Generate reasoning
+        const reasoning = this.generateReasoning(decisionType, selectedQValue, confidence, explorationRate, availableActions.length, experiences);
+        // Identify alternatives
+        const alternatives = this.identifyAlternatives(selectedAction, availableActions, qValues, experiences, decisionType);
+        // Find contributing experiences
+        const contributingExperiences = this.findContributingExperiences(state, selectedAction, experiences);
+        // Analyze decision factors
+        const decisionFactors = this.analyzeDecisionFactors(state, selectedAction, selectedQValue, explorationRate, confidence, wasExploration);
+        return {
+            selectedAction,
+            decisionType,
+            qValue: selectedQValue,
+            confidence,
+            reasoning,
+            alternatives,
+            contributingExperiences,
+            decisionFactors,
+            timestamp: new Date()
+        };
+    }
+    /**
+     * Calculate confidence score based on experience history
+     * Higher confidence when:
+     * - More experiences with similar states
+     * - Higher success rate
+     * - More recent positive experiences
+     */
+    calculateConfidence(state, action, experiences) {
+        const stats = this.getExperienceStats(state, action, experiences);
+        if (stats.totalCount === 0) {
+            return 0.1; // Low confidence with no experience
+        }
+        // Base confidence from experience count (logarithmic scale)
+        const experienceConfidence = Math.min(0.4, Math.log10(stats.totalCount + 1) / 2);
+        // Success rate confidence
+        const successConfidence = stats.successCount > 0
+            ? (stats.successCount / stats.totalCount) * 0.3
+            : 0;
+        // Recent performance confidence
+        const recentConfidence = Math.max(0, stats.recentPerformance) * 0.3;
+        return Math.min(0.95, experienceConfidence + successConfidence + recentConfidence);
+    }
+    /**
+     * Get experience statistics for state-action pair
+     */
+    getExperienceStats(state, action, experiences) {
+        const stateKey = this.encodeState(state);
+        const actionKey = this.encodeAction(action);
+        // Find similar experiences
+        const similarExperiences = experiences.filter(exp => {
+            const expStateKey = this.encodeState(exp.state);
+            const expActionKey = this.encodeAction(exp.action);
+            // Exact match for now (could use similarity threshold)
+            return expStateKey === stateKey && expActionKey === actionKey;
+        });
+        const totalCount = similarExperiences.length;
+        const successCount = similarExperiences.filter(exp => exp.reward > 0).length;
+        const averageReward = totalCount > 0
+            ? similarExperiences.reduce((sum, exp) => sum + exp.reward, 0) / totalCount
+            : 0;
+        // Recent performance (last 10 experiences)
+        const recentExperiences = similarExperiences.slice(-10);
+        const recentPerformance = recentExperiences.length > 0
+            ? recentExperiences.reduce((sum, exp) => sum + exp.reward, 0) / recentExperiences.length
+            : 0;
+        return {
+            totalCount,
+            successCount,
+            averageReward,
+            recentPerformance
+        };
+    }
+    /**
+     * Generate human-readable reasoning
+     */
+    generateReasoning(decisionType, qValue, confidence, explorationRate, numActions, experiences) {
+        if (decisionType === 'exploration') {
+            const explorationPercent = (explorationRate * 100).toFixed(1);
+            return `Explored this action (confidence: ${confidence.toFixed(2)}) to gather more information. ` +
+                `Current exploration rate is ${explorationPercent}%, balancing learning with exploitation.`;
+        }
+        // Exploitation
+        const qValueFormatted = qValue.toFixed(3);
+        const confidencePercent = (confidence * 100).toFixed(0);
+        const experienceCount = experiences.length;
+        if (qValue > 0.5) {
+            return `Selected action with highest Q-value (${qValueFormatted}) among ${numActions} alternatives. ` +
+                `High confidence (${confidencePercent}%) based on ${experienceCount} past experiences with strong positive results.`;
+        }
+        else if (qValue > 0) {
+            return `Selected action with Q-value ${qValueFormatted} (moderate positive expectation). ` +
+                `Medium confidence (${confidencePercent}%) from ${experienceCount} experiences. More data will improve decision quality.`;
+        }
+        else {
+            return `Selected best available action (Q-value: ${qValueFormatted}) among ${numActions} options. ` +
+                `Lower confidence (${confidencePercent}%) suggests limited experience in this state.`;
+        }
+    }
+    /**
+     * Identify alternative actions and explain why they weren't selected
+     */
+    identifyAlternatives(selectedAction, availableActions, qValues, experiences, decisionType) {
+        const selectedActionKey = this.encodeAction(selectedAction);
+        const alternatives = [];
+        for (const action of availableActions) {
+            const actionKey = this.encodeAction(action);
+            // Skip the selected action
+            if (actionKey === selectedActionKey) {
+                continue;
+            }
+            const qValue = qValues.get(actionKey) ?? 0;
+            const confidence = this.calculateConfidence({ taskComplexity: 0, requiredCapabilities: [], contextFeatures: {}, previousAttempts: 0, availableResources: 1 }, action, experiences);
+            // Determine why it wasn't selected
+            let reason;
+            if (decisionType === 'exploration') {
+                reason = 'Random exploration selected different action';
+            }
+            else {
+                const selectedQValue = qValues.get(selectedActionKey) ?? 0;
+                if (qValue < selectedQValue) {
+                    reason = `Lower Q-value (${qValue.toFixed(3)} vs ${selectedQValue.toFixed(3)})`;
+                }
+                else {
+                    reason = 'Similar Q-value but other action selected during exploitation';
+                }
+            }
+            alternatives.push({
+                action,
+                qValue,
+                confidence,
+                reason
+            });
+        }
+        // Sort by Q-value descending
+        alternatives.sort((a, b) => b.qValue - a.qValue);
+        // Return top 3 alternatives
+        return alternatives.slice(0, 3);
+    }
+    /**
+     * Find experiences that contributed to this decision
+     */
+    findContributingExperiences(state, action, experiences) {
+        const stateKey = this.encodeState(state);
+        const actionKey = this.encodeAction(action);
+        const contributingExps = [];
+        for (const exp of experiences) {
+            const expStateKey = this.encodeState(exp.state);
+            const expActionKey = this.encodeAction(exp.action);
+            // Calculate similarity
+            const similarity = this.calculateStateSimilarity(state, exp.state);
+            // Include if same action and similar state
+            if (expActionKey === actionKey && similarity > 0.5) {
+                contributingExps.push({
+                    experienceId: exp.taskId,
+                    taskType: exp.taskType,
+                    reward: exp.reward,
+                    similarity,
+                    timestamp: exp.timestamp
+                });
+            }
+        }
+        // Sort by similarity and recency
+        contributingExps.sort((a, b) => {
+            const similarityDiff = b.similarity - a.similarity;
+            if (Math.abs(similarityDiff) > 0.1) {
+                return similarityDiff;
+            }
+            return b.timestamp.getTime() - a.timestamp.getTime();
+        });
+        // Return top 5
+        return contributingExps.slice(0, 5);
+    }
+    /**
+     * Calculate similarity between two states (0-1)
+     */
+    calculateStateSimilarity(state1, state2) {
+        let similarity = 0;
+        let factors = 0;
+        // Task complexity similarity
+        similarity += 1 - Math.abs(state1.taskComplexity - state2.taskComplexity);
+        factors++;
+        // Available resources similarity
+        similarity += 1 - Math.abs(state1.availableResources - state2.availableResources);
+        factors++;
+        // Previous attempts similarity
+        const attemptDiff = Math.abs(state1.previousAttempts - state2.previousAttempts);
+        similarity += Math.max(0, 1 - attemptDiff / 5);
+        factors++;
+        // Required capabilities overlap
+        const capabilities1 = new Set(state1.requiredCapabilities);
+        const capabilities2 = new Set(state2.requiredCapabilities);
+        const intersection = new Set([...capabilities1].filter(x => capabilities2.has(x)));
+        const union = new Set([...capabilities1, ...capabilities2]);
+        if (union.size > 0) {
+            similarity += intersection.size / union.size;
+            factors++;
+        }
+        return factors > 0 ? similarity / factors : 0;
+    }
+    /**
+     * Analyze decision factors
+     */
+    analyzeDecisionFactors(state, action, qValue, explorationRate, confidence, wasExploration) {
+        const factors = [];
+        // Q-value factor
+        factors.push({
+            name: 'Q-Value',
+            value: qValue.toFixed(3),
+            impact: wasExploration ? 0.3 : 0.9,
+            description: 'Expected cumulative reward for this state-action pair'
+        });
+        // Exploration rate factor
+        factors.push({
+            name: 'Exploration Rate',
+            value: `${(explorationRate * 100).toFixed(1)}%`,
+            impact: wasExploration ? 0.9 : 0.1,
+            description: 'Probability of selecting random action for exploration'
+        });
+        // Confidence factor
+        factors.push({
+            name: 'Confidence',
+            value: `${(confidence * 100).toFixed(0)}%`,
+            impact: 0.7,
+            description: 'Based on number and quality of similar past experiences'
+        });
+        // Task complexity factor
+        factors.push({
+            name: 'Task Complexity',
+            value: state.taskComplexity.toFixed(2),
+            impact: 0.5,
+            description: 'Complexity of current task (0=simple, 1=complex)'
+        });
+        // Resource availability factor
+        factors.push({
+            name: 'Available Resources',
+            value: `${(state.availableResources * 100).toFixed(0)}%`,
+            impact: 0.4,
+            description: 'Resources available for task execution'
+        });
+        // Strategy factor
+        factors.push({
+            name: 'Strategy',
+            value: action.strategy,
+            impact: 0.8,
+            description: 'Selected execution strategy'
+        });
+        // Parallelization factor
+        factors.push({
+            name: 'Parallelization',
+            value: `${(action.parallelization * 100).toFixed(0)}%`,
+            impact: 0.5,
+            description: 'Degree of parallel execution'
+        });
+        // Sort by impact
+        factors.sort((a, b) => b.impact - a.impact);
+        return factors;
+    }
+    /**
+     * Export explanation in structured format
+     */
+    exportStructured(explanation, state, availableActions, explorationRate) {
+        return {
+            explanation,
+            state,
+            availableActions,
+            explorationRate
+        };
+    }
+    /**
+     * Export explanation in natural language format
+     */
+    exportNaturalLanguage(explanation) {
+        const summary = this.generateSummary(explanation);
+        const details = this.generateDetails(explanation);
+        const metrics = this.generateMetrics(explanation);
+        const recommendations = this.generateRecommendations(explanation);
+        return {
+            summary,
+            details,
+            metrics,
+            recommendations
+        };
+    }
+    /**
+     * Generate summary sentence
+     */
+    generateSummary(explanation) {
+        const action = explanation.selectedAction.strategy;
+        const type = explanation.decisionType;
+        const confidence = (explanation.confidence * 100).toFixed(0);
+        if (type === 'exploration') {
+            return `Explored "${action}" strategy with ${confidence}% confidence to gather more experience.`;
+        }
+        else {
+            return `Selected "${action}" strategy with ${confidence}% confidence based on Q-value of ${explanation.qValue.toFixed(3)}.`;
+        }
+    }
+    /**
+     * Generate detailed explanation paragraphs
+     */
+    generateDetails(explanation) {
+        const details = [];
+        // Main reasoning
+        details.push(explanation.reasoning);
+        // Contributing experiences
+        if (explanation.contributingExperiences.length > 0) {
+            const exp = explanation.contributingExperiences[0];
+            const successRate = explanation.contributingExperiences.filter(e => e.reward > 0).length /
+                explanation.contributingExperiences.length;
+            details.push(`This decision is based on ${explanation.contributingExperiences.length} similar past experiences ` +
+                `with a ${(successRate * 100).toFixed(0)}% success rate. The most similar experience was from ` +
+                `"${exp.taskType}" which had a reward of ${exp.reward.toFixed(2)}.`);
+        }
+        else {
+            details.push('This decision is based on limited historical data. As the agent gains more experience, ' +
+                'decision quality will improve.');
+        }
+        // Top decision factors
+        const topFactors = explanation.decisionFactors.slice(0, 3);
+        if (topFactors.length > 0) {
+            const factorList = topFactors.map(f => `${f.name} (${f.value})`).join(', ');
+            details.push(`Key decision factors: ${factorList}.`);
+        }
+        // Alternatives
+        if (explanation.alternatives.length > 0) {
+            const alt = explanation.alternatives[0];
+            details.push(`The next best alternative was "${alt.action.strategy}" with Q-value ${alt.qValue.toFixed(3)}. ` +
+                `It wasn't selected because: ${alt.reason}.`);
+        }
+        return details;
+    }
+    /**
+     * Generate key metrics
+     */
+    generateMetrics(explanation) {
+        const metrics = {};
+        metrics['Decision Type'] = explanation.decisionType === 'exploration' ? 'Exploration' : 'Exploitation';
+        metrics['Q-Value'] = explanation.qValue.toFixed(3);
+        metrics['Confidence'] = `${(explanation.confidence * 100).toFixed(0)}%`;
+        metrics['Strategy'] = explanation.selectedAction.strategy;
+        metrics['Similar Experiences'] = explanation.contributingExperiences.length.toString();
+        if (explanation.contributingExperiences.length > 0) {
+            const successCount = explanation.contributingExperiences.filter(e => e.reward > 0).length;
+            metrics['Success Rate'] = `${((successCount / explanation.contributingExperiences.length) * 100).toFixed(0)}%`;
+        }
+        return metrics;
+    }
+    /**
+     * Generate recommendations for user
+     */
+    generateRecommendations(explanation) {
+        const recommendations = [];
+        // Low confidence recommendation
+        if (explanation.confidence < 0.3) {
+            recommendations.push('Low confidence detected. Consider providing feedback to help the agent learn faster.');
+        }
+        // Limited experience recommendation
+        if (explanation.contributingExperiences.length < 3) {
+            recommendations.push('Limited experience in this scenario. The agent will improve with more similar tasks.');
+        }
+        // Exploration recommendation
+        if (explanation.decisionType === 'exploration') {
+            recommendations.push('This was an exploratory action. If it performs well, it will be favored in future decisions.');
+        }
+        // High confidence recommendation
+        if (explanation.confidence > 0.8) {
+            recommendations.push('High confidence in this decision based on extensive past experience.');
+        }
+        // Alternative suggestion
+        if (explanation.alternatives.length > 0) {
+            const alt = explanation.alternatives[0];
+            if (Math.abs(alt.qValue - explanation.qValue) < 0.1) {
+                recommendations.push(`Alternative strategy "${alt.action.strategy}" has similar expected performance and could also work well.`);
+            }
+        }
+        return recommendations;
+    }
+    /**
+     * Encode state to string key (matches LearningEngine encoding)
+     */
+    encodeState(state) {
+        const features = [
+            state.taskComplexity,
+            state.requiredCapabilities.length / 10,
+            state.previousAttempts / 5,
+            state.availableResources,
+            state.timeConstraint ? Math.min(state.timeConstraint / 300000, 1) : 1
+        ];
+        return features.map(f => Math.round(f * 10) / 10).join(',');
+    }
+    /**
+     * Encode action to string key (matches LearningEngine encoding)
+     */
+    encodeAction(action) {
+        return `${action.strategy}:${action.parallelization.toFixed(1)}:${action.retryPolicy}`;
+    }
+}
+exports.ExplainableLearning = ExplainableLearning;
+//# sourceMappingURL=ExplainableLearning.js.map

package/dist/learning/ExplainableLearning.js.map

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