agentic-flow 3.0.0-alpha.1 → 3.0.0

package/dist/services/explainability-service.d.ts

@@ -1,182 +0,0 @@
-/**
- * ExplainabilityService - Full Transparency for Trust, Debugging, and Compliance
- *
- * Provides complete execution tracing with <5% overhead:
- * - Attention visualization (show what model focuses on)
- * - Decision trees (explain routing and model selection)
- * - Counterfactual explanations ("What if we changed X?")
- * - Feature importance (which inputs matter most?)
- * - Trace debugging (full execution path visualization)
- * - Performance profiling (hot paths and bottlenecks)
- * - Compliance reports (audit logs for regulatory requirements)
- */
-export interface AttentionWeight {
-    token: string;
-    weight: number;
-    position: number;
-}
-export interface AttentionHead {
-    headId: number;
-    layer: number;
-    weights: AttentionWeight[];
-    topK: string[];
-}
-export interface AttentionVisualization {
-    traceId: string;
-    inputText: string;
-    outputText: string;
-    heads: AttentionHead[];
-    aggregatedWeights: Map<string, number>;
-    focusTokens: string[];
-}
-export interface DecisionNode {
-    nodeId: string;
-    decision: string;
-    reasoning: string;
-    confidence: number;
-    alternatives: Array<{
-        decision: string;
-        confidence: number;
-        reasoning: string;
-    }>;
-    children: DecisionNode[];
-    metadata?: Record<string, unknown>;
-}
-export interface DecisionTree {
-    traceId: string;
-    rootNode: DecisionNode;
-    depth: number;
-    totalNodes: number;
-    criticalPath: string[];
-}
-export interface CounterfactualScenario {
-    original: Record<string, unknown>;
-    modified: Record<string, unknown>;
-    changedKeys: string[];
-    originalOutcome: string;
-    counterfactualOutcome: string;
-    outcomeChanged: boolean;
-    explanation: string;
-}
-export interface FeatureImportance {
-    feature: string;
-    importance: number;
-    impact: 'positive' | 'negative' | 'neutral';
-    examples: string[];
-}
-export interface ExecutionTrace {
-    traceId: string;
-    startTime: number;
-    endTime: number;
-    durationMs: number;
-    steps: TraceStep[];
-    modelUsed: string;
-    totalCost: number;
-    success: boolean;
-    error?: string;
-}
-export interface TraceStep {
-    stepId: string;
-    type: 'input' | 'processing' | 'decision' | 'output' | 'error';
-    timestamp: number;
-    durationMs: number;
-    description: string;
-    metadata?: Record<string, unknown>;
-}
-export interface PerformanceProfile {
-    traceId: string;
-    hotPaths: Array<{
-        path: string;
-        count: number;
-        totalMs: number;
-        avgMs: number;
-    }>;
-    bottlenecks: Array<{
-        stepId: string;
-        durationMs: number;
-        percentage: number;
-    }>;
-    memoryUsage: Array<{
-        timestamp: number;
-        usedMB: number;
-    }>;
-    cpuUsage: Array<{
-        timestamp: number;
-        percent: number;
-    }>;
-}
-export interface ComplianceReport {
-    reportId: string;
-    generatedAt: number;
-    traceIds: string[];
-    summary: {
-        totalRequests: number;
-        successRate: number;
-        averageLatency: number;
-        totalCost: number;
-        modelsUsed: Record<string, number>;
-    };
-    auditLog: AuditEntry[];
-    dataHandling: {
-        piiDetected: boolean;
-        piiLocations: string[];
-        dataRetentionCompliant: boolean;
-        encryptionUsed: boolean;
-    };
-}
-export interface AuditEntry {
-    timestamp: number;
-    traceId: string;
-    action: string;
-    user?: string;
-    result: 'success' | 'failure';
-    metadata?: Record<string, unknown>;
-}
-export interface ExplainabilityMetrics {
-    tracesCollected: number;
-    averageOverheadMs: number;
-    overheadPercentage: number;
-    storageUsedMB: number;
-    complianceReportsGenerated: number;
-}
-export declare class ExplainabilityService {
-    private static instance;
-    private traces;
-    private decisionTrees;
-    private attentionViz;
-    private featureImportance;
-    private auditLog;
-    private enabled;
-    private samplingRate;
-    private constructor();
-    static getInstance(): ExplainabilityService;
-    setEnabled(enabled: boolean): void;
-    setSamplingRate(rate: number): void;
-    shouldSample(): boolean;
-    captureAttention(traceId: string, inputText: string, outputText: string, heads: AttentionHead[]): AttentionVisualization;
-    getAttentionVisualization(traceId: string): AttentionVisualization | null;
-    buildDecisionTree(traceId: string, rootNode: DecisionNode): DecisionTree;
-    private calculateDepth;
-    private countNodes;
-    private findCriticalPath;
-    getDecisionTree(traceId: string): DecisionTree | null;
-    generateCounterfactual(traceId: string, original: Record<string, unknown>, modifications: Record<string, unknown>): CounterfactualScenario;
-    private simulateExecution;
-    private estimateComplexity;
-    analyzeFeatureImportance(traceId: string, inputs: Record<string, unknown>, output: string): FeatureImportance[];
-    private calculateImportance;
-    private determineImpact;
-    getFeatureImportance(traceId: string): FeatureImportance[] | null;
-    startTrace(traceId: string): ExecutionTrace;
-    addTraceStep(traceId: string, step: Omit<TraceStep, 'stepId' | 'timestamp' | 'durationMs'>): void;
-    completeTraceStep(traceId: string, stepIndex: number): void;
-    endTrace(traceId: string, modelUsed: string, totalCost: number, success: boolean, error?: string): void;
-    getTrace(traceId: string): ExecutionTrace | null;
-    getAllTraces(): ExecutionTrace[];
-    generatePerformanceProfile(traceId: string): PerformanceProfile | null;
-    generateComplianceReport(traceIds?: string[]): ComplianceReport;
-    getMetrics(): ExplainabilityMetrics;
-    clearAll(): void;
-    clearTrace(traceId: string): void;
-}
-//# sourceMappingURL=explainability-service.d.ts.map

package/dist/services/explainability-service.d.ts.map

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

package/dist/services/explainability-service.js

@@ -1,417 +0,0 @@
-/**
- * ExplainabilityService - Full Transparency for Trust, Debugging, and Compliance
- *
- * Provides complete execution tracing with <5% overhead:
- * - Attention visualization (show what model focuses on)
- * - Decision trees (explain routing and model selection)
- * - Counterfactual explanations ("What if we changed X?")
- * - Feature importance (which inputs matter most?)
- * - Trace debugging (full execution path visualization)
- * - Performance profiling (hot paths and bottlenecks)
- * - Compliance reports (audit logs for regulatory requirements)
- */
-// ============================================================================
-// ExplainabilityService
-// ============================================================================
-export class ExplainabilityService {
-    static instance = null;
-    traces = new Map();
-    decisionTrees = new Map();
-    attentionViz = new Map();
-    featureImportance = new Map();
-    auditLog = [];
-    enabled = true;
-    samplingRate = 1.0; // 100% sampling by default
-    constructor() { }
-    static getInstance() {
-        if (!ExplainabilityService.instance) {
-            ExplainabilityService.instance = new ExplainabilityService();
-        }
-        return ExplainabilityService.instance;
-    }
-    // ============================================================================
-    // Configuration
-    // ============================================================================
-    setEnabled(enabled) {
-        this.enabled = enabled;
-    }
-    setSamplingRate(rate) {
-        if (rate < 0 || rate > 1) {
-            throw new Error('Sampling rate must be between 0 and 1');
-        }
-        this.samplingRate = rate;
-    }
-    shouldSample() {
-        return this.enabled && Math.random() < this.samplingRate;
-    }
-    // ============================================================================
-    // Attention Visualization
-    // ============================================================================
-    captureAttention(traceId, inputText, outputText, heads) {
-        const aggregatedWeights = new Map();
-        // Aggregate weights across all heads
-        for (const head of heads) {
-            for (const weight of head.weights) {
-                const current = aggregatedWeights.get(weight.token) || 0;
-                aggregatedWeights.set(weight.token, current + weight.weight);
-            }
-        }
-        // Find top tokens by total weight
-        const sorted = Array.from(aggregatedWeights.entries())
-            .sort((a, b) => b[1] - a[1])
-            .slice(0, 10);
-        const focusTokens = sorted.map(([token]) => token);
-        const viz = {
-            traceId,
-            inputText,
-            outputText,
-            heads,
-            aggregatedWeights,
-            focusTokens,
-        };
-        this.attentionViz.set(traceId, viz);
-        return viz;
-    }
-    getAttentionVisualization(traceId) {
-        return this.attentionViz.get(traceId) || null;
-    }
-    // ============================================================================
-    // Decision Trees
-    // ============================================================================
-    buildDecisionTree(traceId, rootNode) {
-        const depth = this.calculateDepth(rootNode);
-        const totalNodes = this.countNodes(rootNode);
-        const criticalPath = this.findCriticalPath(rootNode);
-        const tree = {
-            traceId,
-            rootNode,
-            depth,
-            totalNodes,
-            criticalPath,
-        };
-        this.decisionTrees.set(traceId, tree);
-        return tree;
-    }
-    calculateDepth(node, currentDepth = 0) {
-        if (node.children.length === 0) {
-            return currentDepth;
-        }
-        return Math.max(...node.children.map(child => this.calculateDepth(child, currentDepth + 1)));
-    }
-    countNodes(node) {
-        return 1 + node.children.reduce((sum, child) => sum + this.countNodes(child), 0);
-    }
-    findCriticalPath(node) {
-        const path = [node.nodeId];
-        if (node.children.length === 0) {
-            return path;
-        }
-        // Follow the highest confidence child
-        const bestChild = node.children.reduce((best, child) => child.confidence > best.confidence ? child : best);
-        return path.concat(this.findCriticalPath(bestChild));
-    }
-    getDecisionTree(traceId) {
-        return this.decisionTrees.get(traceId) || null;
-    }
-    // ============================================================================
-    // Counterfactual Explanations
-    // ============================================================================
-    generateCounterfactual(traceId, original, modifications) {
-        const modified = { ...original, ...modifications };
-        const changedKeys = Object.keys(modifications);
-        // Simulate re-execution with modified inputs
-        const originalOutcome = this.simulateExecution(original);
-        const counterfactualOutcome = this.simulateExecution(modified);
-        const outcomeChanged = originalOutcome !== counterfactualOutcome;
-        let explanation = '';
-        if (outcomeChanged) {
-            explanation = `Changing ${changedKeys.join(', ')} resulted in different outcome: ${originalOutcome} → ${counterfactualOutcome}`;
-        }
-        else {
-            explanation = `Changing ${changedKeys.join(', ')} did not affect the outcome (still ${originalOutcome})`;
-        }
-        return {
-            original,
-            modified,
-            changedKeys,
-            originalOutcome,
-            counterfactualOutcome,
-            outcomeChanged,
-            explanation,
-        };
-    }
-    simulateExecution(inputs) {
-        // Simple simulation based on input complexity
-        const complexity = this.estimateComplexity(inputs);
-        if (complexity < 30) {
-            return 'agent-booster';
-        }
-        else if (complexity < 60) {
-            return 'claude-haiku-4';
-        }
-        else if (complexity < 85) {
-            return 'claude-sonnet-4';
-        }
-        else {
-            return 'claude-opus-4';
-        }
-    }
-    estimateComplexity(inputs) {
-        // Estimate complexity based on input characteristics
-        let complexity = 0;
-        // Use complexity directly if provided
-        if (typeof inputs.complexity === 'number') {
-            complexity = inputs.complexity;
-        }
-        else {
-            const inputStr = JSON.stringify(inputs);
-            complexity += Math.min(inputStr.length / 100, 50); // Length factor (max 50)
-        }
-        if (inputs.requiresReasoning)
-            complexity += 30;
-        if (inputs.multiStep)
-            complexity += 20;
-        if (inputs.creative)
-            complexity += 15;
-        return Math.min(complexity, 100);
-    }
-    // ============================================================================
-    // Feature Importance
-    // ============================================================================
-    analyzeFeatureImportance(traceId, inputs, output) {
-        const features = [];
-        // Analyze each input feature
-        for (const [key, value] of Object.entries(inputs)) {
-            const importance = this.calculateImportance(key, value, output);
-            const impact = this.determineImpact(key, value, output);
-            features.push({
-                feature: key,
-                importance,
-                impact,
-                examples: [JSON.stringify(value)],
-            });
-        }
-        // Sort by importance
-        features.sort((a, b) => b.importance - a.importance);
-        this.featureImportance.set(traceId, features);
-        return features;
-    }
-    calculateImportance(key, value, output) {
-        // Simple heuristic: longer/more complex inputs are more important
-        const valueStr = JSON.stringify(value);
-        const lengthFactor = Math.min(valueStr.length / 1000, 0.5);
-        // Check if output mentions this key
-        const mentionFactor = output.toLowerCase().includes(key.toLowerCase()) ? 0.3 : 0;
-        return Math.min(lengthFactor + mentionFactor + 0.2, 1.0);
-    }
-    determineImpact(key, value, output) {
-        // Simple sentiment analysis
-        if (typeof value === 'boolean') {
-            return value ? 'positive' : 'negative';
-        }
-        return 'neutral';
-    }
-    getFeatureImportance(traceId) {
-        return this.featureImportance.get(traceId) || null;
-    }
-    // ============================================================================
-    // Trace Debugging
-    // ============================================================================
-    startTrace(traceId) {
-        const trace = {
-            traceId,
-            startTime: Date.now(),
-            endTime: 0,
-            durationMs: 0,
-            steps: [],
-            modelUsed: 'unknown',
-            totalCost: 0,
-            success: false,
-        };
-        this.traces.set(traceId, trace);
-        return trace;
-    }
-    addTraceStep(traceId, step) {
-        const trace = this.traces.get(traceId);
-        if (!trace)
-            return;
-        const startTime = Date.now();
-        const fullStep = {
-            stepId: `${traceId}-${trace.steps.length}`,
-            timestamp: startTime,
-            durationMs: 0,
-            ...step,
-        };
-        trace.steps.push(fullStep);
-    }
-    completeTraceStep(traceId, stepIndex) {
-        const trace = this.traces.get(traceId);
-        if (!trace || stepIndex >= trace.steps.length)
-            return;
-        const step = trace.steps[stepIndex];
-        step.durationMs = Date.now() - step.timestamp;
-    }
-    endTrace(traceId, modelUsed, totalCost, success, error) {
-        const trace = this.traces.get(traceId);
-        if (!trace)
-            return;
-        const endTime = Date.now();
-        trace.endTime = endTime;
-        // Ensure minimum 1ms duration for test reliability
-        trace.durationMs = Math.max(1, endTime - trace.startTime);
-        trace.modelUsed = modelUsed;
-        trace.totalCost = totalCost;
-        trace.success = success;
-        trace.error = error;
-        // Add to audit log
-        this.auditLog.push({
-            timestamp: trace.endTime,
-            traceId,
-            action: 'execution',
-            result: success ? 'success' : 'failure',
-            metadata: { modelUsed, totalCost, durationMs: trace.durationMs },
-        });
-    }
-    getTrace(traceId) {
-        return this.traces.get(traceId) || null;
-    }
-    getAllTraces() {
-        return Array.from(this.traces.values());
-    }
-    // ============================================================================
-    // Performance Profiling
-    // ============================================================================
-    generatePerformanceProfile(traceId) {
-        const trace = this.traces.get(traceId);
-        if (!trace)
-            return null;
-        // Find hot paths (frequently executed steps)
-        const pathCounts = new Map();
-        for (const step of trace.steps) {
-            const key = step.description;
-            const current = pathCounts.get(key) || { count: 0, totalMs: 0 };
-            pathCounts.set(key, {
-                count: current.count + 1,
-                totalMs: current.totalMs + step.durationMs,
-            });
-        }
-        const hotPaths = Array.from(pathCounts.entries())
-            .map(([path, stats]) => ({
-            path,
-            count: stats.count,
-            totalMs: stats.totalMs,
-            avgMs: stats.totalMs / stats.count,
-        }))
-            .sort((a, b) => b.totalMs - a.totalMs)
-            .slice(0, 10);
-        // Find bottlenecks (slowest steps)
-        const bottlenecks = trace.steps
-            .map(step => ({
-            stepId: step.stepId,
-            durationMs: step.durationMs,
-            percentage: (step.durationMs / trace.durationMs) * 100,
-        }))
-            .sort((a, b) => b.durationMs - a.durationMs)
-            .slice(0, 5);
-        // Mock memory/CPU usage (in real impl, collect from process.memoryUsage())
-        const memoryUsage = trace.steps.map(step => ({
-            timestamp: step.timestamp,
-            usedMB: Math.random() * 100 + 50, // Mock data
-        }));
-        const cpuUsage = trace.steps.map(step => ({
-            timestamp: step.timestamp,
-            percent: Math.random() * 50 + 10, // Mock data
-        }));
-        return {
-            traceId,
-            hotPaths,
-            bottlenecks,
-            memoryUsage,
-            cpuUsage,
-        };
-    }
-    // ============================================================================
-    // Compliance Reports
-    // ============================================================================
-    generateComplianceReport(traceIds) {
-        const reportId = `report-${Date.now()}`;
-        const targetTraces = traceIds
-            ? traceIds.map(id => this.traces.get(id)).filter(t => t !== undefined)
-            : Array.from(this.traces.values());
-        const totalRequests = targetTraces.length;
-        const successCount = targetTraces.filter(t => t.success).length;
-        const successRate = totalRequests > 0 ? successCount / totalRequests : 0;
-        const totalLatency = targetTraces.reduce((sum, t) => sum + t.durationMs, 0);
-        const averageLatency = totalRequests > 0 ? totalLatency / totalRequests : 0;
-        const totalCost = targetTraces.reduce((sum, t) => sum + t.totalCost, 0);
-        const modelsUsed = {};
-        for (const trace of targetTraces) {
-            modelsUsed[trace.modelUsed] = (modelsUsed[trace.modelUsed] || 0) + 1;
-        }
-        // Mock PII detection (in real impl, use regex or ML model)
-        const piiDetected = false;
-        const piiLocations = [];
-        return {
-            reportId,
-            generatedAt: Date.now(),
-            traceIds: targetTraces.map(t => t.traceId),
-            summary: {
-                totalRequests,
-                successRate,
-                averageLatency,
-                totalCost,
-                modelsUsed,
-            },
-            auditLog: this.auditLog.filter(entry => !traceIds || traceIds.includes(entry.traceId)),
-            dataHandling: {
-                piiDetected,
-                piiLocations,
-                dataRetentionCompliant: true,
-                encryptionUsed: true,
-            },
-        };
-    }
-    // ============================================================================
-    // Metrics
-    // ============================================================================
-    getMetrics() {
-        const tracesCollected = this.traces.size;
-        // Calculate average overhead
-        const traces = Array.from(this.traces.values());
-        const totalOverhead = traces.reduce((sum, t) => {
-            // Estimate overhead as 2% of total duration (mock)
-            return sum + (t.durationMs * 0.02);
-        }, 0);
-        const averageOverheadMs = traces.length > 0 ? totalOverhead / traces.length : 0;
-        const averageDuration = traces.length > 0
-            ? traces.reduce((sum, t) => sum + t.durationMs, 0) / traces.length
-            : 0;
-        const overheadPercentage = averageDuration > 0 ? (averageOverheadMs / averageDuration) * 100 : 0;
-        // Estimate storage (rough)
-        const storageUsedMB = (tracesCollected * 2) / 1024; // ~2KB per trace
-        return {
-            tracesCollected,
-            averageOverheadMs,
-            overheadPercentage,
-            storageUsedMB,
-            complianceReportsGenerated: 0, // Track separately if needed
-        };
-    }
-    // ============================================================================
-    // Utility
-    // ============================================================================
-    clearAll() {
-        this.traces.clear();
-        this.decisionTrees.clear();
-        this.attentionViz.clear();
-        this.featureImportance.clear();
-        this.auditLog = [];
-    }
-    clearTrace(traceId) {
-        this.traces.delete(traceId);
-        this.decisionTrees.delete(traceId);
-        this.attentionViz.delete(traceId);
-        this.featureImportance.delete(traceId);
-    }
-}
-//# sourceMappingURL=explainability-service.js.map