@salimassili/ai-costguard 1.1.3

package/dist/aecl/ROITelemetry.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * AECL - ROI Telemetry System
+ *
+ * Tracks measurable value:
+ * - Estimated cost saved (blocked executions)
+ * - Prevented execution value (what would have been spent)
+ * - False positive tracking (blocked that shouldn't have been)
+ *
+ * OUTPUT:
+ * - Directly usable in billing dashboards
+ * - CSV export for customer reporting
+ * - 7-day ROI calculation
+ *
+ * NO:
+ * - Complex analytics
+ * - ML predictions
+ * - Attribution modeling
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.roiTelemetry = exports.ROITelemetry = void 0;
+/**
+ * ROI Telemetry
+ *
+ * Simple, accurate tracking for customer billing.
+ * Focus: Show measurable cost savings in first 7 days.
+ */
+class ROITelemetry {
+    constructor(maxLogs = 100000) {
+        this.logs = [];
+        this.maxLogs = maxLogs;
+        this.falsePositiveLog = new Set();
+    }
+    /**
+     * Log a decision
+     */
+    log(decision) {
+        this.logs.push(decision);
+        // Evict old logs if needed
+        if (this.logs.length > this.maxLogs) {
+            this.logs.shift();
+        }
+    }
+    /**
+     * Mark a blocked decision as false positive
+     * (User overrode the block)
+     */
+    markFalsePositive(requestId, actualCost) {
+        this.falsePositiveLog.add(requestId);
+        // Update the log entry
+        const log = this.logs.find(l => l.requestId === requestId);
+        if (log) {
+            log.actualCost = actualCost;
+        }
+    }
+    /**
+     * Update actual cost for allowed execution
+     */
+    recordActualCost(requestId, actualCost) {
+        const log = this.logs.find(l => l.requestId === requestId);
+        if (log) {
+            log.actualCost = actualCost;
+        }
+    }
+    /**
+     * Get ROI metrics (all time)
+     */
+    getMetrics() {
+        const total = this.logs.length;
+        const blocked = this.logs.filter(l => l.decision === 'block');
+        const allowed = this.logs.filter(l => l.decision === 'allow');
+        const estimatedSavings = blocked.reduce((sum, l) => sum + l.estimatedCost, 0);
+        const actualSpend = allowed
+            .filter(l => l.actualCost !== undefined)
+            .reduce((sum, l) => sum + (l.actualCost || 0), 0);
+        const falsePositives = this.falsePositiveLog.size;
+        const falsePositiveCost = blocked
+            .filter(l => this.falsePositiveLog.has(l.requestId))
+            .reduce((sum, l) => sum + l.estimatedCost, 0);
+        const latencies = this.logs.map(l => l.latencyMs);
+        const avgLatency = latencies.length > 0
+            ? latencies.reduce((a, b) => a + b, 0) / latencies.length
+            : 0;
+        const p95Latency = this.calculateP95(latencies);
+        return {
+            totalDecisions: total,
+            blockedCount: blocked.length,
+            allowCount: allowed.length,
+            estimatedSavings,
+            actualSpend,
+            falsePositives,
+            falsePositiveCost,
+            netSavings: estimatedSavings - falsePositiveCost,
+            avgDecisionLatencyMs: avgLatency,
+            p95DecisionLatencyMs: p95Latency,
+        };
+    }
+    /**
+     * Get 7-day ROI report
+     */
+    get7DayReport() {
+        const now = Date.now();
+        const sevenDaysAgo = now - (7 * 24 * 60 * 60 * 1000);
+        const recentLogs = this.logs.filter(l => l.timestamp >= sevenDaysAgo);
+        // Group by day
+        const dailyMap = new Map();
+        for (const log of recentLogs) {
+            const date = new Date(log.timestamp).toISOString().split('T')[0];
+            const existing = dailyMap.get(date) || [];
+            existing.push(log);
+            dailyMap.set(date, existing);
+        }
+        // Build daily reports
+        const daily = [];
+        for (const [date, logs] of dailyMap) {
+            const blocked = logs.filter(l => l.decision === 'block');
+            const allowed = logs.filter(l => l.decision === 'allow');
+            const savings = blocked.reduce((sum, l) => sum + l.estimatedCost, 0);
+            const spend = allowed
+                .filter(l => l.actualCost !== undefined)
+                .reduce((sum, l) => sum + (l.actualCost || 0), 0);
+            daily.push({
+                date,
+                decisions: logs.length,
+                blocked: blocked.length,
+                savings,
+                spend,
+                roi: spend > 0 ? ((savings - spend) / spend) * 100 : 0,
+            });
+        }
+        // Sort by date
+        daily.sort((a, b) => a.date.localeCompare(b.date));
+        // Calculate metrics for the period
+        const totalBlocked = recentLogs.filter(l => l.decision === 'block');
+        const totalAllowed = recentLogs.filter(l => l.decision === 'allow');
+        const estimatedSavings = totalBlocked.reduce((sum, l) => sum + l.estimatedCost, 0);
+        const actualSpend = totalAllowed
+            .filter(l => l.actualCost !== undefined)
+            .reduce((sum, l) => sum + (l.actualCost || 0), 0);
+        const metrics = {
+            totalDecisions: recentLogs.length,
+            blockedCount: totalBlocked.length,
+            allowCount: totalAllowed.length,
+            estimatedSavings,
+            actualSpend,
+            falsePositives: this.falsePositiveLog.size,
+            falsePositiveCost: totalBlocked
+                .filter(l => this.falsePositiveLog.has(l.requestId))
+                .reduce((sum, l) => sum + l.estimatedCost, 0),
+            netSavings: estimatedSavings - (totalBlocked
+                .filter(l => this.falsePositiveLog.has(l.requestId))
+                .reduce((sum, l) => sum + l.estimatedCost, 0)),
+            avgDecisionLatencyMs: recentLogs.length > 0
+                ? recentLogs.reduce((sum, l) => sum + l.latencyMs, 0) / recentLogs.length
+                : 0,
+            p95DecisionLatencyMs: this.calculateP95(recentLogs.map(l => l.latencyMs)),
+        };
+        return { metrics, daily };
+    }
+    /**
+     * Export to CSV for customer reporting
+     */
+    exportCSV() {
+        const header = 'timestamp,sessionId,requestId,decision,riskScore,estimatedCost,actualCost,policyTriggered,latencyMs\n';
+        const rows = this.logs.map(l => `${new Date(l.timestamp).toISOString()},${l.sessionId},${l.requestId},${l.decision},${l.riskScore.toFixed(3)},${l.estimatedCost.toFixed(4)},${l.actualCost?.toFixed(4) || ''},${l.policyTriggered || ''},${l.latencyMs.toFixed(2)}`).join('\n');
+        return header + rows;
+    }
+    /**
+     * Calculate simple 7-day ROI percentage
+     */
+    calculateROI() {
+        const { metrics } = this.get7DayReport();
+        if (metrics.actualSpend === 0) {
+            return metrics.estimatedSavings > 0 ? 100 : 0;
+        }
+        return ((metrics.estimatedSavings - metrics.actualSpend) / metrics.actualSpend) * 100;
+    }
+    /**
+     * Get summary for dashboard
+     */
+    getDashboardSummary() {
+        const today = new Date().toISOString().split('T')[0];
+        const todayLogs = this.logs.filter(l => new Date(l.timestamp).toISOString().startsWith(today));
+        const savingsToday = todayLogs
+            .filter(l => l.decision === 'block')
+            .reduce((sum, l) => sum + l.estimatedCost, 0);
+        const allMetrics = this.getMetrics();
+        return {
+            decisionsToday: todayLogs.length,
+            savingsToday,
+            totalSavings: allMetrics.netSavings,
+            roi7Day: this.calculateROI(),
+        };
+    }
+    calculateP95(values) {
+        if (values.length === 0)
+            return 0;
+        const sorted = [...values].sort((a, b) => a - b);
+        return sorted[Math.floor(sorted.length * 0.95)];
+    }
+    /**
+     * Reset (for testing)
+     */
+    reset() {
+        this.logs = [];
+        this.falsePositiveLog.clear();
+    }
+}
+exports.ROITelemetry = ROITelemetry;
+exports.roiTelemetry = new ROITelemetry();
+//# sourceMappingURL=ROITelemetry.js.map

package/dist/aecl/ROITelemetry.js.map

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

package/dist/aecl/RiskEngine.d.ts

@@ -0,0 +1,90 @@
+/**
+ * AECL - Risk Scoring Engine
+ *
+ * Computes probability (0-1) of:
+ * - Cost explosion
+ * - Infinite loop
+ * - Redundant tool calls
+ *
+ * REQUIREMENTS:
+ * - Deterministic (same input = same score)
+ * - Explainable (every factor documented)
+ * - <1ms execution time
+ * - No ML models in hot path
+ */
+export interface RiskFactors {
+    costExplosion: number;
+    infiniteLoop: number;
+    redundancy: number;
+    composite: number;
+}
+export interface RiskContext {
+    sessionId: string;
+    stepNumber: number;
+    recentCalls: string[];
+    tokenVelocity: number;
+    costVelocity: number;
+    errorRate: number;
+}
+export interface RiskAssessment {
+    score: number;
+    factors: RiskFactors;
+    explanation: string[];
+    confidence: number;
+}
+/**
+ * Risk Engine
+ *
+ * Uses deterministic heuristics, not ML:
+ * - Pattern matching for loops
+ * - Velocity thresholds for cost explosions
+ * - Hash deduplication for redundancy
+ */
+export declare class RiskEngine {
+    private loopPatterns;
+    private callHistory;
+    constructor();
+    /**
+     * Calculate risk score
+     * Must complete in <1ms
+     */
+    assess(context: RiskContext): RiskAssessment;
+    private calculateFactors;
+    /**
+     * Cost explosion detection
+     * Based on velocity and acceleration patterns
+     */
+    private assessCostExplosion;
+    /**
+     * Infinite loop detection
+     * Pattern: A→B→A→B or A→A→A
+     */
+    private assessInfiniteLoop;
+    /**
+     * Redundancy detection
+     * Same call within recent history
+     */
+    private assessRedundancy;
+    /**
+     * Composite score - max of all factors with weighting
+     */
+    private compositeScore;
+    /**
+     * Build human-readable explanation
+     */
+    private buildExplanation;
+    /**
+     * Confidence based on data quality
+     */
+    private calculateConfidence;
+    /**
+     * Update call history
+     */
+    private updateHistory;
+    /**
+     * Clear session data
+     */
+    clearSession(sessionId: string): void;
+}
+export declare const riskEngine: RiskEngine;
+//# sourceMappingURL=RiskEngine.d.ts.map

package/dist/aecl/RiskEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RiskEngine.d.ts","sourceRoot":"","sources":["../../src/aecl/RiskEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,WAAW,CAAwB;;IAO3C;;;OAGG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc;IAkB5C,OAAO,CAAC,gBAAgB;IASxB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB;;OAEG;IACH,OAAO,CAAC,cAAc;IAyBtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAItC;AAED,eAAO,MAAM,UAAU,YAAmB,CAAC"}

package/dist/aecl/RiskEngine.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * AECL - Risk Scoring Engine
+ *
+ * Computes probability (0-1) of:
+ * - Cost explosion
+ * - Infinite loop
+ * - Redundant tool calls
+ *
+ * REQUIREMENTS:
+ * - Deterministic (same input = same score)
+ * - Explainable (every factor documented)
+ * - <1ms execution time
+ * - No ML models in hot path
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.riskEngine = exports.RiskEngine = void 0;
+/**
+ * Risk Engine
+ *
+ * Uses deterministic heuristics, not ML:
+ * - Pattern matching for loops
+ * - Velocity thresholds for cost explosions
+ * - Hash deduplication for redundancy
+ */
+class RiskEngine {
+    constructor() {
+        this.loopPatterns = new Map();
+        this.callHistory = new Map();
+    }
+    /**
+     * Calculate risk score
+     * Must complete in <1ms
+     */
+    assess(context) {
+        const startTime = Date.now();
+        const factors = this.calculateFactors(context);
+        const composite = this.compositeScore(factors);
+        const explanation = this.buildExplanation(factors);
+        // Update history
+        this.updateHistory(context);
+        return {
+            score: composite,
+            factors,
+            explanation,
+            confidence: this.calculateConfidence(factors),
+        };
+    }
+    calculateFactors(context) {
+        return {
+            costExplosion: this.assessCostExplosion(context),
+            infiniteLoop: this.assessInfiniteLoop(context),
+            redundancy: this.assessRedundancy(context),
+            composite: 0, // Set later
+        };
+    }
+    /**
+     * Cost explosion detection
+     * Based on velocity and acceleration patterns
+     */
+    assessCostExplosion(context) {
+        const velocity = context.costVelocity;
+        // Thresholds (USD per minute)
+        if (velocity > 100)
+            return 1.0; // >$100/min = definite explosion
+        if (velocity > 50)
+            return 0.9; // >$50/min = high risk
+        if (velocity > 20)
+            return 0.7; // >$20/min = medium risk
+        if (velocity > 10)
+            return 0.4; // >$10/min = elevated
+        if (velocity > 5)
+            return 0.2; // >$5/min = slight concern
+        return 0.05; // Normal
+    }
+    /**
+     * Infinite loop detection
+     * Pattern: A→B→A→B or A→A→A
+     */
+    assessInfiniteLoop(context) {
+        const recent = context.recentCalls;
+        if (recent.length < 4)
+            return 0.05;
+        // Check for A-B-A-B pattern
+        const last4 = recent.slice(-4);
+        if (last4[0] === last4[2] && last4[1] === last4[3]) {
+            return 0.95; // Classic oscillation
+        }
+        // Check for A-A-A repetition
+        const last3 = recent.slice(-3);
+        if (last3[0] === last3[1] && last3[1] === last3[2]) {
+            return 0.9; // Exact repetition
+        }
+        // Check for increasing repetition frequency
+        const last10 = recent.slice(-10);
+        const unique = new Set(last10).size;
+        const ratio = unique / last10.length;
+        if (ratio < 0.3)
+            return 0.8; // 70% repetition
+        if (ratio < 0.5)
+            return 0.5; // 50% repetition
+        if (ratio < 0.7)
+            return 0.3; // 30% repetition
+        return 0.1;
+    }
+    /**
+     * Redundancy detection
+     * Same call within recent history
+     */
+    assessRedundancy(context) {
+        if (context.recentCalls.length < 2)
+            return 0;
+        const current = context.recentCalls[context.recentCalls.length - 1];
+        const previous = context.recentCalls.slice(0, -1);
+        // Check if this exact call happened recently
+        const duplicates = previous.filter(h => h === current).length;
+        if (duplicates >= 2)
+            return 0.9; // 3rd identical call
+        if (duplicates === 1)
+            return 0.6; // 2nd identical call
+        if (previous.includes(current))
+            return 0.3; // Seen before
+        return 0.05;
+    }
+    /**
+     * Composite score - max of all factors with weighting
+     */
+    compositeScore(factors) {
+        // Weighted combination
+        const weights = {
+            costExplosion: 0.4,
+            infiniteLoop: 0.35,
+            redundancy: 0.25,
+        };
+        const weighted = factors.costExplosion * weights.costExplosion +
+            factors.infiniteLoop * weights.infiniteLoop +
+            factors.redundancy * weights.redundancy;
+        // Boost if multiple factors are elevated
+        const elevatedCount = [
+            factors.costExplosion > 0.5,
+            factors.infiniteLoop > 0.5,
+            factors.redundancy > 0.5,
+        ].filter(Boolean).length;
+        const boost = elevatedCount >= 2 ? 0.15 : 0;
+        return Math.min(1.0, weighted + boost);
+    }
+    /**
+     * Build human-readable explanation
+     */
+    buildExplanation(factors) {
+        const reasons = [];
+        if (factors.costExplosion > 0.8) {
+            reasons.push(`CRITICAL: Cost velocity at $${factors.costExplosion}/min`);
+        }
+        else if (factors.costExplosion > 0.5) {
+            reasons.push(`WARNING: High cost velocity detected`);
+        }
+        if (factors.infiniteLoop > 0.8) {
+            reasons.push(`CRITICAL: Loop pattern detected in recent calls`);
+        }
+        else if (factors.infiniteLoop > 0.5) {
+            reasons.push(`WARNING: Repetitive call pattern`);
+        }
+        if (factors.redundancy > 0.7) {
+            reasons.push(`Redundant call: identical to recent execution`);
+        }
+        if (reasons.length === 0) {
+            reasons.push('No significant risk factors detected');
+        }
+        return reasons;
+    }
+    /**
+     * Confidence based on data quality
+     */
+    calculateConfidence(factors) {
+        // More history = higher confidence
+        const hasStrongSignal = factors.costExplosion > 0.8 ||
+            factors.infiniteLoop > 0.8 ||
+            factors.redundancy > 0.8;
+        return hasStrongSignal ? 0.95 : 0.75;
+    }
+    /**
+     * Update call history
+     */
+    updateHistory(context) {
+        const existing = this.callHistory.get(context.sessionId) || [];
+        const current = context.recentCalls[context.recentCalls.length - 1];
+        if (current) {
+            existing.push(current);
+            // Keep only last 20
+            if (existing.length > 20) {
+                existing.shift();
+            }
+            this.callHistory.set(context.sessionId, existing);
+        }
+    }
+    /**
+     * Clear session data
+     */
+    clearSession(sessionId) {
+        this.callHistory.delete(sessionId);
+        this.loopPatterns.delete(sessionId);
+    }
+}
+exports.RiskEngine = RiskEngine;
+exports.riskEngine = new RiskEngine();
+//# sourceMappingURL=RiskEngine.js.map

package/dist/aecl/RiskEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RiskEngine.js","sourceRoot":"","sources":["../../src/aecl/RiskEngine.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAyBH;;;;;;;GAOG;AACH,MAAa,UAAU;IAIrB;QACE,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAoB;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAEnD,iBAAiB;QACjB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAE5B,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,OAAO;YACP,WAAW;YACX,UAAU,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;SAC9C,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,OAAoB;QAC3C,OAAO;YACL,aAAa,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;YAChD,YAAY,EAAE,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC;YAC9C,UAAU,EAAE,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;YAC1C,SAAS,EAAE,CAAC,EAAE,YAAY;SAC3B,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,mBAAmB,CAAC,OAAoB;QAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;QAEtC,8BAA8B;QAC9B,IAAI,QAAQ,GAAG,GAAG;YAAE,OAAO,GAAG,CAAC,CAAE,iCAAiC;QAClE,IAAI,QAAQ,GAAG,EAAE;YAAE,OAAO,GAAG,CAAC,CAAG,uBAAuB;QACxD,IAAI,QAAQ,GAAG,EAAE;YAAE,OAAO,GAAG,CAAC,CAAE,yBAAyB;QACzD,IAAI,QAAQ,GAAG,EAAE;YAAE,OAAO,GAAG,CAAC,CAAE,sBAAsB;QACtD,IAAI,QAAQ,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,CAAG,2BAA2B;QAE3D,OAAO,IAAI,CAAC,CAAC,SAAS;IACxB,CAAC;IAED;;;OAGG;IACK,kBAAkB,CAAC,OAAoB;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;QACnC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAEnC,4BAA4B;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC,CAAC,sBAAsB;QACrC,CAAC;QAED,6BAA6B;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,OAAO,GAAG,CAAC,CAAC,mBAAmB;QACjC,CAAC;QAED,4CAA4C;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAErC,IAAI,KAAK,GAAG,GAAG;YAAE,OAAO,GAAG,CAAC,CAAE,iBAAiB;QAC/C,IAAI,KAAK,GAAG,GAAG;YAAE,OAAO,GAAG,CAAC,CAAE,iBAAiB;QAC/C,IAAI,KAAK,GAAG,GAAG;YAAE,OAAO,GAAG,CAAC,CAAE,iBAAiB;QAE/C,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;OAGG;IACK,gBAAgB,CAAC,OAAoB;QAC3C,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,CAAC,CAAC;QAE7C,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAElD,6CAA6C;QAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;QAE9D,IAAI,UAAU,IAAI,CAAC;YAAE,OAAO,GAAG,CAAC,CAAE,qBAAqB;QACvD,IAAI,UAAU,KAAK,CAAC;YAAE,OAAO,GAAG,CAAC,CAAC,qBAAqB;QACvD,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,GAAG,CAAC,CAAC,cAAc;QAE1D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,OAAoB;QACzC,uBAAuB;QACvB,MAAM,OAAO,GAAG;YACd,aAAa,EAAE,GAAG;YAClB,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,IAAI;SACjB,CAAC;QAEF,MAAM,QAAQ,GACZ,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa;YAC7C,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY;YAC3C,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAE1C,yCAAyC;QACzC,MAAM,aAAa,GAAG;YACpB,OAAO,CAAC,aAAa,GAAG,GAAG;YAC3B,OAAO,CAAC,YAAY,GAAG,GAAG;YAC1B,OAAO,CAAC,UAAU,GAAG,GAAG;SACzB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;QAEzB,MAAM,KAAK,GAAG,aAAa,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAE5C,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,GAAG,KAAK,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAoB;QAC3C,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,IAAI,OAAO,CAAC,aAAa,GAAG,GAAG,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,+BAA+B,OAAO,CAAC,aAAa,MAAM,CAAC,CAAC;QAC3E,CAAC;aAAM,IAAI,OAAO,CAAC,aAAa,GAAG,GAAG,EAAE,CAAC;YACvC,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,OAAO,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAClE,CAAC;aAAM,IAAI,OAAO,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,OAAO,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,OAAoB;QAC9C,mCAAmC;QACnC,MAAM,eAAe,GACnB,OAAO,CAAC,aAAa,GAAG,GAAG;YAC3B,OAAO,CAAC,YAAY,GAAG,GAAG;YAC1B,OAAO,CAAC,UAAU,GAAG,GAAG,CAAC;QAE3B,OAAO,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,OAAoB;QACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QAC/D,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEpE,IAAI,OAAO,EAAE,CAAC;YACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,oBAAoB;YACpB,IAAI,QAAQ,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;gBACzB,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAiB;QAC5B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;CACF;AA3MD,gCA2MC;AAEY,QAAA,UAAU,GAAG,IAAI,UAAU,EAAE,CAAC"}

package/dist/aecl/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * AECL - AI Execution Control Layer
+ * Production-grade execution interception
+ *
+ * CORE MODULES:
+ * - ExecutionInterceptor: <5ms decision engine
+ * - RiskEngine: 0-1 risk scoring
+ * - PolicyEngine: simple rule evaluation
+ * - ExecutionMemory: hashed trace storage
+ * - ROITelemetry: cost savings tracking
+ *
+ * USAGE:
+ * ```typescript
+ * import { aecl } from 'ai-execution-control/aecl';
+ *
+ * const result = aecl.intercept({
+ *   id: 'req-1',
+ *   provider: 'openai',
+ *   operation: 'chat.completions.create',
+ *   estimatedTokens: 2000,
+ *   estimatedCost: 0.06,
+ *   context: {
+ *     sessionId: 'sess-1',
+ *     agentId: 'agent-1',
+ *     stepNumber: 5,
+ *     previousCalls: 4,
+ *     totalTokens: 8000,
+ *     totalCost: 0.24,
+ *     startTime: Date.now(),
+ *   },
+ *   inputHash: 'hash-of-prompt',
+ * });
+ *
+ * if (result.decision === 'block') {
+ *   console.log('Blocked:', result.reason);
+ *   console.log('Saved: $', result.estimatedSavings);
+ * }
+ * ```
+ */
+export { ExecutionInterceptor, interceptor } from './ExecutionInterceptor';
+export { RiskEngine, riskEngine } from './RiskEngine';
+export { PolicyEngine, policyEngine } from './PolicyEngine';
+export { ExecutionMemory, executionMemory } from './ExecutionMemory';
+export { ROITelemetry, roiTelemetry } from './ROITelemetry';
+export interface AECLConfig {
+    failOpen?: boolean;
+    maxLatencyMs?: number;
+    maxCostPerSession?: number;
+    maxStepsPerSession?: number;
+    maxCostPerRequest?: number;
+}
+/**
+ * Unified AECL interface
+ */
+export declare class AECL {
+    private interceptor;
+    private riskEngine;
+    private policyEngine;
+    private memory;
+    private telemetry;
+    intercept: (request: any) => any;
+    assessRisk: (input: any) => any;
+    evaluatePolicy: (context: any, action: any, cost: any) => any;
+    checkDuplicate: (sessionId: string, inputHash: string, operation: string) => any;
+    logDecision: (decision: any) => void;
+    getROI: () => any;
+    getDashboard: () => any;
+    exportCSV: () => string;
+    constructor(config?: AECLConfig);
+    /**
+     * Record execution trace
+     */
+    recordExecution(sessionId: string, trace: any): void;
+}
+export declare const aecl: AECL;
+//# sourceMappingURL=index.d.ts.map

package/dist/aecl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/aecl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAS5D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,IAAI;IACf,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAe;IAGhC,SAAS,EAAE,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,CAAC;IACjC,UAAU,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAC;IAChC,cAAc,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC;IAC9D,cAAc,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,GAAG,CAAC;IACjF,WAAW,EAAE,CAAC,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;IACrC,MAAM,EAAE,MAAM,GAAG,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,CAAC;IACxB,SAAS,EAAE,MAAM,MAAM,CAAC;gBAEZ,MAAM,GAAE,UAAe;IA2BnC;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;CAY9C;AAGD,eAAO,MAAM,IAAI,MAAa,CAAC"}