@salimassili/ai-costguard 1.2.0 → 2.0.1

package/dist/dashboard.js

@@ -0,0 +1,201 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createServer } from 'node:http';
+const DEFAULT_EVENT_LOG_PATH = '.ai-costguard/events.jsonl';
+const DEFAULT_DASHBOARD_HOST = '127.0.0.1';
+const DEFAULT_DASHBOARD_PORT = 4318;
+/**
+ * Returns the default local event log path.
+ */
+export function getDefaultEventLogPath() {
+    return DEFAULT_EVENT_LOG_PATH;
+}
+/**
+ * Reads dashboard events from a local JSONL event log.
+ */
+export function readDashboardEvents(eventLogPath = DEFAULT_EVENT_LOG_PATH) {
+    if (!existsSync(eventLogPath))
+        return [];
+    const lines = readFileSync(eventLogPath, 'utf8')
+        .split(/\r?\n/u)
+        .map((line) => line.trim())
+        .filter(Boolean);
+    const events = [];
+    for (const line of lines) {
+        const event = parseDashboardEvent(line);
+        if (event)
+            events.push(event);
+    }
+    return events;
+}
+/**
+ * Builds dashboard metrics from a local event log.
+ */
+export function summarizeDashboard(options = {}) {
+    const eventLogPath = options.eventLogPath ?? DEFAULT_EVENT_LOG_PATH;
+    const recentLimit = Math.max(1, Math.trunc(options.recentLimit ?? 25));
+    const events = readDashboardEvents(eventLogPath);
+    const allowed = events.filter((event) => event.type === 'allow');
+    const blocked = events.filter((event) => event.type === 'block');
+    const costEvents = events.filter((event) => event.type === 'cost');
+    const estimatedSpendUsd = sum(allowed.map((event) => event.estimatedCost));
+    const estimatedSavingsUsd = sum(blocked.map((event) => event.estimatedCost));
+    const attemptedSpendUsd = costEvents.length
+        ? sum(costEvents.map((event) => event.estimatedCost))
+        : estimatedSpendUsd + estimatedSavingsUsd;
+    const actualSpendUsd = sum(events.map((event) => event.actualCost ?? 0));
+    const budgetUsd = options.budgetUsd;
+    return {
+        eventLogPath,
+        generatedAt: new Date().toISOString(),
+        budgetUsd,
+        budgetUsedPercent: budgetUsd && budgetUsd > 0 ? round((estimatedSpendUsd / budgetUsd) * 100, 2) : undefined,
+        requestsAllowed: allowed.length,
+        requestsBlocked: blocked.length,
+        estimatedSpendUsd: roundMoney(estimatedSpendUsd),
+        estimatedSavingsUsd: roundMoney(estimatedSavingsUsd),
+        attemptedSpendUsd: roundMoney(attemptedSpendUsd),
+        actualSpendUsd: roundMoney(actualSpendUsd),
+        loopDetections: blocked.filter((event) => event.code === 'LOOP_DETECTED').length,
+        retryDetections: blocked.filter((event) => event.code === 'RETRY_STORM_DETECTED').length,
+        recentEvents: events.slice(-recentLimit).reverse(),
+    };
+}
+/**
+ * Formats a dashboard summary for terminal output.
+ */
+export function formatDashboardSummary(summary) {
+    const budgetLine = summary.budgetUsd === undefined
+        ? `Budget used: $${summary.estimatedSpendUsd.toFixed(6)} estimated`
+        : `Budget used: ${summary.budgetUsedPercent?.toFixed(2) ?? '0.00'}% ($${summary.estimatedSpendUsd.toFixed(6)} / $${summary.budgetUsd.toFixed(6)})`;
+    return [
+        'AI CostGuard local dashboard',
+        `Event log: ${summary.eventLogPath}`,
+        budgetLine,
+        `Requests allowed: ${summary.requestsAllowed}`,
+        `Requests blocked: ${summary.requestsBlocked}`,
+        `Estimated spend: $${summary.estimatedSpendUsd.toFixed(6)}`,
+        `Estimated savings: $${summary.estimatedSavingsUsd.toFixed(6)}`,
+        `Attempted spend: $${summary.attemptedSpendUsd.toFixed(6)}`,
+        `Actual spend: $${summary.actualSpendUsd.toFixed(6)}`,
+        `Loop detections: ${summary.loopDetections}`,
+        `Retry detections: ${summary.retryDetections}`,
+        `Recent events: ${summary.recentEvents.length}`,
+        '',
+    ].join('\n');
+}
+/**
+ * Starts a local-only HTTP dashboard server.
+ */
+export function startDashboardServer(options = {}) {
+    const host = options.host ?? DEFAULT_DASHBOARD_HOST;
+    const port = options.port ?? DEFAULT_DASHBOARD_PORT;
+    const server = createServer((request, response) => {
+        const summary = summarizeDashboard(options);
+        if (request.url?.startsWith('/events.json')) {
+            response.writeHead(200, { 'content-type': 'application/json; charset=utf-8' });
+            response.end(JSON.stringify(summary, null, 2));
+            return;
+        }
+        response.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
+        response.end(renderDashboardHtml(summary));
+    });
+    return new Promise((resolve, reject) => {
+        server.once('error', reject);
+        server.listen(port, host, () => {
+            server.off('error', reject);
+            const address = server.address();
+            const actualPort = typeof address === 'object' && address ? address.port : port;
+            resolve({ server, url: `http://${host}:${actualPort}` });
+        });
+    });
+}
+function renderDashboardHtml(summary) {
+    const recentRows = summary.recentEvents
+        .map((event) => `<tr>
+        <td>${escapeHtml(event.timestamp)}</td>
+        <td>${escapeHtml(event.type)}</td>
+        <td>${escapeHtml(event.code ?? '')}</td>
+        <td>${escapeHtml(event.model)}</td>
+        <td>${escapeHtml(event.scopeKey)}</td>
+        <td>$${event.estimatedCost.toFixed(6)}</td>
+      </tr>`)
+        .join('');
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>AI CostGuard Local Dashboard</title>
+  <style>
+    body { margin: 0; font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; background: #101418; color: #eef2f4; }
+    main { max-width: 1120px; margin: 0 auto; padding: 32px 20px; }
+    h1 { margin: 0 0 8px; font-size: 32px; }
+    p { color: #a8b3bd; }
+    .grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(190px, 1fr)); gap: 12px; margin: 24px 0; }
+    .metric { border: 1px solid #2d363e; border-radius: 8px; padding: 16px; background: #161c22; }
+    .label { color: #8d99a5; font-size: 13px; }
+    .value { margin-top: 8px; font-size: 24px; font-weight: 700; }
+    table { width: 100%; border-collapse: collapse; margin-top: 20px; background: #161c22; }
+    th, td { border-bottom: 1px solid #2d363e; padding: 10px; text-align: left; font-size: 14px; }
+    th { color: #a8b3bd; }
+    code { color: #90cdf4; }
+  </style>
+</head>
+<body>
+  <main>
+    <h1>AI CostGuard Local Dashboard</h1>
+    <p>Local-only view generated from <code>${escapeHtml(summary.eventLogPath)}</code>. Refresh the page for updates.</p>
+    <section class="grid">
+      ${metric('Budget used', summary.budgetUsedPercent === undefined ? `$${summary.estimatedSpendUsd.toFixed(6)}` : `${summary.budgetUsedPercent.toFixed(2)}%`)}
+      ${metric('Requests allowed', String(summary.requestsAllowed))}
+      ${metric('Requests blocked', String(summary.requestsBlocked))}
+      ${metric('Estimated spend', `$${summary.estimatedSpendUsd.toFixed(6)}`)}
+      ${metric('Estimated savings', `$${summary.estimatedSavingsUsd.toFixed(6)}`)}
+      ${metric('Loop detections', String(summary.loopDetections))}
+      ${metric('Retry detections', String(summary.retryDetections))}
+      ${metric('Actual spend', `$${summary.actualSpendUsd.toFixed(6)}`)}
+    </section>
+    <h2>Recent Guard Events</h2>
+    <table>
+      <thead><tr><th>Time</th><th>Type</th><th>Code</th><th>Model</th><th>Scope</th><th>Estimated Cost</th></tr></thead>
+      <tbody>${recentRows || '<tr><td colspan="6">No events yet.</td></tr>'}</tbody>
+    </table>
+  </main>
+</body>
+</html>`;
+}
+function metric(label, value) {
+    return `<div class="metric"><div class="label">${escapeHtml(label)}</div><div class="value">${escapeHtml(value)}</div></div>`;
+}
+function parseDashboardEvent(line) {
+    try {
+        const value = JSON.parse(line);
+        if (value.version !== 1 || !value.timestamp || !value.type || !value.model || !value.scopeKey)
+            return undefined;
+        if (typeof value.estimatedCost !== 'number' || typeof value.tokens !== 'number')
+            return undefined;
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+function sum(values) {
+    return values.reduce((total, value) => total + value, 0);
+}
+function roundMoney(value) {
+    return round(value, 6);
+}
+function round(value, digits) {
+    const factor = 10 ** digits;
+    return Math.round(value * factor) / factor;
+}
+function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('"', '&quot;')
+        .replaceAll("'", '&#39;');
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/dashboard.js.map

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

package/dist/index.d.ts

@@ -1,7 +1,6 @@
-export { guard, GuardError, middleware } from './core/GuardFree.js';
-export { GuardPro, validateLicense, getProGuard } from './core/GuardPro.js';
-export type { GuardProConfig } from './core/GuardPro.js';
-export { getPricing, registerPricing, listPricing } from './pricing/index.js';
+export { guard, guardFunction, GuardError, middleware } from './core/GuardFree.js';
+export type { GuardedClient, GuardEventControls } from './core/GuardFree.js';
+export { BUILTIN_PRICING_LAST_UPDATED, getPricing, registerPricing, listPricing } from './pricing/index.js';
 export type { ModelPricing } from './pricing/index.js';
-export type { GuardConfig } from './core/types.js';
+export type { GuardConfig, GuardErrorCode, GuardEvent, GuardEventHandler, GuardEventName, GuardScope, GuardState, GuardWebhookConfig, RequestContext, } from './core/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACnF,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,4BAA4B,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC5G,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,4 +1,3 @@
-export { guard, GuardError, middleware } from './core/GuardFree.js';
-export { GuardPro, validateLicense, getProGuard } from './core/GuardPro.js';
-export { getPricing, registerPricing, listPricing } from './pricing/index.js';
+export { guard, guardFunction, GuardError, middleware } from './core/GuardFree.js';
+export { BUILTIN_PRICING_LAST_UPDATED, getPricing, registerPricing, listPricing } from './pricing/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEnF,OAAO,EAAE,4BAA4B,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/pricing/index.d.ts

@@ -1,11 +1,35 @@
+/**
+ * Last manual verification date for the built-in pricing registry.
+ *
+ * Provider pricing changes; use pricingOverrides/registerPricing for current
+ * production pricing when provider pages differ from these built-ins.
+ */
+export declare const BUILTIN_PRICING_LAST_UPDATED = "2026-06-07";
+/**
+ * Pricing entry expressed in USD per 1,000 tokens.
+ */
 export interface ModelPricing {
+    /** Model name or model family prefix. */
     model: string;
+    /** USD price per 1,000 input tokens. */
     inputPer1kTokens: number;
+    /** USD price per 1,000 output tokens. */
     outputPer1kTokens: number;
+    /** Date this pricing entry was last checked, formatted as YYYY-MM-DD. */
     lastUpdated: string;
+    /** Human-readable source for the pricing entry. */
     source: string;
 }
-export declare function getPricing(model: string, overrides?: ModelPricing[]): ModelPricing | undefined;
-export declare function registerPricing(entries: ModelPricing[]): void;
+/**
+ * Returns pricing for a model from overrides, runtime entries, or built-in entries.
+ */
+export declare function getPricing(model: string, overrides?: readonly ModelPricing[]): ModelPricing | undefined;
+/**
+ * Registers or replaces runtime pricing entries by model name.
+ */
+export declare function registerPricing(entries: readonly ModelPricing[]): void;
+/**
+ * Lists built-in and runtime pricing entries, deduplicated by normalized model name.
+ */
 export declare function listPricing(): ModelPricing[];
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pricing/index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAwDD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,YAAY,EAAO,GAAG,YAAY,GAAG,SAAS,CAkBlG;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAI7D;AAED,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAY5C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pricing/index.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,eAAe,CAAC;AAGzD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;CAChB;AA0GD;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,SAAS,YAAY,EAAO,GAAG,YAAY,GAAG,SAAS,CAuB3G;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAMtE;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAe5C"}

package/dist/pricing/index.js

@@ -1,60 +1,121 @@
-/* MAINTENANCE: update BUILTIN_PRICING when model prices change.
-   Check: https://openai.com/pricing and https://www.anthropic.com/pricing
-   Update the lastUpdated field on every change. */
+const STALE_PRICING_DAYS = 30;
+/**
+ * Last manual verification date for the built-in pricing registry.
+ *
+ * Provider pricing changes; use pricingOverrides/registerPricing for current
+ * production pricing when provider pages differ from these built-ins.
+ */
+export const BUILTIN_PRICING_LAST_UPDATED = '2026-06-07';
 const BUILTIN_PRICING = [
+    {
+        model: 'gpt-5.5',
+        inputPer1kTokens: 0.005,
+        outputPer1kTokens: 0.03,
+        lastUpdated: '2026-06-07',
+        source: 'https://developers.openai.com/api/docs/pricing',
+    },
+    {
+        model: 'gpt-5.4',
+        inputPer1kTokens: 0.0025,
+        outputPer1kTokens: 0.015,
+        lastUpdated: '2026-06-07',
+        source: 'https://developers.openai.com/api/docs/pricing',
+    },
+    {
+        model: 'gpt-5.4-mini',
+        inputPer1kTokens: 0.00075,
+        outputPer1kTokens: 0.0045,
+        lastUpdated: '2026-06-07',
+        source: 'https://developers.openai.com/api/docs/pricing',
+    },
+    {
+        model: 'gpt-5.4-nano',
+        inputPer1kTokens: 0.0002,
+        outputPer1kTokens: 0.00125,
+        lastUpdated: '2026-06-07',
+        source: 'https://developers.openai.com/api/docs/pricing',
+    },
     {
         model: 'gpt-4',
         inputPer1kTokens: 0.03,
         outputPer1kTokens: 0.06,
         lastUpdated: '2026-05-21',
-        source: 'https://openai.com/pricing'
+        source: 'https://openai.com/pricing',
     },
     {
         model: 'gpt-4o',
         inputPer1kTokens: 0.005,
         outputPer1kTokens: 0.015,
         lastUpdated: '2026-05-21',
-        source: 'https://openai.com/pricing'
+        source: 'https://openai.com/pricing',
     },
     {
         model: 'gpt-4o-mini',
         inputPer1kTokens: 0.00015,
         outputPer1kTokens: 0.0006,
         lastUpdated: '2026-05-21',
-        source: 'https://openai.com/pricing'
+        source: 'https://openai.com/pricing',
     },
     {
         model: 'gpt-3.5-turbo',
         inputPer1kTokens: 0.0005,
         outputPer1kTokens: 0.0015,
         lastUpdated: '2026-05-21',
-        source: 'https://openai.com/pricing'
+        source: 'https://openai.com/pricing',
+    },
+    {
+        model: 'claude-opus-4.8',
+        inputPer1kTokens: 0.005,
+        outputPer1kTokens: 0.025,
+        lastUpdated: '2026-06-07',
+        source: 'https://claude.com/platform/api',
+    },
+    {
+        model: 'claude-sonnet-4.6',
+        inputPer1kTokens: 0.003,
+        outputPer1kTokens: 0.015,
+        lastUpdated: '2026-06-07',
+        source: 'https://claude.com/platform/api',
+    },
+    {
+        model: 'claude-haiku-4.5',
+        inputPer1kTokens: 0.001,
+        outputPer1kTokens: 0.005,
+        lastUpdated: '2026-06-07',
+        source: 'https://claude.com/platform/api',
     },
     {
         model: 'claude-3-opus',
         inputPer1kTokens: 0.015,
         outputPer1kTokens: 0.075,
         lastUpdated: '2026-05-21',
-        source: 'https://www.anthropic.com/pricing'
+        source: 'https://www.anthropic.com/pricing',
     },
     {
         model: 'claude-3-sonnet',
         inputPer1kTokens: 0.003,
         outputPer1kTokens: 0.015,
         lastUpdated: '2026-05-21',
-        source: 'https://www.anthropic.com/pricing'
+        source: 'https://www.anthropic.com/pricing',
     },
     {
         model: 'claude-3-haiku',
         inputPer1kTokens: 0.00025,
         outputPer1kTokens: 0.00125,
         lastUpdated: '2026-05-21',
-        source: 'https://www.anthropic.com/pricing'
-    }
+        source: 'https://www.anthropic.com/pricing',
+    },
 ];
 const runtimePricing = new Map();
+const staleWarnings = new Set();
+/**
+ * Returns pricing for a model from overrides, runtime entries, or built-in entries.
+ */
 export function getPricing(model, overrides = []) {
     const normalizedModel = normalizeModel(model);
+    warnIfAnyStale(overrides);
+    warnIfAnyStale(runtimePricing.values());
+    warnIfAnyStale(BUILTIN_PRICING);
     const overrideExact = findExact(normalizedModel, overrides);
     if (overrideExact)
         return overrideExact;
@@ -72,11 +133,18 @@ export function getPricing(model, overrides = []) {
         return builtinExact;
     return findFuzzy(normalizedModel, BUILTIN_PRICING);
 }
+/**
+ * Registers or replaces runtime pricing entries by model name.
+ */
 export function registerPricing(entries) {
+    warnIfAnyStale(entries);
     for (const entry of entries) {
         runtimePricing.set(normalizeModel(entry.model), entry);
     }
 }
+/**
+ * Lists built-in and runtime pricing entries, deduplicated by normalized model name.
+ */
 export function listPricing() {
     const merged = new Map();
     for (const entry of BUILTIN_PRICING) {
@@ -85,7 +153,9 @@ export function listPricing() {
     for (const entry of runtimePricing.values()) {
         merged.set(normalizeModel(entry.model), entry);
     }
-    return Array.from(merged.values());
+    const entries = Array.from(merged.values());
+    warnIfAnyStale(entries);
+    return entries;
 }
 function findExact(model, entries) {
     return entries.find((entry) => normalizeModel(entry.model) === model);
@@ -94,10 +164,27 @@ function findFuzzy(model, entries) {
     const sortedEntries = [...entries].sort((a, b) => b.model.length - a.model.length);
     return sortedEntries.find((entry) => {
         const entryModel = normalizeModel(entry.model);
-        return model.includes(entryModel) || entryModel.includes(model);
+        return model.startsWith(`${entryModel}-`) || model.startsWith(`${entryModel}:`);
     });
 }
 function normalizeModel(model) {
     return model.trim().toLowerCase();
 }
+function warnIfAnyStale(entries) {
+    for (const entry of entries) {
+        warnIfStale(entry);
+    }
+}
+function warnIfStale(entry) {
+    const lastUpdatedMs = Date.parse(`${entry.lastUpdated}T00:00:00.000Z`);
+    if (!Number.isFinite(lastUpdatedMs))
+        return;
+    const ageDays = (Date.now() - lastUpdatedMs) / 86_400_000;
+    const warningKey = `${normalizeModel(entry.model)}:${entry.lastUpdated}`;
+    if (ageDays > STALE_PRICING_DAYS && !staleWarnings.has(warningKey)) {
+        staleWarnings.add(warningKey);
+        console.warn(`[AI CostGuard] Pricing for "${entry.model}" is older than ${STALE_PRICING_DAYS} days. ` +
+            `Last checked ${entry.lastUpdated}; verify ${entry.source}.`);
+    }
+}
 //# sourceMappingURL=index.js.map

package/dist/pricing/index.js.map

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

package/dist/pro.d.ts

@@ -0,0 +1,3 @@
+export { GuardPro, getProGuard } from './core/GuardPro.js';
+export type { GuardProConfig, GuardProRedisClient } from './core/GuardPro.js';
+//# sourceMappingURL=pro.d.ts.map

package/dist/pro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pro.d.ts","sourceRoot":"","sources":["../src/pro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/pro.js

@@ -0,0 +1,2 @@
+export { GuardPro, getProGuard } from './core/GuardPro.js';
+//# sourceMappingURL=pro.js.map

package/dist/pro.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pro.js","sourceRoot":"","sources":["../src/pro.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/docs/BENCHMARKS.md

@@ -0,0 +1,70 @@
+# Benchmarks
+
+Benchmarks are local measurements, not universal guarantees. Hardware, Node version, model request shape, history size, and enabled behavior checks all matter.
+
+Run:
+
+```bash
+npm run build
+npm run benchmark
+```
+
+For shorter sanity runs:
+
+```bash
+node benchmarks/run.mjs --iterations 500
+```
+
+The benchmark script measures:
+
+- Runtime overhead per guarded function call
+- Approximate heap delta after guarded calls
+- Benign false-positive scenario for repeated "again" prompts
+- Loop detection block step for repeated prompts
+- Cost-estimation sample boundaries
+
+Token accuracy benchmark:
+
+```bash
+npm run build
+npm run benchmark:tokens
+```
+
+## Current Local Result
+
+Current local run:
+
+- Date: `2026-06-08T13:03:42.459Z`
+- Node: `v24.14.1`
+- Platform: `win32`
+- Iterations: `5000`
+- Direct mocked async call: `0.000310 ms/call`
+- Guarded mocked async call: `0.021001 ms/call`
+- Added overhead: `0.020691 ms/call`
+- Benign repeated "again" prompts blocked: `0`
+- Repeated loop prompt blocked at step: `3`
+- GC exposed for memory run: `false`
+
+Do not quote benchmark numbers without the Node version, platform, iteration count, and date.
+
+Generated benchmark output is intentionally not published in the npm package. Re-run the benchmark on your target runtime before using numbers in public claims.
+
+## Token Accuracy Result
+
+Current fixed-corpus token accuracy run:
+
+- Reference: `gpt-tokenizer cl100k_base` fixture counts
+- Samples: `8`
+- Average error: `259.08%`
+- Median error: `263.98%`
+- Max error: `323.53%`
+
+This shows the current dependency-free estimator is conservative and materially overestimates this corpus. Treat AI CostGuard estimates as pre-call guardrails, not exact provider tokenizer counts.
+
+## Interpreting Results
+
+- `runtimeOverhead.addedPerCallMs` is the local overhead added by the guard wrapper in the benchmark request shape.
+- `memoryOverhead.heapDeltaBytes` is noisy unless Node runs with `--expose-gc`.
+- `falsePositiveScenarios.blocked` should remain `0` for the included benign repeated "again" prompts.
+- `loopDetectionBehavior.blockedAtStep` should show when a repeated loop is stopped.
+- `costEstimationBoundaries` reports this package's dependency-free estimator, not exact provider tokenizer output.

package/docs/DASHBOARD.md

@@ -0,0 +1,61 @@
+# Local Dashboard
+
+AI CostGuard includes a local-only dashboard command. It does not create an account, send telemetry, or run a cloud backend.
+
+The dashboard reads a JSONL event log written by guarded clients:
+
+```ts
+import { guard } from '@salimassili/ai-costguard';
+
+const openai = guard(client, {
+  budget: 5,
+  eventLogPath: '.ai-costguard/events.jsonl',
+  eventLogPrompt: 'none',
+});
+```
+
+Start the dashboard:
+
+```bash
+ai-costguard dashboard --events .ai-costguard/events.jsonl --budget 5
+```
+
+For scoped packages or one-off runs:
+
+```bash
+npx @salimassili/ai-costguard dashboard --events .ai-costguard/events.jsonl --budget 5
+```
+
+If the package is installed locally, this also works:
+
+```bash
+npx ai-costguard dashboard --events .ai-costguard/events.jsonl --budget 5
+```
+
+## What It Shows
+
+- Budget used
+- Requests allowed
+- Requests blocked
+- Estimated spend
+- Estimated savings
+- Attempted spend
+- Actual spend when provider usage is available
+- Loop detections
+- Retry detections
+- Recent guard events
+
+## Non-Interactive Summary
+
+Use `--once` for CI, smoke tests, or terminal summaries:
+
+```bash
+ai-costguard dashboard --events .ai-costguard/events.jsonl --budget 5 --once
+ai-costguard dashboard --events .ai-costguard/events.jsonl --budget 5 --once --json
+```
+
+## Privacy Notes
+
+`eventLogPrompt` defaults to `none`, so prompt text is not written to disk. Set `eventLogPrompt: 'preview'` only for local debugging where prompt previews are acceptable.
+
+The dashboard is a local development view, not a billing ledger. Use provider billing exports for financial reconciliation.