@salimassili/ai-costguard 2.0.0 → 2.0.1

package/benchmarks/run.mjs

@@ -1,229 +1,229 @@
-import { performance } from 'node:perf_hooks';
-import { guardFunction } from '../dist/index.js';
-import { GuardCore, GuardError } from '../dist/core/GuardCore.js';
-import { estimateRequestTokens } from '../dist/core/tokenizer.js';
-
-const iterations = readIterations(process.argv.slice(2));
-
-const result = {
-  generatedAt: new Date().toISOString(),
-  node: process.version,
-  platform: process.platform,
-  iterations,
-  runtimeOverhead: await measureRuntimeOverhead(iterations),
-  memoryOverhead: await measureMemoryOverhead(Math.max(250, Math.min(iterations, 2000))),
-  falsePositiveScenarios: measureFalsePositiveScenarios(),
-  loopDetectionBehavior: measureLoopDetectionBehavior(),
-  costEstimationBoundaries: measureCostEstimationBoundaries(),
-};
-
-console.log(JSON.stringify(result, null, 2));
-
-async function measureRuntimeOverhead(count) {
-  async function directCall(request) {
-    return { ok: true, usage: { prompt_tokens: 12, completion_tokens: request.max_tokens ?? 8 } };
-  }
-
-  const guardedCall = guardFunction(directCall, {
-    budget: 1_000,
-    behaviorAnalysis: false,
-    scope: { projectId: 'benchmark' },
-  });
-
-  const request = {
-    model: 'gpt-4o-mini',
-    prompt: 'benchmark request',
-    max_tokens: 8,
-  };
-
-  await warmup(directCall, guardedCall, request);
-
-  const directMs = await timeAsync(count, () => directCall(request));
-  const guardedMs = await timeAsync(count, () => guardedCall(request));
-  const directPerCallMs = directMs / count;
-  const guardedPerCallMs = guardedMs / count;
-
-  return {
-    directTotalMs: round(directMs, 3),
-    guardedTotalMs: round(guardedMs, 3),
-    directPerCallMs: round(directPerCallMs, 6),
-    guardedPerCallMs: round(guardedPerCallMs, 6),
-    addedPerCallMs: round(guardedPerCallMs - directPerCallMs, 6),
-  };
-}
-
-async function measureMemoryOverhead(count) {
-  const guardedCall = guardFunction(
-    async (request) => ({ ok: true, usage: { prompt_tokens: 12, completion_tokens: request.max_tokens ?? 8 } }),
-    {
-      budget: 1_000,
-      maxHistory: count,
-      loopMinRepeats: count + 1,
-      scope: { projectId: 'memory-benchmark' },
-    }
-  );
-
-  collectGarbageIfAvailable();
-  const beforeBytes = process.memoryUsage().heapUsed;
-
-  for (let index = 0; index < count; index++) {
-    await guardedCall({
-      model: 'gpt-4o-mini',
-      prompt: `memory benchmark unique prompt ${index}`,
-      max_tokens: 8,
-    });
-  }
-
-  collectGarbageIfAvailable();
-  const afterBytes = process.memoryUsage().heapUsed;
-
-  return {
-    calls: count,
-    heapDeltaBytes: afterBytes - beforeBytes,
-    heapDeltaPerCallBytes: round((afterBytes - beforeBytes) / count, 2),
-    gcAvailable: typeof globalThis.gc === 'function',
-    note: 'Heap measurements are process-local and noisy unless Node is run with --expose-gc.',
-  };
-}
-
-function measureFalsePositiveScenarios() {
-  const core = new GuardCore({
-    budget: 1,
-    retryThreshold: 2,
-    loopSimilarityThreshold: 0.9,
-    scope: { projectId: 'false-positive-benchmark' },
-  });
-  const prompts = [
-    'again compare the two product options',
-    'again summarize the second option with different tradeoffs',
-    'again write a new title for the launch note',
-  ];
-  let blocked = 0;
-
-  for (const prompt of prompts) {
-    try {
-      core.check(context(prompt));
-    } catch (error) {
-      if (error instanceof GuardError) blocked += 1;
-      else throw error;
-    }
-  }
-
-  return {
-    scenario: 'Repeated benign "again" prompts without failure/error language',
-    prompts: prompts.length,
-    blocked,
-  };
-}
-
-function measureLoopDetectionBehavior() {
-  const core = new GuardCore({
-    budget: 1,
-    loopSimilarityThreshold: 0.9,
-    loopMinRepeats: 2,
-    scope: { projectId: 'loop-benchmark' },
-  });
-  const prompt = 'summarize the same tool observation and continue the agent plan';
-
-  for (let step = 1; step <= 5; step++) {
-    try {
-      core.check(context(prompt));
-    } catch (error) {
-      if (error instanceof GuardError) {
-        return {
-          repeatedPrompt: prompt,
-          blockedAtStep: step,
-          code: error.code,
-          reason: error.message,
-        };
-      }
-
-      throw error;
-    }
-  }
-
-  return {
-    repeatedPrompt: prompt,
-    blockedAtStep: null,
-  };
-}
-
-function measureCostEstimationBoundaries() {
-  const samples = [
-    { label: 'short chat', request: { messages: [{ role: 'user', content: 'hello' }], max_tokens: 32 } },
-    {
-      label: 'long instruction',
-      request: {
-        messages: [{ role: 'user', content: 'Summarize the following requirements. '.repeat(120) }],
-        max_tokens: 256,
-      },
-    },
-    {
-      label: 'code-heavy prompt',
-      request: {
-        prompt: 'function example(value) { return value.map((item) => item.id).join(","); }\n'.repeat(40),
-        max_tokens: 128,
-      },
-    },
-  ];
-
-  return {
-    tokenizer: 'dependency-free estimator',
-    doesNotClaimProviderExactness: true,
-    samples: samples.map((sample) => {
-      const estimate = estimateRequestTokens(sample.request);
-      return {
-        label: sample.label,
-        inputTokens: estimate.inputTokens,
-        outputTokens: estimate.outputTokens,
-        totalTokens: estimate.tokens,
-      };
-    }),
-  };
-}
-
-async function warmup(directCall, guardedCall, request) {
-  for (let index = 0; index < 100; index++) {
-    await directCall(request);
-    await guardedCall(request);
-  }
-}
-
-async function timeAsync(count, fn) {
-  const start = performance.now();
-  for (let index = 0; index < count; index++) {
-    await fn();
-  }
-  return performance.now() - start;
-}
-
-function context(prompt) {
-  return {
-    model: 'gpt-4o-mini',
-    pricingKnown: true,
-    tokens: 100,
-    inputTokens: 40,
-    outputTokens: 60,
-    estimatedCost: 0.0001,
-    timestamp: Date.now(),
-    prompt,
-  };
-}
-
-function collectGarbageIfAvailable() {
-  if (typeof globalThis.gc === 'function') {
-    globalThis.gc();
-  }
-}
-
-function readIterations(args) {
-  const index = args.indexOf('--iterations');
-  if (index === -1) return 5000;
-  const value = Number(args[index + 1]);
-  return Number.isFinite(value) && value > 0 ? Math.trunc(value) : 5000;
-}
-
-function round(value, digits) {
-  const factor = 10 ** digits;
-  return Math.round(value * factor) / factor;
-}
+import { performance } from 'node:perf_hooks';
+import { guardFunction } from '../dist/index.js';
+import { GuardCore, GuardError } from '../dist/core/GuardCore.js';
+import { estimateRequestTokens } from '../dist/core/tokenizer.js';
+
+const iterations = readIterations(process.argv.slice(2));
+
+const result = {
+  generatedAt: new Date().toISOString(),
+  node: process.version,
+  platform: process.platform,
+  iterations,
+  runtimeOverhead: await measureRuntimeOverhead(iterations),
+  memoryOverhead: await measureMemoryOverhead(Math.max(250, Math.min(iterations, 2000))),
+  falsePositiveScenarios: measureFalsePositiveScenarios(),
+  loopDetectionBehavior: measureLoopDetectionBehavior(),
+  costEstimationBoundaries: measureCostEstimationBoundaries(),
+};
+
+console.log(JSON.stringify(result, null, 2));
+
+async function measureRuntimeOverhead(count) {
+  async function directCall(request) {
+    return { ok: true, usage: { prompt_tokens: 12, completion_tokens: request.max_tokens ?? 8 } };
+  }
+
+  const guardedCall = guardFunction(directCall, {
+    budget: 1_000,
+    behaviorAnalysis: false,
+    scope: { projectId: 'benchmark' },
+  });
+
+  const request = {
+    model: 'gpt-4o-mini',
+    prompt: 'benchmark request',
+    max_tokens: 8,
+  };
+
+  await warmup(directCall, guardedCall, request);
+
+  const directMs = await timeAsync(count, () => directCall(request));
+  const guardedMs = await timeAsync(count, () => guardedCall(request));
+  const directPerCallMs = directMs / count;
+  const guardedPerCallMs = guardedMs / count;
+
+  return {
+    directTotalMs: round(directMs, 3),
+    guardedTotalMs: round(guardedMs, 3),
+    directPerCallMs: round(directPerCallMs, 6),
+    guardedPerCallMs: round(guardedPerCallMs, 6),
+    addedPerCallMs: round(guardedPerCallMs - directPerCallMs, 6),
+  };
+}
+
+async function measureMemoryOverhead(count) {
+  const guardedCall = guardFunction(
+    async (request) => ({ ok: true, usage: { prompt_tokens: 12, completion_tokens: request.max_tokens ?? 8 } }),
+    {
+      budget: 1_000,
+      maxHistory: count,
+      loopMinRepeats: count + 1,
+      scope: { projectId: 'memory-benchmark' },
+    }
+  );
+
+  collectGarbageIfAvailable();
+  const beforeBytes = process.memoryUsage().heapUsed;
+
+  for (let index = 0; index < count; index++) {
+    await guardedCall({
+      model: 'gpt-4o-mini',
+      prompt: `memory benchmark unique prompt ${index}`,
+      max_tokens: 8,
+    });
+  }
+
+  collectGarbageIfAvailable();
+  const afterBytes = process.memoryUsage().heapUsed;
+
+  return {
+    calls: count,
+    heapDeltaBytes: afterBytes - beforeBytes,
+    heapDeltaPerCallBytes: round((afterBytes - beforeBytes) / count, 2),
+    gcAvailable: typeof globalThis.gc === 'function',
+    note: 'Heap measurements are process-local and noisy unless Node is run with --expose-gc.',
+  };
+}
+
+function measureFalsePositiveScenarios() {
+  const core = new GuardCore({
+    budget: 1,
+    retryThreshold: 2,
+    loopSimilarityThreshold: 0.9,
+    scope: { projectId: 'false-positive-benchmark' },
+  });
+  const prompts = [
+    'again compare the two product options',
+    'again summarize the second option with different tradeoffs',
+    'again write a new title for the launch note',
+  ];
+  let blocked = 0;
+
+  for (const prompt of prompts) {
+    try {
+      core.check(context(prompt));
+    } catch (error) {
+      if (error instanceof GuardError) blocked += 1;
+      else throw error;
+    }
+  }
+
+  return {
+    scenario: 'Repeated benign "again" prompts without failure/error language',
+    prompts: prompts.length,
+    blocked,
+  };
+}
+
+function measureLoopDetectionBehavior() {
+  const core = new GuardCore({
+    budget: 1,
+    loopSimilarityThreshold: 0.9,
+    loopMinRepeats: 2,
+    scope: { projectId: 'loop-benchmark' },
+  });
+  const prompt = 'summarize the same tool observation and continue the agent plan';
+
+  for (let step = 1; step <= 5; step++) {
+    try {
+      core.check(context(prompt));
+    } catch (error) {
+      if (error instanceof GuardError) {
+        return {
+          repeatedPrompt: prompt,
+          blockedAtStep: step,
+          code: error.code,
+          reason: error.message,
+        };
+      }
+
+      throw error;
+    }
+  }
+
+  return {
+    repeatedPrompt: prompt,
+    blockedAtStep: null,
+  };
+}
+
+function measureCostEstimationBoundaries() {
+  const samples = [
+    { label: 'short chat', request: { messages: [{ role: 'user', content: 'hello' }], max_tokens: 32 } },
+    {
+      label: 'long instruction',
+      request: {
+        messages: [{ role: 'user', content: 'Summarize the following requirements. '.repeat(120) }],
+        max_tokens: 256,
+      },
+    },
+    {
+      label: 'code-heavy prompt',
+      request: {
+        prompt: 'function example(value) { return value.map((item) => item.id).join(","); }\n'.repeat(40),
+        max_tokens: 128,
+      },
+    },
+  ];
+
+  return {
+    tokenizer: 'dependency-free estimator',
+    doesNotClaimProviderExactness: true,
+    samples: samples.map((sample) => {
+      const estimate = estimateRequestTokens(sample.request);
+      return {
+        label: sample.label,
+        inputTokens: estimate.inputTokens,
+        outputTokens: estimate.outputTokens,
+        totalTokens: estimate.tokens,
+      };
+    }),
+  };
+}
+
+async function warmup(directCall, guardedCall, request) {
+  for (let index = 0; index < 100; index++) {
+    await directCall(request);
+    await guardedCall(request);
+  }
+}
+
+async function timeAsync(count, fn) {
+  const start = performance.now();
+  for (let index = 0; index < count; index++) {
+    await fn();
+  }
+  return performance.now() - start;
+}
+
+function context(prompt) {
+  return {
+    model: 'gpt-4o-mini',
+    pricingKnown: true,
+    tokens: 100,
+    inputTokens: 40,
+    outputTokens: 60,
+    estimatedCost: 0.0001,
+    timestamp: Date.now(),
+    prompt,
+  };
+}
+
+function collectGarbageIfAvailable() {
+  if (typeof globalThis.gc === 'function') {
+    globalThis.gc();
+  }
+}
+
+function readIterations(args) {
+  const index = args.indexOf('--iterations');
+  if (index === -1) return 5000;
+  const value = Number(args[index + 1]);
+  return Number.isFinite(value) && value > 0 ? Math.trunc(value) : 5000;
+}
+
+function round(value, digits) {
+  const factor = 10 ** digits;
+  return Math.round(value * factor) / factor;
+}

package/benchmarks/token-accuracy.mjs

@@ -0,0 +1,86 @@
+import { estimateTokensFromText } from '../dist/core/tokenizer.js';
+
+const corpus = [
+  { label: 'support summary', text: 'Summarize this support ticket in two bullets.', referenceTokens: 9 },
+  {
+    label: 'agent instruction',
+    text: 'You are an agent. Use the search tool, then cite the result in JSON.',
+    referenceTokens: 16,
+  },
+  {
+    label: 'retry guard',
+    text: 'The database migration failed with timeout 504. Retry only if the previous step is idempotent.',
+    referenceTokens: 19,
+  },
+  {
+    label: 'typescript code',
+    text: 'function normalizeUser(user) { return { id: user.id, email: user.email?.toLowerCase() }; }',
+    referenceTokens: 24,
+  },
+  {
+    label: 'model comparison',
+    text: 'Compare Claude Haiku and GPT-4o mini for a budget-sensitive chatbot.',
+    referenceTokens: 17,
+  },
+  {
+    label: 'customer apology',
+    text: 'Write a concise customer apology for a delayed shipment and include one next step.',
+    referenceTokens: 16,
+  },
+  {
+    label: 'log line',
+    text: 'Analyze these logs: ERROR rate_limit_exceeded request_id=req_123 retry_after=2s',
+    referenceTokens: 24,
+  },
+  {
+    label: 'interface request',
+    text: 'Create a TypeScript interface for a webhook payload with cost, model, and reason fields.',
+    referenceTokens: 17,
+  },
+];
+
+const samples = corpus.map((sample) => {
+  const estimatedTokens = estimateTokensFromText(sample.text);
+  const absoluteError = Math.abs(estimatedTokens - sample.referenceTokens);
+  const percentError = (absoluteError / sample.referenceTokens) * 100;
+
+  return {
+    label: sample.label,
+    estimatedTokens,
+    referenceTokens: sample.referenceTokens,
+    absoluteError,
+    percentError: round(percentError, 2),
+  };
+});
+
+const percentErrors = samples.map((sample) => sample.percentError).sort((a, b) => a - b);
+const report = {
+  generatedAt: new Date().toISOString(),
+  reference: {
+    tokenizer: 'gpt-tokenizer cl100k_base fixture counts',
+    note:
+      'Reference counts are fixed corpus fixtures, not live provider calls. Use this to understand estimator bias, not to claim exact tokenizer parity.',
+  },
+  sampleCount: samples.length,
+  averageErrorPercent: round(average(percentErrors), 2),
+  medianErrorPercent: round(median(percentErrors), 2),
+  maxErrorPercent: Math.max(...percentErrors),
+  samples,
+};
+
+console.log(JSON.stringify(report, null, 2));
+
+function average(values) {
+  return values.reduce((total, value) => total + value, 0) / values.length;
+}
+
+function median(values) {
+  const midpoint = Math.floor(values.length / 2);
+  if (values.length % 2 === 1) return values[midpoint];
+  return (values[midpoint - 1] + values[midpoint]) / 2;
+}
+
+function round(value, digits) {
+  const factor = 10 ** digits;
+  return Math.round(value * factor) / factor;
+}

package/dist/core/CostGuard.d.ts

@@ -1,6 +1,6 @@
 export { guard, guardFunction, GuardError, middleware } from './GuardFree.js';
 export type { GuardedClient, GuardEventControls } from './GuardFree.js';
-export { getPricing, registerPricing, listPricing } from '../pricing/index.js';
+export { BUILTIN_PRICING_LAST_UPDATED, getPricing, registerPricing, listPricing } from '../pricing/index.js';
 export type { ModelPricing } from '../pricing/index.js';
 export type { GuardConfig, GuardErrorCode, GuardEvent, GuardEventHandler, GuardEventName, GuardScope, GuardState, GuardWebhookConfig, RequestContext, } 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,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC"}
+{"version":3,"file":"CostGuard.d.ts","sourceRoot":"","sources":["../../src/core/CostGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9E,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,4BAA4B,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7G,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,UAAU,EACV,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC"}

package/dist/core/CostGuard.js

@@ -1,3 +1,3 @@
 export { guard, guardFunction, GuardError, middleware } from './GuardFree.js';
-export { getPricing, registerPricing, listPricing } from '../pricing/index.js';
+export { BUILTIN_PRICING_LAST_UPDATED, 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":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"CostGuard.js","sourceRoot":"","sources":["../../src/core/CostGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAAE,4BAA4B,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/core/GuardPro.d.ts

@@ -34,8 +34,6 @@ export interface GuardProConfig {
     discordWebhook?: string;
     /** Combined webhook configuration. */
     webhooks?: GuardWebhookConfig;
-    /** Deprecated compatibility field. GuardPro does not enforce licenses locally. */
-    licenseKey?: string;
     /** Optional Redis-compatible client. When omitted, GuardPro pools ioredis clients by URL. */
     redisClient?: GuardProRedisClient;
 }
@@ -90,18 +88,8 @@ export declare class GuardPro {
     private getSpendKey;
     private createContext;
 }
-/**
- * Deprecated compatibility helper.
- *
- * This is a format sanity check only. It is not license enforcement and should
- * not be used for commercial access control.
- */
-export declare function validateLicense(key: string): boolean;
 /**
  * Creates GuardPro.
- *
- * The return type remains nullable for backwards compatibility with older
- * callers, but local license rejection has intentionally been removed.
  */
-export declare function getProGuard(config: GuardProConfig): GuardPro | null;
+export declare function getProGuard(config: GuardProConfig): GuardPro;
 //# sourceMappingURL=GuardPro.d.ts.map

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

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

package/dist/core/GuardPro.js

@@ -193,13 +193,13 @@ export class GuardPro {
         }
     }
     async incrementRedis(redis, key, estimatedCost) {
-        const script = `
-      local total = redis.call("INCRBYFLOAT", KEYS[1], ARGV[1])
-      local ttl = redis.call("TTL", KEYS[1])
-      if ttl == -1 then
-        redis.call("EXPIRE", KEYS[1], ARGV[2])
-      end
-      return total
+        const script = `
+      local total = redis.call("INCRBYFLOAT", KEYS[1], ARGV[1])
+      local ttl = redis.call("TTL", KEYS[1])
+      if ttl == -1 then
+        redis.call("EXPIRE", KEYS[1], ARGV[2])
+      end
+      return total
     `;
         const total = await redis.eval(script, 1, key, estimatedCost.toString(), this.windowSeconds.toString());
         return Number(total);
@@ -256,20 +256,8 @@ export class GuardPro {
         };
     }
 }
-/**
- * Deprecated compatibility helper.
- *
- * This is a format sanity check only. It is not license enforcement and should
- * not be used for commercial access control.
- */
-export function validateLicense(key) {
-    return typeof key === 'string' && key.trim().length >= 16;
-}
 /**
  * Creates GuardPro.
- *
- * The return type remains nullable for backwards compatibility with older
- * callers, but local license rejection has intentionally been removed.
  */
 export function getProGuard(config) {
     return new GuardPro(config);