@salimassili/ai-costguard 1.1.8 → 1.2.0

package/README.md

@@ -1,107 +1,202 @@
 # AI CostGuard
 
-The kill-switch for AI agents.
+AI CostGuard is a small TypeScript library that wraps OpenAI-like clients and blocks requests before they run when local safety checks predict unsafe AI API spend.
 
-Prevent runaway AI agent loops, token bombs, and budget explosions before they happen.
+It is ESM-only, targets Node.js 18+, and is built with `tsc`.
+
+## What Works Today
+
+- `guard()` wraps a client with budget, loop, and retry protection.
+- `GuardError` is thrown when a request is blocked.
+- Budget blocking estimates request cost before the API call.
+- Loop detection blocks repeated prompts within the current process.
+- Retry detection blocks repeated failure/retry prompts within the current process.
+- `middleware()` adds the same local checks to web request flows.
+- `getPricing()` returns known built-in model pricing.
+- `registerPricing()` and `listPricing()` let you manage runtime pricing entries.
+
+## Install
 
 ```bash
 npm install @salimassili/ai-costguard
 ```
 
-## Install & Protect (30 seconds)
+## Basic Usage
 
 ```ts
-import { withCostGuard } from '@salimassili/ai-costguard';
+import OpenAI from 'openai';
+import { guard, GuardError } from '@salimassili/ai-costguard';
 
-const openai = withCostGuard(client, {
-  maxTotalCostPerDay: 5
-});
+const client = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });
+const ai = guard(client, { budget: 1 });
+
+try {
+  const response = await ai.chat.completions.create({
+    model: 'gpt-4o-mini',
+    messages: [{ role: 'user', content: 'Write a short project summary.' }],
+    max_tokens: 200
+  });
+
+  console.log(response);
+} catch (error) {
+  if (error instanceof GuardError) {
+    console.error('AI request blocked:', error.message, error.context);
+  } else {
+    throw error;
+  }
+}
 ```
 
-## What You Get
+## How `guard()` Works
 
-When your agent spirals:
+`guard(client, config)` returns a `Proxy` around your client. When code calls a method such as `client.chat.completions.create(...)`, CostGuard:
 
-```
-[CostGuard] BLOCKED LOOP → 12 recursive cycles detected → estimated save: $18.42
-```
+1. Reads the request model, messages, and `max_tokens`.
+2. Estimates input tokens from message length and combines them with the requested output limit.
+3. Looks up pricing for the model.
+4. Estimates the request cost.
+5. Blocks the call with `GuardError` if the local budget would be exceeded.
+6. Blocks repeated prompts that look like loops.
+7. Blocks repeated prompts that look like retry storms.
+8. Lets the original client method run when checks pass.
 
-A financial save event. Not a vague error.
+The free guard state is process-local. Separate Node.js processes do not share budget state.
 
-## Why This Exists
+## Budget Blocking
 
-AI agents don't fail gracefully. They fail exponentially.
+```ts
+import { guard } from '@salimassili/ai-costguard';
 
-A stuck agent can burn hundreds of dollars in API credits overnight. Not because it's fast. Because it's relentless.
+const ai = guard(openai, { budget: 0.25 });
 
-Your agent framework has no kill-switch. Rate limiters don't detect semantic loops. Cost alerts tell you after the money is gone.
+await ai.chat.completions.create({
+  model: 'gpt-4o-mini',
+  messages: [{ role: 'user', content: 'Hello' }],
+  max_tokens: 100
+});
+```
 
-This is the missing layer.
+When the estimated cumulative spend in the current process would exceed `budget`, CostGuard throws `GuardError` before calling the underlying AI client.
 
-## Real-World Protection
+## Loop And Retry Detection
 
-### 1. Recursive Loop
-Agent repeats the same reasoning forever.
+CostGuard keeps a short in-memory history of recent prompts for the wrapped client:
 
-### 2. Tool Retry Explosion
-Agent retries a failing tool endlessly.
+- Loop detection blocks repeated prompt hashes.
+- Retry detection blocks repeated prompts containing retry/failure language such as `retry`, `again`, `repeat`, `error`, `fail`, or `timeout`.
 
-### 3. Budget Breach
-Agent burns tokens rapidly until blocked.
+These checks are intentionally local and lightweight.
 
-## API
+## Middleware
 
 ```ts
-withCostGuard(client, {
-  maxTotalCostPerDay: 10,    // Hard USD limit
-  maxTokensPerRequest: 4000, // Per-call limit
-  maxRequestsPerMinute: 30,  // Rate limit
-  loopDetection: true        // Catch repeated prompts
-})
+import express from 'express';
+import { middleware, GuardError } from '@salimassili/ai-costguard';
+
+const app = express();
+
+app.use(middleware({ budget: 2 }));
+
+app.post('/chat', async (req, res, next) => {
+  try {
+    req.localSafety.check({
+      model: 'gpt-4o-mini',
+      tokens: 1000,
+      estimatedCost: 0.001,
+      timestamp: Date.now(),
+      prompt: req.body?.prompt ?? ''
+    });
+
+    res.json({ ok: true });
+  } catch (error) {
+    if (error instanceof GuardError) {
+      res.status(402).json({ error: error.message, context: error.context });
+      return;
+    }
+
+    next(error);
+  }
+});
 ```
 
-## Example
+## Pricing
 
 ```ts
-import { withCostGuard, CostGuardError } from '@salimassili/ai-costguard';
+import { getPricing, listPricing, registerPricing } from '@salimassili/ai-costguard';
 
-const openai = withCostGuard(
-  new OpenAI({ apiKey: process.env.OPENAI_API_KEY }),
-  { maxTotalCostPerDay: 5 }
-);
+console.log(getPricing('gpt-4o-mini'));
 
-try {
-  const response = await openai.chat.completions.create({
-    model: 'gpt-4',
-    messages: [{ role: 'user', content: 'Hello' }],
-  });
-} catch (err) {
-  if (err instanceof CostGuardError) {
-    console.log('Agent blocked:', err.message);
-    // Handle gracefully
+registerPricing([
+  {
+    model: 'custom-model',
+    inputPer1kTokens: 0.001,
+    outputPer1kTokens: 0.002,
+    lastUpdated: '2026-05-21',
+    source: 'internal'
   }
-}
+]);
+
+console.log(listPricing());
 ```
 
-## Express Middleware
+`getPricing(model)` returns an exact match when available, then falls back to simple fuzzy matching. Unknown models return `undefined`.
+
+## Pro Features (Coming Soon)
+
+> These features are under active development and not yet available:
+> - Distributed Redis-backed budget state
+> - Real Slack/Discord webhook alerts
+> - Multi-instance coordination
+> - Production license validation
+
+## API
+
+### `guard(client, config)`
+
+Wraps an OpenAI-like client.
 
 ```ts
-import { costGuardMiddleware } from '@salimassili/ai-costguard';
+guard(client, { budget: 10 });
+```
 
-app.use(costGuardMiddleware({ maxTotalCostPerDay: 10 }));
+### `GuardError`
+
+Thrown when CostGuard blocks a request.
+
+```ts
+try {
+  await ai.chat.completions.create(params);
+} catch (error) {
+  if (error instanceof GuardError) {
+    console.log(error.context);
+  }
+}
 ```
 
-## Features
+### `middleware(config)`
 
-- **Loop detection** — kills repeated prompts and recursive cycles
-- **Daily cost caps** — hard USD limits, no overages
-- **Token limits** — block oversized single requests
-- **RPM limits** — catch agents hammering the API
+Creates request middleware with local budget, loop, and retry checks.
 
-## Install Before You Deploy
+### `getPricing(model, overrides?)`
 
-```bash
-npm install @salimassili/ai-costguard
-```
+Returns pricing for a model from overrides, runtime registrations, or built-in entries.
+
+### `registerPricing(entries)`
+
+Registers or replaces runtime pricing entries by model name.
+
+### `listPricing()`
+
+Returns built-in and runtime pricing entries, deduplicated by model name.
+
+## Limitations
+
+- Free guard state is stored in memory only.
+- Budget checks are estimates, not billing records.
+- Token estimation is approximate.
+- Pricing entries are static until the package or runtime registry is updated.
+- The library does not include dashboards, analytics, governance workflows, or hosted services.
+
+## License
 
-MIT | [GitHub](https://github.com/salimassili62-afk/ai-costguard)
+MIT

package/dist/core/CostGuard.d.ts

@@ -1,27 +1,7 @@
-/**
- * CostGuard.ts — AI Agent Loop & Cost Firewall
- *
- * Wraps your AI client and kills runaway loops before they burn money.
- * When it blocks, it tells you exactly how much it saved.
- */
-import { CostGuardConfig, RequestContext, GuardState } from './types.js';
-/**
- * Wraps any AI client. Detects loops. Enforces hard limits.
- * Throws on block so your app handles it.
- */
-export declare function withCostGuard(client: any, config: any, sharedState?: GuardState): any;
-/**
- * Standalone middleware for Express/Fastify
- */
-export declare function costGuardMiddleware(config?: Partial<CostGuardConfig>): (req: any, res: any, next: any) => void;
-/** Custom error so users can catch it specifically */
-export declare class CostGuardError extends Error {
-    context: RequestContext;
-    constructor(message: string, context: RequestContext);
-}
-/** Get current pricing for a model (cents per 1K tokens) */
-export declare function getPricing(model: string): {
-    input: number;
-    output: number;
-} | undefined;
+export { guard, GuardError, middleware } from './GuardFree.js';
+export { GuardPro, validateLicense, getProGuard } from './GuardPro.js';
+export type { GuardProConfig } from './GuardPro.js';
+export { getPricing, registerPricing, listPricing } from '../pricing/index.js';
+export type { ModelPricing } from '../pricing/index.js';
+export type { GuardConfig } from './types.js';
 //# sourceMappingURL=CostGuard.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CostGuard.d.ts","sourceRoot":"","sources":["../../src/core/CostGuard.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAiB,MAAM,YAAY,CAAC;AAYxF;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,EAAE,UAAU,OAmE/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,IAiB/D,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,UAgBtC;AAoFD,sDAAsD;AACtD,qBAAa,cAAe,SAAQ,KAAK;IACvC,OAAO,EAAE,cAAc,CAAC;gBACZ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;CAKrD;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAEvF"}
+{"version":3,"file":"CostGuard.d.ts","sourceRoot":"","sources":["../../src/core/CostGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/core/CostGuard.js

@@ -1,191 +1,4 @@
-/**
- * CostGuard.ts — AI Agent Loop & Cost Firewall
- *
- * Wraps your AI client and kills runaway loops before they burn money.
- * When it blocks, it tells you exactly how much it saved.
- */
-const MODEL_PRICING = {
-    'gpt-4': { input: 0.03, output: 0.06 },
-    'gpt-4o': { input: 0.005, output: 0.015 },
-    'gpt-4o-mini': { input: 0.00015, output: 0.0006 },
-    'gpt-3.5-turbo': { input: 0.0005, output: 0.0015 },
-    'claude-3-opus': { input: 0.015, output: 0.075 },
-    'claude-3-sonnet': { input: 0.003, output: 0.015 },
-    'claude-3-haiku': { input: 0.00025, output: 0.00125 },
-};
-/**
- * Wraps any AI client. Detects loops. Enforces hard limits.
- * Throws on block so your app handles it.
- */
-export function withCostGuard(client, config, sharedState) {
-    const defaults = {
-        maxTokensPerRequest: 4000,
-        maxRequestsPerMinute: 30,
-        maxTotalCostPerDay: 10.00,
-        loopDetection: true,
-    };
-    const guard = { ...defaults, ...config };
-    // Use shared state if provided (for nested objects), otherwise create new
-    const state = sharedState || {
-        requestCount: 0,
-        totalCost: 0,
-        lastRequestTime: 0,
-        recentPrompts: [],
-        blockedCount: 0,
-    };
-    return new Proxy(client, {
-        get(target, prop) {
-            const value = target[prop];
-            // If it's a function (like .create), wrap it
-            if (typeof value === 'function') {
-                return (...args) => {
-                    // Extract request details from args
-                    const ctx = extractContext(args, prop);
-                    // Evaluate against limits
-                    const decision = evaluate(guard, state, ctx);
-                    if (decision === 'block') {
-                        state.blockedCount++;
-                        // Build a financial save message
-                        const saveMsg = buildSaveMessage(state, ctx);
-                        console.error(saveMsg);
-                        if (guard.onLimitHit)
-                            guard.onLimitHit('Limit exceeded', ctx.estimatedCost);
-                        throw new CostGuardError(saveMsg.replace('[AI CostGuard] ', ''), ctx);
-                    }
-                    // Update state
-                    state.requestCount++;
-                    state.totalCost += ctx.estimatedCost;
-                    state.lastRequestTime = Date.now();
-                    if (guard.loopDetection)
-                        state.recentPrompts.push(ctx.prompt);
-                    if (state.recentPrompts.length > 20)
-                        state.recentPrompts.shift();
-                    console.log(`[AI CostGuard] ALLOW: ${ctx.model} | ${ctx.tokens}t | $${ctx.estimatedCost.toFixed(4)} | Total: $${state.totalCost.toFixed(2)}`);
-                    // Pass through to actual API call
-                    return value.apply(target, args);
-                };
-            }
-            // If it's a nested object (like .chat.completions), recurse with shared state
-            if (value && typeof value === 'object') {
-                return withCostGuard(value, guard, state);
-            }
-            return value;
-        },
-    });
-}
-/**
- * Standalone middleware for Express/Fastify
- */
-export function costGuardMiddleware(config = {}) {
-    const guard = {
-        maxTokensPerRequest: 4000,
-        maxRequestsPerMinute: 30,
-        maxTotalCostPerDay: 10.00,
-        loopDetection: true,
-        ...config,
-    };
-    const state = {
-        requestCount: 0,
-        totalCost: 0,
-        lastRequestTime: 0,
-        recentPrompts: [],
-        blockedCount: 0,
-    };
-    return (req, res, next) => {
-        req.costGuard = {
-            state,
-            evaluate: (ctx) => {
-                const decision = evaluate(guard, state, ctx);
-                if (decision === 'block') {
-                    state.blockedCount++;
-                    throw new CostGuardError('Request blocked by cost guard', ctx);
-                }
-                state.requestCount++;
-                state.totalCost += ctx.estimatedCost;
-                state.lastRequestTime = Date.now();
-            },
-        };
-        next();
-    };
-}
-/** Extract request context from API call args */
-function extractContext(args, prop) {
-    const params = args[0] || {};
-    const model = params.model || 'unknown';
-    const messages = params.messages || [];
-    const prompt = messages.map((m) => m.content).join(' ').slice(0, 200);
-    // Estimate tokens (rough: 1 token ≈ 4 chars for English)
-    const inputText = JSON.stringify(messages);
-    const estimatedInputTokens = Math.ceil(inputText.length / 4);
-    const maxOutputTokens = params.max_tokens || 1000;
-    const tokens = estimatedInputTokens + maxOutputTokens;
-    // Estimate cost
-    const pricing = MODEL_PRICING[model] || { input: 0.01, output: 0.03 };
-    const estimatedCost = (estimatedInputTokens / 1000) * pricing.input +
-        (maxOutputTokens / 1000) * pricing.output;
-    return {
-        model,
-        tokens,
-        estimatedCost,
-        timestamp: Date.now(),
-        prompt,
-    };
-}
-/** Build a human-readable "financial save" message */
-function buildSaveMessage(state, ctx) {
-    const duplicates = state.recentPrompts.filter(p => p === ctx.prompt).length;
-    const isLoop = duplicates >= 2;
-    // Estimate how much we saved by blocking this + projected future calls
-    // Assume a runaway loop would repeat ~50 more times if unchecked
-    const projectedCycles = isLoop ? 50 : 10;
-    const estimatedSave = (ctx.estimatedCost * projectedCycles) + ctx.estimatedCost;
-    if (isLoop) {
-        return `[AI CostGuard] BLOCKED LOOP → ${duplicates + 1} recursive cycles detected → estimated save: $${estimatedSave.toFixed(2)}`;
-    }
-    if (ctx.tokens > 4000) {
-        return `[AI CostGuard] BLOCKED TOKEN BOMB → ${ctx.tokens} tokens → estimated save: $${ctx.estimatedCost.toFixed(2)}`;
-    }
-    if (state.totalCost + ctx.estimatedCost > 5) {
-        const remaining = (state.totalCost + ctx.estimatedCost) - 5;
-        return `[AI CostGuard] BLOCKED BUDGET BREACH → daily cap reached → estimated save: $${remaining.toFixed(2)}`;
-    }
-    return `[AI CostGuard] BLOCKED → estimated save: $${ctx.estimatedCost.toFixed(2)}`;
-}
-/** Evaluate request against all limits */
-function evaluate(guard, state, ctx) {
-    // 1. Token limit
-    if (ctx.tokens > guard.maxTokensPerRequest) {
-        return 'block';
-    }
-    // 2. RPM limit
-    const oneMinuteAgo = Date.now() - 60000;
-    if (state.lastRequestTime > oneMinuteAgo && state.requestCount >= guard.maxRequestsPerMinute) {
-        return 'block';
-    }
-    // 3. Daily cost limit
-    if (state.totalCost + ctx.estimatedCost > guard.maxTotalCostPerDay) {
-        return 'block';
-    }
-    // 4. Loop detection (simple: same prompt repeated)
-    if (guard.loopDetection && state.recentPrompts.length > 0) {
-        const duplicates = state.recentPrompts.filter(p => p === ctx.prompt).length;
-        if (duplicates >= 2) {
-            return 'block';
-        }
-    }
-    return 'allow';
-}
-/** Custom error so users can catch it specifically */
-export class CostGuardError extends Error {
-    context;
-    constructor(message, context) {
-        super(message);
-        this.name = 'CostGuardError';
-        this.context = context;
-    }
-}
-/** Get current pricing for a model (cents per 1K tokens) */
-export function getPricing(model) {
-    return MODEL_PRICING[model];
-}
+export { guard, GuardError, middleware } from './GuardFree.js';
+export { GuardPro, validateLicense, getProGuard } from './GuardPro.js';
+export { getPricing, registerPricing, listPricing } from '../pricing/index.js';
 //# sourceMappingURL=CostGuard.js.map

package/dist/core/CostGuard.js.map

@@ -1 +1 @@
-{"version":3,"file":"CostGuard.js","sourceRoot":"","sources":["../../src/core/CostGuard.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CostGuard.js","sourceRoot":"","sources":["../../src/core/CostGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEvE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/GuardCore.d.ts

@@ -0,0 +1,22 @@
+/**
+ * GuardCore.ts - FREE CORE (VIRAL ENGINE)
+ *
+ * Maximum simplicity. Maximum virality. Zero complexity.
+ * Instant safety layer every AI developer installs by default.
+ */
+import { GuardConfig, RequestContext, GuardState } from './types.js';
+/**
+ * Guard your AI client from wasting money
+ * FREE CORE: Local protection + viral logs + real-time risk warnings
+ */
+export declare function guard(client: any, config: GuardConfig, sharedState?: GuardState): any;
+/**
+ * Express middleware (FREE CORE - LOCAL ONLY)
+ */
+export declare function middleware(config: GuardConfig): (req: any, res: any, next: any) => void;
+export declare class GuardError extends Error {
+    context: RequestContext;
+    constructor(message: string, context: RequestContext);
+}
+export { getPricing } from '../pricing/index.js';
+//# sourceMappingURL=GuardCore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GuardCore.d.ts","sourceRoot":"","sources":["../../src/core/GuardCore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAErE;;;GAGG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,UAAU,OAgF/E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,IAGpC,KAAK,GAAG,EAAE,KAAK,GAAG,EAAE,MAAM,GAAG,UAiCtC;AAiED,qBAAa,UAAW,SAAQ,KAAK;IACnC,OAAO,EAAE,cAAc,CAAC;gBACZ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;CAKrD;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}