@salimassili/ai-costguard 1.1.3

package/dist/core/PricingConfig.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * PricingConfig.ts - Real API Pricing Configuration
+ *
+ * Maps token counts to actual costs for supported models
+ * Used for real cost extraction from API responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pricingConfig = exports.PricingConfig = void 0;
+/**
+ * Pricing Configuration - Singleton
+ * Stores real pricing data for AI providers
+ */
+class PricingConfig {
+    constructor() {
+        this.pricing = {
+            // OpenAI Models
+            'gpt-4': { inputPer1K: 0.03, outputPer1K: 0.06, provider: 'openai' },
+            'gpt-4-32k': { inputPer1K: 0.06, outputPer1K: 0.12, provider: 'openai' },
+            'gpt-4-turbo': { inputPer1K: 0.01, outputPer1K: 0.03, provider: 'openai' },
+            'gpt-4-turbo-preview': { inputPer1K: 0.01, outputPer1K: 0.03, provider: 'openai' },
+            'gpt-4o': { inputPer1K: 0.005, outputPer1K: 0.015, provider: 'openai' },
+            'gpt-4o-mini': { inputPer1K: 0.00015, outputPer1K: 0.0006, provider: 'openai' },
+            'gpt-3.5-turbo': { inputPer1K: 0.0005, outputPer1K: 0.0015, provider: 'openai' },
+            'gpt-3.5-turbo-16k': { inputPer1K: 0.001, outputPer1K: 0.002, provider: 'openai' },
+            // Anthropic Models
+            'claude-3-opus': { inputPer1K: 0.015, outputPer1K: 0.075, provider: 'anthropic' },
+            'claude-3-opus-20240229': { inputPer1K: 0.015, outputPer1K: 0.075, provider: 'anthropic' },
+            'claude-3-sonnet': { inputPer1K: 0.003, outputPer1K: 0.015, provider: 'anthropic' },
+            'claude-3-sonnet-20240229': { inputPer1K: 0.003, outputPer1K: 0.015, provider: 'anthropic' },
+            'claude-3-haiku': { inputPer1K: 0.00025, outputPer1K: 0.00125, provider: 'anthropic' },
+            'claude-3-haiku-20240307': { inputPer1K: 0.00025, outputPer1K: 0.00125, provider: 'anthropic' },
+            'claude-2.1': { inputPer1K: 0.008, outputPer1K: 0.024, provider: 'anthropic' },
+            'claude-2': { inputPer1K: 0.008, outputPer1K: 0.024, provider: 'anthropic' },
+            'claude-instant-1.2': { inputPer1K: 0.0008, outputPer1K: 0.0024, provider: 'anthropic' },
+            // Google Models
+            'gemini-pro': { inputPer1K: 0.0005, outputPer1K: 0.0015, provider: 'google' },
+            'gemini-pro-vision': { inputPer1K: 0.00025, outputPer1K: 0.0005, provider: 'google' },
+            // Cohere Models
+            'command': { inputPer1K: 0.0015, outputPer1K: 0.002, provider: 'cohere' },
+            'command-light': { inputPer1K: 0.0003, outputPer1K: 0.0006, provider: 'cohere' },
+            // Default fallback
+            'default': { inputPer1K: 0.01, outputPer1K: 0.03, provider: 'openai' },
+        };
+    }
+    static getInstance() {
+        if (!PricingConfig.instance) {
+            PricingConfig.instance = new PricingConfig();
+        }
+        return PricingConfig.instance;
+    }
+    /**
+     * Get pricing for a model
+     */
+    getPricing(model) {
+        // Try exact match first
+        if (this.pricing[model]) {
+            return this.pricing[model];
+        }
+        // Try partial match (e.g., "gpt-4" matches "gpt-4-turbo")
+        const modelLower = model.toLowerCase();
+        const match = Object.keys(this.pricing).find(key => modelLower.includes(key.toLowerCase()) || key.toLowerCase().includes(modelLower));
+        return match ? this.pricing[match] : this.pricing['default'];
+    }
+    /**
+     * Calculate real cost from token usage
+     */
+    calculateCost(model, usage) {
+        const pricing = this.getPricing(model);
+        const inputCost = (usage.prompt_tokens / 1000) * pricing.inputPer1K;
+        const outputCost = (usage.completion_tokens / 1000) * pricing.outputPer1K;
+        const totalCost = inputCost + outputCost;
+        return {
+            inputCost: Math.round(inputCost * 10000) / 10000,
+            outputCost: Math.round(outputCost * 10000) / 10000,
+            totalCost: Math.round(totalCost * 10000) / 10000,
+            model,
+            pricing,
+        };
+    }
+    /**
+     * Extract token usage from various API response formats
+     */
+    extractUsage(response) {
+        try {
+            // OpenAI format
+            if (response?.usage) {
+                return {
+                    prompt_tokens: response.usage.prompt_tokens || 0,
+                    completion_tokens: response.usage.completion_tokens || 0,
+                    total_tokens: response.usage.total_tokens || 0,
+                };
+            }
+            // Anthropic format
+            if (response?.usage?.input_tokens !== undefined) {
+                return {
+                    prompt_tokens: response.usage.input_tokens,
+                    completion_tokens: response.usage.output_tokens || 0,
+                    total_tokens: (response.usage.input_tokens || 0) + (response.usage.output_tokens || 0),
+                };
+            }
+            // Google format
+            if (response?.usageMetadata?.totalTokenCount !== undefined) {
+                return {
+                    prompt_tokens: response.usageMetadata.promptTokenCount || 0,
+                    completion_tokens: response.usageMetadata.candidatesTokenCount || 0,
+                    total_tokens: response.usageMetadata.totalTokenCount,
+                };
+            }
+            return null;
+        }
+        catch (e) {
+            return null;
+        }
+    }
+    /**
+     * Update pricing for a model (for custom models)
+     */
+    updatePricing(model, pricing) {
+        this.pricing[model] = pricing;
+    }
+    /**
+     * Get all supported models
+     */
+    getSupportedModels() {
+        return Object.keys(this.pricing).filter(m => m !== 'default');
+    }
+}
+exports.PricingConfig = PricingConfig;
+// Export singleton instance
+exports.pricingConfig = PricingConfig.getInstance();
+//# sourceMappingURL=PricingConfig.js.map

package/dist/core/PricingConfig.js.map

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

package/dist/core/SessionStats.d.ts

@@ -0,0 +1,101 @@
+/**
+ * SessionStats.ts - Session-level aggregation
+ *
+ * Tracks per run / per 24h:
+ * - total requests
+ * - total blocked
+ * - total saved
+ * - total spent
+ *
+ * Persists session stats locally
+ */
+export interface SessionStats {
+    sessionId: string;
+    startTime: number;
+    endTime?: number;
+    totalRequests: number;
+    totalBlocked: number;
+    totalAllowed: number;
+    totalWarned: number;
+    totalSaved: number;
+    totalSpent: number;
+    totalWouldHaveLost: number;
+    requests: {
+        timestamp: number;
+        decision: 'ALLOW' | 'BLOCK' | 'WARN';
+        cost: number;
+        saved: number;
+    }[];
+}
+export interface DailyStats {
+    date: string;
+    totalRequests: number;
+    totalBlocked: number;
+    totalSaved: number;
+    totalSpent: number;
+    totalWouldHaveLost: number;
+}
+/**
+ * SessionStats - Singleton
+ * Tracks session-level statistics
+ */
+export declare class SessionStatsManager {
+    private static instance;
+    private statsDir;
+    private sessionFile;
+    private dailyFile;
+    private currentSession;
+    private constructor();
+    static getInstance(): SessionStatsManager;
+    private ensureDirectory;
+    private loadSession;
+    private createNewSession;
+    private saveSession;
+    /**
+     * Record a request
+     */
+    recordRequest(params: {
+        decision: 'ALLOW' | 'BLOCK' | 'WARN';
+        cost: number;
+        saved: number;
+        wouldHaveLost: number;
+    }): void;
+    /**
+     * Update daily stats
+     */
+    private updateDailyStats;
+    private loadDailyStats;
+    private saveDailyStats;
+    /**
+     * Get current session stats
+     */
+    getSessionStats(): SessionStats;
+    /**
+     * Get daily stats for a date range
+     */
+    getDailyStats(days?: number): DailyStats[];
+    /**
+     * Get summary for display
+     */
+    getSummary(hours?: number): {
+        period: string;
+        totalRequests: number;
+        totalBlocked: number;
+        totalAllowed: number;
+        totalSaved: number;
+        totalSpent: number;
+        totalWouldHaveLost: number;
+        protectionRate: number;
+    };
+    /**
+     * Clear current session
+     */
+    clearSession(): void;
+    /**
+     * Get stats directory path
+     */
+    getStatsDir(): string;
+    private generateSessionId;
+}
+export declare const sessionStats: SessionStatsManager;
+//# sourceMappingURL=SessionStats.d.ts.map

package/dist/core/SessionStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStats.d.ts","sourceRoot":"","sources":["../../src/core/SessionStats.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;QACrC,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;CACL;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAe;IAErC,OAAO;IAQP,MAAM,CAAC,WAAW,IAAI,mBAAmB;IAOzC,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,gBAAgB;IAexB,OAAO,CAAC,WAAW;IASnB;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE;QACpB,QAAQ,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;QACrC,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;KACvB,GAAG,IAAI;IA+BR;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAyCxB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,eAAe,IAAI,YAAY;IAI/B;;OAEG;IACH,aAAa,CAAC,IAAI,GAAE,MAAU,GAAG,UAAU,EAAE;IAM7C;;OAEG;IACH,UAAU,CAAC,KAAK,GAAE,MAAW,GAAG;QAC9B,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,cAAc,EAAE,MAAM,CAAC;KACxB;IA+BD;;OAEG;IACH,YAAY,IAAI,IAAI;IAKpB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB,OAAO,CAAC,iBAAiB;CAG1B;AAGD,eAAO,MAAM,YAAY,qBAAoC,CAAC"}

package/dist/core/SessionStats.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * SessionStats.ts - Session-level aggregation
+ *
+ * Tracks per run / per 24h:
+ * - total requests
+ * - total blocked
+ * - total saved
+ * - total spent
+ *
+ * Persists session stats locally
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sessionStats = exports.SessionStatsManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+/**
+ * SessionStats - Singleton
+ * Tracks session-level statistics
+ */
+class SessionStatsManager {
+    constructor() {
+        this.statsDir = path.join(os.homedir(), '.ai-execution-firewall', 'stats');
+        this.sessionFile = path.join(this.statsDir, 'session.json');
+        this.dailyFile = path.join(this.statsDir, 'daily.json');
+        this.ensureDirectory();
+        this.currentSession = this.loadSession();
+    }
+    static getInstance() {
+        if (!SessionStatsManager.instance) {
+            SessionStatsManager.instance = new SessionStatsManager();
+        }
+        return SessionStatsManager.instance;
+    }
+    ensureDirectory() {
+        if (!fs.existsSync(this.statsDir)) {
+            fs.mkdirSync(this.statsDir, { recursive: true });
+        }
+    }
+    loadSession() {
+        try {
+            if (fs.existsSync(this.sessionFile)) {
+                const data = fs.readFileSync(this.sessionFile, 'utf8');
+                const session = JSON.parse(data);
+                // Start new session if it's been more than 24 hours
+                if (Date.now() - session.startTime > 24 * 60 * 60 * 1000) {
+                    return this.createNewSession();
+                }
+                return session;
+            }
+        }
+        catch (e) {
+            console.error('Error loading session stats:', e);
+        }
+        return this.createNewSession();
+    }
+    createNewSession() {
+        return {
+            sessionId: this.generateSessionId(),
+            startTime: Date.now(),
+            totalRequests: 0,
+            totalBlocked: 0,
+            totalAllowed: 0,
+            totalWarned: 0,
+            totalSaved: 0,
+            totalSpent: 0,
+            totalWouldHaveLost: 0,
+            requests: [],
+        };
+    }
+    saveSession() {
+        try {
+            this.ensureDirectory();
+            fs.writeFileSync(this.sessionFile, JSON.stringify(this.currentSession, null, 2));
+        }
+        catch (e) {
+            console.error('Error saving session stats:', e);
+        }
+    }
+    /**
+     * Record a request
+     */
+    recordRequest(params) {
+        this.currentSession.totalRequests++;
+        this.currentSession.totalWouldHaveLost += params.wouldHaveLost;
+        if (params.decision === 'BLOCK') {
+            this.currentSession.totalBlocked++;
+            this.currentSession.totalSaved += params.saved;
+        }
+        else if (params.decision === 'ALLOW') {
+            this.currentSession.totalAllowed++;
+            this.currentSession.totalSpent += params.cost;
+        }
+        else if (params.decision === 'WARN') {
+            this.currentSession.totalWarned++;
+            this.currentSession.totalSpent += params.cost;
+        }
+        this.currentSession.requests.push({
+            timestamp: Date.now(),
+            decision: params.decision,
+            cost: params.cost,
+            saved: params.saved,
+        });
+        // Keep only last 1000 requests
+        if (this.currentSession.requests.length > 1000) {
+            this.currentSession.requests = this.currentSession.requests.slice(-1000);
+        }
+        this.saveSession();
+        this.updateDailyStats(params);
+    }
+    /**
+     * Update daily stats
+     */
+    updateDailyStats(params) {
+        const today = new Date().toISOString().split('T')[0];
+        const dailyStats = this.loadDailyStats();
+        if (!dailyStats[today]) {
+            dailyStats[today] = {
+                date: today,
+                totalRequests: 0,
+                totalBlocked: 0,
+                totalSaved: 0,
+                totalSpent: 0,
+                totalWouldHaveLost: 0,
+            };
+        }
+        const day = dailyStats[today];
+        day.totalRequests++;
+        day.totalWouldHaveLost += params.wouldHaveLost;
+        if (params.decision === 'BLOCK') {
+            day.totalBlocked++;
+            day.totalSaved += params.saved;
+        }
+        else {
+            day.totalSpent += params.cost;
+        }
+        // Keep only last 30 days
+        const dates = Object.keys(dailyStats).sort().reverse();
+        if (dates.length > 30) {
+            const toDelete = dates.slice(30);
+            toDelete.forEach(d => delete dailyStats[d]);
+        }
+        this.saveDailyStats(dailyStats);
+    }
+    loadDailyStats() {
+        try {
+            if (fs.existsSync(this.dailyFile)) {
+                return JSON.parse(fs.readFileSync(this.dailyFile, 'utf8'));
+            }
+        }
+        catch (e) {
+            console.error('Error loading daily stats:', e);
+        }
+        return {};
+    }
+    saveDailyStats(stats) {
+        try {
+            this.ensureDirectory();
+            fs.writeFileSync(this.dailyFile, JSON.stringify(stats, null, 2));
+        }
+        catch (e) {
+            console.error('Error saving daily stats:', e);
+        }
+    }
+    /**
+     * Get current session stats
+     */
+    getSessionStats() {
+        return { ...this.currentSession };
+    }
+    /**
+     * Get daily stats for a date range
+     */
+    getDailyStats(days = 7) {
+        const dailyStats = this.loadDailyStats();
+        const dates = Object.keys(dailyStats).sort().reverse().slice(0, days);
+        return dates.map(d => dailyStats[d]);
+    }
+    /**
+     * Get summary for display
+     */
+    getSummary(hours = 24) {
+        const session = this.currentSession;
+        const cutoff = Date.now() - (hours * 60 * 60 * 1000);
+        // Filter requests within time window
+        const recentRequests = session.requests.filter(r => r.timestamp >= cutoff);
+        const totalRequests = recentRequests.length;
+        const totalBlocked = recentRequests.filter(r => r.decision === 'BLOCK').length;
+        const totalAllowed = recentRequests.filter(r => r.decision === 'ALLOW').length;
+        const totalSaved = recentRequests.reduce((sum, r) => sum + r.saved, 0);
+        const totalSpent = recentRequests.reduce((sum, r) => sum + r.cost, 0);
+        const totalWouldHaveLost = totalSaved + totalSpent;
+        const protectionRate = totalRequests > 0
+            ? (totalBlocked / totalRequests) * 100
+            : 0;
+        return {
+            period: `${hours}h`,
+            totalRequests,
+            totalBlocked,
+            totalAllowed,
+            totalSaved: Math.round(totalSaved * 100) / 100,
+            totalSpent: Math.round(totalSpent * 100) / 100,
+            totalWouldHaveLost: Math.round(totalWouldHaveLost * 100) / 100,
+            protectionRate: Math.round(protectionRate * 100) / 100,
+        };
+    }
+    /**
+     * Clear current session
+     */
+    clearSession() {
+        this.currentSession = this.createNewSession();
+        this.saveSession();
+    }
+    /**
+     * Get stats directory path
+     */
+    getStatsDir() {
+        return this.statsDir;
+    }
+    generateSessionId() {
+        return `session-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+exports.SessionStatsManager = SessionStatsManager;
+// Export singleton instance
+exports.sessionStats = SessionStatsManager.getInstance();
+//# sourceMappingURL=SessionStats.js.map

package/dist/core/SessionStats.js.map

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

package/dist/core/StateStore.d.ts

@@ -0,0 +1,100 @@
+/**
+ * StateStore.ts - Unified State Management
+ *
+ * This is the SINGLE source of truth for all state in AI Execution Firewall.
+ * Handles: request history, hashing, persistence (file-based)
+ * Used ONLY by DetectionEngine - no direct access from CLI/SDK/Proxy
+ */
+export interface RequestRecord {
+    id: string;
+    timestamp: number;
+    model: string;
+    prompt: string;
+    promptHash: string;
+    estimatedCost: number;
+    dangerScore: number;
+    isDangerous: boolean;
+    category: string;
+    wasBlocked: boolean;
+    wasWarned: boolean;
+    reason?: string;
+    context?: string;
+}
+export interface StateStats {
+    totalRequests: number;
+    blockedRequests: number;
+    warnedRequests: number;
+    totalCost: number;
+    preventedCost: number;
+}
+/**
+ * Unified StateStore - Singleton
+ * All state lives here. All persistence happens here.
+ */
+export declare class StateStore {
+    private static instance;
+    private cache;
+    private initialized;
+    private readonly persistence;
+    private constructor();
+    static getInstance(): StateStore;
+    /**
+     * Initialize storage directory and load existing history
+     */
+    private initialize;
+    /**
+     * Load all history from disk into memory cache
+     */
+    private loadHistory;
+    /**
+     * Generate hash for prompt + context
+     */
+    generateHash(prompt: string, context?: string): string;
+    /**
+     * Get recent requests by hash within time window
+     */
+    getRecentByHash(hash: string, windowMs?: number): RequestRecord[];
+    /**
+     * Get all recent requests within time window
+     */
+    getAllRecent(windowMs?: number): RequestRecord[];
+    /**
+     * Add a record to state (memory + disk)
+     */
+    addRecord(record: RequestRecord): void;
+    /**
+     * Get statistics for time window
+     */
+    getStats(hours?: number): StateStats;
+    /**
+     * Get blocked requests
+     */
+    getBlocked(limit?: number): RequestRecord[];
+    /**
+     * Calculate similarity between two strings (Levenshtein)
+     */
+    calculateSimilarity(str1: string, str2: string): number;
+    /**
+     * Clear all history (for testing)
+     */
+    clear(): void;
+    /**
+     * Reload state from disk (for testing)
+     */
+    reload(): void;
+    /**
+     * Reset for testing - fully restore initial state
+     */
+    reset(): void;
+    getPersistenceMode(): 'file' | 'redis';
+    private createPersistence;
+    getOperationalMetrics(hours?: number): {
+        total_cost_saved: number;
+        blocked_requests_count: number;
+        false_positive_indicator: number;
+        avg_analysis_latency_ms: number;
+        storage_backend: 'file' | 'redis';
+    };
+}
+export declare const stateStore: StateStore;
+//# sourceMappingURL=StateStore.d.ts.map

package/dist/core/StateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateStore.d.ts","sourceRoot":"","sources":["../../src/core/StateStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AA8HD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAa;IACpC,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAE/C,OAAO;IAKP,MAAM,CAAC,WAAW,IAAI,UAAU;IAOhC;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;YACW,WAAW;IAczB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAItD;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAc,GAAG,aAAa,EAAE;IAMxE;;OAEG;IACH,YAAY,CAAC,QAAQ,GAAE,MAAgB,GAAG,aAAa,EAAE;IAWzD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAUtC;;OAEG;IACH,QAAQ,CAAC,KAAK,GAAE,MAAW,GAAG,UAAU;IAcxC;;OAEG;IACH,UAAU,CAAC,KAAK,GAAE,MAAW,GAAG,aAAa,EAAE;IAM/C;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAiCvD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,MAAM,IAAI,IAAI;IAMd;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb,kBAAkB,IAAI,MAAM,GAAG,OAAO;IAItC,OAAO,CAAC,iBAAiB;IAQzB,qBAAqB,CAAC,KAAK,GAAE,MAAW,GAAG;QACzC,gBAAgB,EAAE,MAAM,CAAC;QACzB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,wBAAwB,EAAE,MAAM,CAAC;QACjC,uBAAuB,EAAE,MAAM,CAAC;QAChC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC;KACnC;CAeF;AAGD,eAAO,MAAM,UAAU,YAA2B,CAAC"}