@salimassili/ai-costguard 1.1.3

package/dist/loop-shield.js

@@ -0,0 +1,436 @@
+"use strict";
+/**
+ * LoopShield
+ *
+ * Detects and stops semantic loop explosions in AI agents BEFORE cost escalates.
+ *
+ * ONE PURPOSE: Prevent the $3,000–$10,000 overnight runaway agent bill.
+ *
+ * DETECTS: Semantic loops (same intent, different phrasing, converging actions)
+ * NOT: Generic cost limits, step counting, or naive duplicate detection.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initLoopShield = initLoopShield;
+exports.shield = shield;
+exports.checkLoop = checkLoop;
+const perf_hooks_1 = require("perf_hooks");
+// ═══════════════════════════════════════════════════════════════════════════════
+// COMPONENT 1: SEMANTIC EMBEDDING CACHE (simulated for <5ms)
+// ═══════════════════════════════════════════════════════════════════════════════
+/**
+ * Simulates semantic embeddings using character n-gram frequency vectors.
+ * Fast, deterministic, no external dependencies.
+ */
+class SemanticEmbeddingCache {
+    constructor() {
+        this.cache = new Map();
+        this.maxCacheSize = 1000;
+    }
+    /**
+     * Generate simplified embedding (character trigram histogram)
+     * Runs in <0.5ms for typical inputs
+     */
+    embed(text) {
+        const cached = this.cache.get(text);
+        if (cached)
+            return cached;
+        // Character trigram frequency vector (simplified but effective)
+        const vector = new Array(256).fill(0);
+        const normalized = text.toLowerCase().replace(/[^a-z0-9\s]/g, '');
+        for (let i = 0; i < normalized.length - 2; i++) {
+            const tri = normalized.substring(i, i + 3);
+            const hash = this.hashTrigram(tri);
+            vector[hash]++;
+        }
+        // Normalize to unit vector
+        const magnitude = Math.sqrt(vector.reduce((sum, v) => sum + v * v, 0));
+        const normalizedVector = magnitude > 0 ? vector.map(v => v / magnitude) : vector;
+        // Cache if room
+        if (this.cache.size < this.maxCacheSize) {
+            this.cache.set(text, normalizedVector);
+        }
+        return normalizedVector;
+    }
+    hashTrigram(tri) {
+        let hash = 0;
+        for (let i = 0; i < tri.length; i++) {
+            hash = ((hash << 5) - hash) + tri.charCodeAt(i);
+            hash = hash & hash; // Convert to 32bit integer
+        }
+        return Math.abs(hash) % 256;
+    }
+    cosineSimilarity(a, b) {
+        let dot = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dot += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        return dot / (Math.sqrt(normA) * Math.sqrt(normB) + 1e-10);
+    }
+}
+class SemanticLoopDetectionEngine {
+    constructor(config = {}) {
+        this.sessions = new Map();
+        this.embeddings = new SemanticEmbeddingCache();
+        this.config = {
+            loopProbabilityThreshold: 0.75,
+            explosionRiskThreshold: 0.85,
+            maxSessionCost: 50,
+            failOpen: true,
+            ...config,
+        };
+        // Cleanup old sessions every minute
+        setInterval(() => this.cleanup(), 60000);
+    }
+    detect(sessionId, action) {
+        const start = perf_hooks_1.performance.now();
+        try {
+            // Get or create session
+            let session = this.sessions.get(sessionId);
+            if (!session) {
+                session = {
+                    actions: [],
+                    totalCost: 0,
+                    startTime: Date.now(),
+                    lastActivity: Date.now(),
+                };
+                this.sessions.set(sessionId, session);
+            }
+            // Generate embedding for this action
+            action.inputEmbedding = this.embeddings.embed(action.input);
+            // DETECTION SIGNALS
+            const signals = this.analyzeSignals(session, action);
+            // Calculate loop probability (weighted ensemble)
+            const loopProbability = this.calculateLoopProbability(signals);
+            // Calculate explosion risk (time + cost velocity)
+            const explosionRisk = this.calculateExplosionRisk(session, action, signals);
+            // Calculate avoidable cost
+            const estimatedAvoidableCost = this.calculateAvoidableCost(session, loopProbability);
+            // Build explanation
+            const explanation = this.buildExplanation(signals, loopProbability, explosionRisk, estimatedAvoidableCost);
+            // Decision
+            const blocked = loopProbability > this.config.loopProbabilityThreshold ||
+                explosionRisk > this.config.explosionRiskThreshold ||
+                (session.totalCost + action.estimatedCost > this.config.maxSessionCost);
+            // Record action if not blocked
+            if (!blocked) {
+                session.actions.push(action);
+                session.totalCost += action.estimatedCost;
+                session.lastActivity = Date.now();
+            }
+            return {
+                blocked,
+                loopProbability,
+                explosionRiskScore: explosionRisk,
+                estimatedAvoidableCost,
+                explanation,
+                detectedPatterns: signals.triggeredPatterns,
+                latencyMs: perf_hooks_1.performance.now() - start,
+            };
+        }
+        catch (error) {
+            return {
+                blocked: this.config.failOpen ? false : true,
+                loopProbability: 0,
+                explosionRiskScore: 0,
+                estimatedAvoidableCost: 0,
+                explanation: `Detection error: ${error instanceof Error ? error.message : 'unknown'}`,
+                detectedPatterns: [],
+                latencyMs: perf_hooks_1.performance.now() - start,
+            };
+        }
+    }
+    /**
+     * Analyze 5 required signals:
+     * 1. Embedding similarity between consecutive actions
+     * 2. Intent drift score (convergence detection)
+     * 3. Tool-call repetition graph
+     * 4. Entropy reduction over time
+     * 5. Cost velocity acceleration
+     */
+    analyzeSignals(session, currentAction) {
+        const recentActions = session.actions.slice(-10); // Look at last 10
+        const triggeredPatterns = [];
+        // SIGNAL 1: Embedding Similarity
+        let embeddingSimilarity = 0;
+        if (recentActions.length > 0 && currentAction.inputEmbedding) {
+            for (const prev of recentActions.slice(-3)) { // Compare with last 3
+                if (prev.inputEmbedding) {
+                    const sim = this.embeddings.cosineSimilarity(currentAction.inputEmbedding, prev.inputEmbedding);
+                    embeddingSimilarity = Math.max(embeddingSimilarity, sim);
+                }
+            }
+        }
+        if (embeddingSimilarity > 0.85)
+            triggeredPatterns.push('high_embedding_similarity');
+        // SIGNAL 2: Intent Convergence Score
+        // Check if we're converging to same solution repeatedly
+        let intentConvergenceScore = 0;
+        if (recentActions.length >= 3) {
+            const last3 = recentActions.slice(-3);
+            const similarities = [];
+            for (let i = 0; i < last3.length - 1; i++) {
+                if (last3[i].inputEmbedding && last3[i + 1].inputEmbedding) {
+                    similarities.push(this.embeddings.cosineSimilarity(last3[i].inputEmbedding, last3[i + 1].inputEmbedding));
+                }
+            }
+            // High similarity AND stable = convergence
+            const avgSim = similarities.length > 0
+                ? similarities.reduce((a, b) => a + b, 0) / similarities.length
+                : 0;
+            const variance = similarities.length > 1
+                ? similarities.reduce((sum, s) => sum + Math.pow(s - avgSim, 2), 0) / similarities.length
+                : 1;
+            // High similarity with low variance = stuck in converging loop
+            intentConvergenceScore = avgSim * (1 - Math.min(1, variance * 3));
+        }
+        if (intentConvergenceScore > 0.8)
+            triggeredPatterns.push('intent_convergence');
+        // SIGNAL 3: Tool Repetition Score
+        let toolRepetitionScore = 0;
+        const currentTool = currentAction.toolName || currentAction.operation;
+        const recentTools = recentActions.map(a => a.toolName || a.operation);
+        const toolCounts = new Map();
+        for (const tool of recentTools) {
+            toolCounts.set(tool, (toolCounts.get(tool) || 0) + 1);
+        }
+        const currentCount = toolCounts.get(currentTool) || 0;
+        if (currentCount >= 2) {
+            toolRepetitionScore = Math.min(1, currentCount / 5);
+            triggeredPatterns.push('repeated_tool_calls');
+        }
+        // SIGNAL 4: Entropy Reduction
+        // Measure if action variety is decreasing (agent getting stuck)
+        let entropyReduction = 0;
+        if (session.actions.length >= 5) {
+            const firstHalf = session.actions.slice(0, Math.floor(session.actions.length / 2));
+            const secondHalf = session.actions.slice(Math.floor(session.actions.length / 2));
+            // Calculate "operation diversity" in each half
+            const firstOps = new Set(firstHalf.map(a => a.operation)).size;
+            const secondOps = new Set(secondHalf.map(a => a.operation)).size;
+            // If second half has fewer unique operations = entropy reduction
+            if (firstOps > 0) {
+                entropyReduction = Math.max(0, (firstOps - secondOps) / firstOps);
+            }
+        }
+        if (entropyReduction > 0.5)
+            triggeredPatterns.push('entropy_reduction');
+        // SIGNAL 5: Cost Velocity Acceleration
+        // Detect if spending is accelerating (runaway signal)
+        let costVelocityAcceleration = 0;
+        if (recentActions.length >= 3) {
+            const costs = recentActions.map(a => a.estimatedCost);
+            const diffs = [];
+            for (let i = 1; i < costs.length; i++) {
+                diffs.push(costs[i] - costs[i - 1]);
+            }
+            // If recent diffs are increasing = acceleration
+            if (diffs.length >= 2) {
+                const earlyAvg = diffs.slice(0, Math.floor(diffs.length / 2)).reduce((a, b) => a + b, 0)
+                    / Math.floor(diffs.length / 2);
+                const lateAvg = diffs.slice(Math.floor(diffs.length / 2)).reduce((a, b) => a + b, 0)
+                    / Math.ceil(diffs.length / 2);
+                if (earlyAvg !== 0) {
+                    costVelocityAcceleration = Math.max(0, (lateAvg - earlyAvg) / Math.abs(earlyAvg));
+                }
+            }
+        }
+        if (costVelocityAcceleration > 1.0)
+            triggeredPatterns.push('cost_acceleration');
+        return {
+            embeddingSimilarity,
+            intentConvergenceScore,
+            toolRepetitionScore,
+            entropyReduction,
+            costVelocityAcceleration,
+            triggeredPatterns,
+        };
+    }
+    calculateLoopProbability(signals) {
+        // Weighted ensemble of signals
+        const weights = {
+            embedding: 0.30,
+            intent: 0.25,
+            tool: 0.20,
+            entropy: 0.15,
+            velocity: 0.10,
+        };
+        let score = signals.embeddingSimilarity * weights.embedding +
+            signals.intentConvergenceScore * weights.intent +
+            signals.toolRepetitionScore * weights.tool +
+            signals.entropyReduction * weights.entropy +
+            Math.min(1, signals.costVelocityAcceleration) * weights.velocity;
+        // Boost if multiple signals are high (ensemble effect)
+        const highSignals = [
+            signals.embeddingSimilarity > 0.8,
+            signals.intentConvergenceScore > 0.7,
+            signals.toolRepetitionScore > 0.6,
+            signals.entropyReduction > 0.5,
+        ].filter(Boolean).length;
+        if (highSignals >= 3)
+            score += 0.15;
+        if (highSignals >= 4)
+            score += 0.10;
+        return Math.min(1, score);
+    }
+    calculateExplosionRisk(session, action, signals) {
+        // Time-based risk: longer sessions = higher risk
+        const sessionDuration = Date.now() - session.startTime;
+        const timeRisk = Math.min(1, sessionDuration / (60 * 60 * 1000)); // 1 hour = max risk
+        // Cost velocity risk
+        const recentCost = session.actions.slice(-5).reduce((sum, a) => sum + a.estimatedCost, 0);
+        const costVelocity = recentCost / 5; // avg per recent action
+        const costRisk = Math.min(1, costVelocity / 0.5); // $0.50 per call = high
+        // Loop + high cost = explosion risk
+        const loopRisk = signals.embeddingSimilarity > 0.8 && signals.intentConvergenceScore > 0.7 ? 0.8 : 0;
+        return Math.min(1, (timeRisk * 0.3 + costRisk * 0.3 + loopRisk * 0.4));
+    }
+    calculateAvoidableCost(session, loopProbability) {
+        // If we don't stop now, what's the projected cost?
+        if (loopProbability < 0.5)
+            return 0;
+        const recentCost = session.actions.slice(-3).reduce((sum, a) => sum + a.estimatedCost, 0);
+        const avgCost = recentCost / 3;
+        // Project: if loop continues for 50 more iterations
+        const projectedIterations = Math.floor((1 - loopProbability) * 50) + 10;
+        return avgCost * projectedIterations;
+    }
+    buildExplanation(signals, loopProb, explosionRisk, avoidableCost) {
+        const parts = [];
+        if (signals.triggeredPatterns.includes('high_embedding_similarity')) {
+            parts.push('Input is semantically similar to recent actions');
+        }
+        if (signals.triggeredPatterns.includes('intent_convergence')) {
+            parts.push('Agent appears stuck converging on same solution');
+        }
+        if (signals.triggeredPatterns.includes('repeated_tool_calls')) {
+            parts.push('Same tools being called repeatedly');
+        }
+        if (signals.triggeredPatterns.includes('entropy_reduction')) {
+            parts.push('Action variety decreasing (getting stuck)');
+        }
+        if (signals.triggeredPatterns.includes('cost_acceleration')) {
+            parts.push('Cost per action is accelerating');
+        }
+        let explanation = parts.length > 0
+            ? `Loop detected: ${parts.join('; ')}.`
+            : 'No loop patterns detected.';
+        explanation += ` Loop probability: ${(loopProb * 100).toFixed(0)}%.`;
+        if (avoidableCost > 0) {
+            explanation += ` Blocking saves ~$${avoidableCost.toFixed(2)} in projected costs.`;
+        }
+        if (explosionRisk > 0.7) {
+            explanation += ` Explosion risk: ${(explosionRisk * 100).toFixed(0)}%.`;
+        }
+        return explanation;
+    }
+    cleanup() {
+        const now = Date.now();
+        const ttl = 2 * 60 * 60 * 1000; // 2 hours
+        for (const [id, session] of this.sessions) {
+            if (now - session.lastActivity > ttl) {
+                this.sessions.delete(id);
+            }
+        }
+    }
+}
+// ═══════════════════════════════════════════════════════════════════════════════
+// COMPONENT 3: SDK WRAPPER (one-line integration)
+// ═══════════════════════════════════════════════════════════════════════════════
+let globalEngine = null;
+function initLoopShield(config) {
+    globalEngine = new SemanticLoopDetectionEngine(config);
+}
+/**
+ * ONE-LINE INTEGRATION:
+ *
+ * const client = shield(new OpenAI({ apiKey }));
+ */
+function shield(client, sessionId) {
+    if (!globalEngine) {
+        globalEngine = new SemanticLoopDetectionEngine();
+    }
+    const sid = sessionId || `session-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+    return new Proxy(client, {
+        get(target, prop) {
+            if (typeof prop !== 'string')
+                return target[prop];
+            const value = target[prop];
+            // Intercept method calls
+            if (typeof value === 'function') {
+                return async (...args) => {
+                    // Extract operation info
+                    const operation = prop;
+                    const input = JSON.stringify(args);
+                    const estimatedCost = estimateCost(operation, args);
+                    // DETECT LOOP
+                    const result = globalEngine.detect(sid, {
+                        id: `${sid}-${Date.now()}`,
+                        timestamp: Date.now(),
+                        operation,
+                        toolName: extractToolName(operation, args),
+                        input,
+                        estimatedCost,
+                        metadata: extractMetadata(args),
+                    });
+                    if (result.blocked) {
+                        const error = new Error(`LoopShield blocked: ${result.explanation}`);
+                        error.shieldResult = result;
+                        throw error;
+                    }
+                    // Execute
+                    return value.apply(target, args);
+                };
+            }
+            // Handle nested objects
+            if (typeof value === 'object' && value !== null) {
+                return shield(value, sid);
+            }
+            return value;
+        },
+    });
+}
+function estimateCost(operation, args) {
+    // Estimate based on max_tokens
+    let tokens = 1000;
+    if (args[0]?.max_tokens)
+        tokens = args[0].max_tokens;
+    else if (args[0]?.maxTokens)
+        tokens = args[0].maxTokens;
+    // GPT-4 rate: $0.03 per 1K tokens
+    return (tokens / 1000) * 0.03;
+}
+function extractToolName(operation, args) {
+    if (args[0]?.model)
+        return args[0].model;
+    if (args[0]?.tool)
+        return args[0].tool;
+    return operation;
+}
+function extractMetadata(args) {
+    if (!args[0])
+        return {};
+    return {
+        model: args[0].model || args[0].modelName,
+        temperature: args[0].temperature,
+        maxTokens: args[0].max_tokens || args[0].maxTokens,
+    };
+}
+// Manual check for non-SDK usage
+function checkLoop(sessionId, operation, input, estimatedCost, toolName) {
+    if (!globalEngine) {
+        globalEngine = new SemanticLoopDetectionEngine();
+    }
+    return globalEngine.detect(sessionId, {
+        id: `${sessionId}-${Date.now()}`,
+        timestamp: Date.now(),
+        operation,
+        toolName,
+        input,
+        estimatedCost,
+    });
+}
+//# sourceMappingURL=loop-shield.js.map

package/dist/loop-shield.js.map

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

package/dist/metrics/BusinessMetricsEngine.d.ts

@@ -0,0 +1,109 @@
+/**
+ * BusinessMetricsEngine.ts - Commercial Metrics Layer
+ *
+ * Tracks per-user business value:
+ * - Monthly savings ($)
+ * - Requests protected
+ * - Cost prevented
+ * - System efficiency score
+ * - Risk exposure prevented
+ *
+ * Purpose: Make the commercial value of the product visible and measurable.
+ */
+export interface UserMetrics {
+    userId: string;
+    month: string;
+    monthlySavings: number;
+    totalRequestsProtected: number;
+    totalCostPrevented: number;
+    efficiencyScore: number;
+    averageResponseTimeMs: number;
+    uptimePercent: number;
+    riskExposurePrevented: number;
+    criticalBlocks: number;
+    loopDetections: number;
+    dailyActiveDays: number;
+    peakRequestsPerDay: number;
+    averageDailyRequests: number;
+}
+export interface LiveMetrics {
+    timestamp: number;
+    requestsLastMinute: number;
+    requestsLastHour: number;
+    savingsToday: number;
+    blocksLastHour: number;
+    activeUsers: number;
+    systemHealth: 'healthy' | 'degraded' | 'critical';
+}
+export interface MonthlySummary {
+    month: string;
+    totalSavings: number;
+    totalRequests: number;
+    totalBlocks: number;
+    topSavingsDay: {
+        date: string;
+        amount: number;
+    };
+    efficiencyTrend: 'improving' | 'stable' | 'declining';
+    projectedAnnualSavings: number;
+}
+export interface ProtectionEvent {
+    id: string;
+    timestamp: number;
+    userId: string;
+    type: 'block' | 'intercept' | 'loop_detected';
+    model: string;
+    estimatedCost: number;
+    moneySaved: number;
+    reason: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+}
+/**
+ * BusinessMetricsEngine - Tracks commercial value of protection
+ *
+ * Every blocked request = money saved = business value delivered.
+ */
+export declare class BusinessMetricsEngine {
+    private userMetrics;
+    private events;
+    private dailySavings;
+    /**
+     * Record a protection event (block, intercept, detection)
+     */
+    recordEvent(event: Omit<ProtectionEvent, 'id'>): ProtectionEvent;
+    /**
+     * Get live metrics for real-time dashboard
+     */
+    getLiveMetrics(): LiveMetrics;
+    /**
+     * Get monthly metrics for a user
+     */
+    getMonthlyMetrics(userId: string, month?: string): UserMetrics | undefined;
+    /**
+     * Get monthly summary with projections
+     */
+    getMonthlySummary(userId: string, month?: string): MonthlySummary;
+    /**
+     * Get recent protection activity for activity stream
+     */
+    getRecentActivity(userId: string, limit?: number): ProtectionEvent[];
+    /**
+     * Get risk exposure prevented (total potential disasters)
+     */
+    getRiskExposurePrevented(userId: string): {
+        totalExposure: number;
+        criticalEvents: number;
+        scenariosPrevented: string[];
+    };
+    /**
+     * Get system efficiency score
+     */
+    getEfficiencyScore(userId: string): number;
+    private updateUserMetrics;
+    private calculateSystemHealth;
+    private getCurrentMonth;
+    private getPreviousMonth;
+}
+export declare const businessMetrics: BusinessMetricsEngine;
+export declare function createBusinessMetrics(): BusinessMetricsEngine;
+//# sourceMappingURL=BusinessMetricsEngine.d.ts.map

package/dist/metrics/BusinessMetricsEngine.d.ts.map

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