@salimassili/ai-costguard 1.1.3

package/dist/aecl/ExecutionMemory.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * AECL - Execution Memory Layer
+ *
+ * Stores ONLY:
+ * - Hashed execution traces (no raw prompts)
+ * - Cost metrics per session
+ * - Loop signatures for deduplication
+ *
+ * DESIGN:
+ * - In-memory with optional persistence
+ * - Automatic TTL eviction (1 hour default)
+ * - Fixed memory budget (no unbounded growth)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executionMemory = exports.ExecutionMemory = void 0;
+const crypto_1 = require("crypto");
+/**
+ * Execution Memory
+ *
+ * In-memory storage with TTL eviction.
+ * No raw data stored - only hashes and metrics.
+ */
+class ExecutionMemory {
+    constructor(config) {
+        this.sessions = new Map();
+        this.maxSessions = config?.maxSessions || 10000;
+        this.ttlMs = (config?.ttlMinutes || 60) * 60 * 1000;
+        this.maxTracesPerSession = config?.maxTracesPerSession || 100;
+        // Start cleanup interval
+        setInterval(() => this.cleanup(), 60000); // Every minute
+    }
+    /**
+     * Record execution trace
+     */
+    record(trace) {
+        let session = this.sessions.get(trace.sessionId);
+        if (!session) {
+            // Check if we need to evict
+            if (this.sessions.size >= this.maxSessions) {
+                this.evictOldest();
+            }
+            session = {
+                sessionId: trace.sessionId,
+                startTime: trace.timestamp,
+                traces: [],
+                totalCost: 0,
+                totalTokens: 0,
+                stepCount: 0,
+                lastActivity: trace.timestamp,
+            };
+            this.sessions.set(trace.sessionId, session);
+        }
+        // Add trace
+        session.traces.push(trace);
+        session.totalCost += trace.cost;
+        session.totalTokens += trace.tokens;
+        session.stepCount++;
+        session.lastActivity = trace.timestamp;
+        // Limit trace history
+        if (session.traces.length > this.maxTracesPerSession) {
+            session.traces.shift();
+        }
+    }
+    /**
+     * Check for deduplication
+     * Returns count of similar traces in session
+     */
+    checkDeduplication(sessionId, inputHash, operation) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return { isDuplicate: false, previousOccurrences: 0, similarTraces: [] };
+        }
+        const matches = session.traces.filter(t => t.inputHash === inputHash && t.operation === operation);
+        return {
+            isDuplicate: matches.length > 0,
+            previousOccurrences: matches.length,
+            similarTraces: matches.slice(-5), // Last 5 matches
+        };
+    }
+    /**
+     * Get session metrics
+     */
+    getSession(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /**
+     * Get all session IDs
+     */
+    getSessionIds() {
+        return Array.from(this.sessions.keys());
+    }
+    /**
+     * Clear session (on completion or error)
+     */
+    clearSession(sessionId) {
+        this.sessions.delete(sessionId);
+    }
+    /**
+     * Get global stats
+     */
+    getStats() {
+        let totalTraces = 0;
+        let totalCost = 0;
+        for (const session of this.sessions.values()) {
+            totalTraces += session.traces.length;
+            totalCost += session.totalCost;
+        }
+        const sessionCount = this.sessions.size;
+        return {
+            activeSessions: sessionCount,
+            totalTraces,
+            totalCost,
+            avgTracesPerSession: sessionCount > 0 ? totalTraces / sessionCount : 0,
+        };
+    }
+    /**
+     * Hash content (for input/output hashing)
+     */
+    hashContent(content) {
+        return (0, crypto_1.createHash)('sha256').update(content).digest('hex').substring(0, 32);
+    }
+    /**
+     * Cleanup expired sessions
+     */
+    cleanup() {
+        const now = Date.now();
+        const expired = [];
+        for (const [sessionId, session] of this.sessions) {
+            if (now - session.lastActivity > this.ttlMs) {
+                expired.push(sessionId);
+            }
+        }
+        for (const sessionId of expired) {
+            this.sessions.delete(sessionId);
+        }
+        if (expired.length > 0) {
+            console.log(`[AECL] Cleaned up ${expired.length} expired sessions`);
+        }
+    }
+    /**
+     * Evict oldest session when at capacity
+     */
+    evictOldest() {
+        let oldest = null;
+        for (const [sessionId, session] of this.sessions) {
+            if (!oldest || session.lastActivity < oldest.time) {
+                oldest = { id: sessionId, time: session.lastActivity };
+            }
+        }
+        if (oldest) {
+            this.sessions.delete(oldest.id);
+        }
+    }
+    /**
+     * Reset (for testing)
+     */
+    reset() {
+        this.sessions.clear();
+    }
+}
+exports.ExecutionMemory = ExecutionMemory;
+exports.executionMemory = new ExecutionMemory();
+//# sourceMappingURL=ExecutionMemory.js.map

package/dist/aecl/ExecutionMemory.js.map

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

package/dist/aecl/PolicyEngine.d.ts

@@ -0,0 +1,77 @@
+/**
+ * AECL - Policy Engine
+ *
+ * Minimal, deterministic rule system:
+ * - Cost thresholds
+ * - Repetition thresholds
+ * - Depth/step limits
+ *
+ * NO:
+ * - Enterprise policy platform
+ * - Marketplace
+ * - Complex hierarchies
+ * - User management
+ *
+ * YES:
+ * - Simple JSON rules
+ * - Fast evaluation (<1ms)
+ * - Clear explainability
+ */
+export interface PolicyRule {
+    name: string;
+    condition: 'cost' | 'repetition' | 'depth';
+    operator: 'gt' | 'gte' | 'eq';
+    threshold: number;
+    action: 'allow' | 'block';
+    severity: 'low' | 'medium' | 'high' | 'critical';
+}
+export interface PolicySet {
+    id: string;
+    name: string;
+    rules: PolicyRule[];
+    defaultAction: 'allow' | 'block';
+}
+export interface PolicyContext {
+    sessionCost: number;
+    sessionSteps: number;
+    requestCost: number;
+    repetitionCount: number;
+    timestamp: number;
+}
+export interface PolicyResult {
+    action: 'allow' | 'block';
+    triggeredRule?: PolicyRule;
+    reason: string;
+    explanation: string;
+}
+/**
+ * Minimal Policy Engine
+ *
+ * Default policy set for immediate use:
+ * - Session cost limit: $10
+ * - Step limit: 50
+ * - Request cost limit: $5
+ * - Repetition limit: 3 identical calls
+ */
+export declare class PolicyEngine {
+    private policies;
+    private defaultPolicy;
+    constructor();
+    /**
+     * Evaluate context against policy
+     * Returns in <1ms
+     */
+    evaluate(context: PolicyContext, policyId?: string): PolicyResult;
+    private checkRule;
+    private buildExplanation;
+    /**
+     * Add custom policy (rarely needed)
+     */
+    addPolicy(policy: PolicySet): void;
+    /**
+     * Get default policy for reference
+     */
+    getDefaultPolicy(): PolicySet;
+}
+export declare const policyEngine: PolicyEngine;
+//# sourceMappingURL=PolicyEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PolicyEngine.d.ts","sourceRoot":"","sources":["../../src/aecl/PolicyEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC;IAC3C,QAAQ,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;CAClD;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,aAAa,EAAE,OAAO,GAAG,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,aAAa,CAAY;;IA+CjC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY;IA+BjE,OAAO,CAAC,SAAS;IA6BjB,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIlC;;OAEG;IACH,gBAAgB,IAAI,SAAS;CAG9B;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/dist/aecl/PolicyEngine.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * AECL - Policy Engine
+ *
+ * Minimal, deterministic rule system:
+ * - Cost thresholds
+ * - Repetition thresholds
+ * - Depth/step limits
+ *
+ * NO:
+ * - Enterprise policy platform
+ * - Marketplace
+ * - Complex hierarchies
+ * - User management
+ *
+ * YES:
+ * - Simple JSON rules
+ * - Fast evaluation (<1ms)
+ * - Clear explainability
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.policyEngine = exports.PolicyEngine = void 0;
+/**
+ * Minimal Policy Engine
+ *
+ * Default policy set for immediate use:
+ * - Session cost limit: $10
+ * - Step limit: 50
+ * - Request cost limit: $5
+ * - Repetition limit: 3 identical calls
+ */
+class PolicyEngine {
+    constructor() {
+        this.policies = new Map();
+        // Minimal default policy - covers 90% of cost explosions
+        this.defaultPolicy = {
+            id: 'default',
+            name: 'Default Protection',
+            rules: [
+                {
+                    name: 'session_cost_limit',
+                    condition: 'cost',
+                    operator: 'gt',
+                    threshold: 10, // $10 per session
+                    action: 'block',
+                    severity: 'critical',
+                },
+                {
+                    name: 'step_limit',
+                    condition: 'depth',
+                    operator: 'gte',
+                    threshold: 50, // 50 steps max
+                    action: 'block',
+                    severity: 'high',
+                },
+                {
+                    name: 'request_cost_limit',
+                    condition: 'cost',
+                    operator: 'gt',
+                    threshold: 5, // $5 per request
+                    action: 'block',
+                    severity: 'high',
+                },
+                {
+                    name: 'repetition_limit',
+                    condition: 'repetition',
+                    operator: 'gte',
+                    threshold: 3, // 3 identical calls
+                    action: 'block',
+                    severity: 'medium',
+                },
+            ],
+            defaultAction: 'allow',
+        };
+    }
+    /**
+     * Evaluate context against policy
+     * Returns in <1ms
+     */
+    evaluate(context, policyId) {
+        const policy = policyId ? this.policies.get(policyId) : this.defaultPolicy;
+        if (!policy) {
+            return {
+                action: 'allow',
+                reason: 'No policy found',
+                explanation: 'Defaulting to allow',
+            };
+        }
+        for (const rule of policy.rules) {
+            const triggered = this.checkRule(rule, context);
+            if (triggered) {
+                return {
+                    action: rule.action,
+                    triggeredRule: rule,
+                    reason: `Policy triggered: ${rule.name}`,
+                    explanation: this.buildExplanation(rule, context),
+                };
+            }
+        }
+        return {
+            action: policy.defaultAction,
+            reason: 'No rules triggered',
+            explanation: `All ${policy.rules.length} rules passed`,
+        };
+    }
+    checkRule(rule, context) {
+        let value;
+        switch (rule.condition) {
+            case 'cost':
+                value = context.requestCost + context.sessionCost;
+                break;
+            case 'depth':
+                value = context.sessionSteps;
+                break;
+            case 'repetition':
+                value = context.repetitionCount;
+                break;
+            default:
+                return false;
+        }
+        switch (rule.operator) {
+            case 'gt':
+                return value > rule.threshold;
+            case 'gte':
+                return value >= rule.threshold;
+            case 'eq':
+                return value === rule.threshold;
+            default:
+                return false;
+        }
+    }
+    buildExplanation(rule, context) {
+        let value;
+        let metric;
+        switch (rule.condition) {
+            case 'cost':
+                value = context.requestCost + context.sessionCost;
+                metric = 'session cost';
+                break;
+            case 'depth':
+                value = context.sessionSteps;
+                metric = 'step count';
+                break;
+            case 'repetition':
+                value = context.repetitionCount;
+                metric = 'repetitions';
+                break;
+            default:
+                return 'Unknown rule condition';
+        }
+        const operatorText = rule.operator === 'gt' ? '>' :
+            rule.operator === 'gte' ? '>=' : '=';
+        return `${metric}: ${value} ${operatorText} ${rule.threshold} (threshold)`;
+    }
+    /**
+     * Add custom policy (rarely needed)
+     */
+    addPolicy(policy) {
+        this.policies.set(policy.id, policy);
+    }
+    /**
+     * Get default policy for reference
+     */
+    getDefaultPolicy() {
+        return this.defaultPolicy;
+    }
+}
+exports.PolicyEngine = PolicyEngine;
+exports.policyEngine = new PolicyEngine();
+//# sourceMappingURL=PolicyEngine.js.map

package/dist/aecl/PolicyEngine.js.map

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

package/dist/aecl/ROITelemetry.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 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
+ */
+export interface DecisionLog {
+    timestamp: number;
+    sessionId: string;
+    requestId: string;
+    decision: 'allow' | 'block';
+    riskScore: number;
+    estimatedCost: number;
+    actualCost?: number;
+    policyTriggered?: string;
+    reason: string;
+    latencyMs: number;
+}
+export interface ROIMetrics {
+    totalDecisions: number;
+    blockedCount: number;
+    allowCount: number;
+    estimatedSavings: number;
+    actualSpend: number;
+    falsePositives: number;
+    falsePositiveCost: number;
+    netSavings: number;
+    avgDecisionLatencyMs: number;
+    p95DecisionLatencyMs: number;
+}
+export interface DailyReport {
+    date: string;
+    decisions: number;
+    blocked: number;
+    savings: number;
+    spend: number;
+    roi: number;
+}
+/**
+ * ROI Telemetry
+ *
+ * Simple, accurate tracking for customer billing.
+ * Focus: Show measurable cost savings in first 7 days.
+ */
+export declare class ROITelemetry {
+    private logs;
+    private maxLogs;
+    private falsePositiveLog;
+    constructor(maxLogs?: number);
+    /**
+     * Log a decision
+     */
+    log(decision: DecisionLog): void;
+    /**
+     * Mark a blocked decision as false positive
+     * (User overrode the block)
+     */
+    markFalsePositive(requestId: string, actualCost: number): void;
+    /**
+     * Update actual cost for allowed execution
+     */
+    recordActualCost(requestId: string, actualCost: number): void;
+    /**
+     * Get ROI metrics (all time)
+     */
+    getMetrics(): ROIMetrics;
+    /**
+     * Get 7-day ROI report
+     */
+    get7DayReport(): {
+        metrics: ROIMetrics;
+        daily: DailyReport[];
+    };
+    /**
+     * Export to CSV for customer reporting
+     */
+    exportCSV(): string;
+    /**
+     * Calculate simple 7-day ROI percentage
+     */
+    calculateROI(): number;
+    /**
+     * Get summary for dashboard
+     */
+    getDashboardSummary(): {
+        decisionsToday: number;
+        savingsToday: number;
+        totalSavings: number;
+        roi7Day: number;
+    };
+    private calculateP95;
+    /**
+     * Reset (for testing)
+     */
+    reset(): void;
+}
+export declare const roiTelemetry: ROITelemetry;
+//# sourceMappingURL=ROITelemetry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ROITelemetry.d.ts","sourceRoot":"","sources":["../../src/aecl/ROITelemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAc;gBAE1B,OAAO,GAAE,MAAe;IAMpC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAShC;;;OAGG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAU9D;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAO7D;;OAEG;IACH,UAAU,IAAI,UAAU;IAmCxB;;OAEG;IACH,aAAa,IAAI;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,WAAW,EAAE,CAAA;KAAE;IAuE9D;;OAEG;IACH,SAAS,IAAI,MAAM;IAUnB;;OAEG;IACH,YAAY,IAAI,MAAM;IAUtB;;OAEG;IACH,mBAAmB,IAAI;QACrB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;KACjB;IAoBD,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED,eAAO,MAAM,YAAY,cAAqB,CAAC"}