@salimassili/ai-costguard 1.2.0 → 2.0.1

package/benchmarks/run.mjs

@@ -0,0 +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;
+}

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/cli.d.ts

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { type DashboardOptions } from './dashboard.js';
+/**
+ * IO streams used by the CLI runner.
+ */
+export interface CliIO {
+    /** Writes standard output. */
+    stdout(message: string): void;
+    /** Writes standard error. */
+    stderr(message: string): void;
+}
+/**
+ * Parsed options for the aifw check command.
+ */
+export interface CliCheckOptions {
+    /** Budget in USD. */
+    budget: number;
+    /** Model name used for pricing. */
+    model: string;
+    /** Estimated output tokens per step. */
+    tokens: number;
+    /** Estimated input tokens per step. Defaults to 0. */
+    inputTokens: number;
+    /** Maximum number of steps to budget for. */
+    maxSteps: number;
+    /** Custom input price in USD per 1,000 tokens. */
+    inputPricePer1k?: number;
+    /** Custom output price in USD per 1,000 tokens. */
+    outputPricePer1k?: number;
+}
+/**
+ * Parsed options for the local dashboard command.
+ */
+export interface CliDashboardOptions extends DashboardOptions {
+    once: boolean;
+    json: boolean;
+}
+/**
+ * Parses arguments for `aifw check`.
+ */
+export declare function parseCheckArgs(args: readonly string[]): CliCheckOptions;
+/**
+ * Parses arguments for `aifw dashboard`.
+ */
+export declare function parseDashboardArgs(args: readonly string[]): CliDashboardOptions;
+/**
+ * Runs the aifw CLI and returns a process exit code.
+ */
+export declare function runCli(args?: readonly string[], io?: CliIO): number;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAGA,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,8BAA8B;IAC9B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,6BAA6B;IAC7B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,CA0BvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,mBAAmB,CAgC/E;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,GAAE,SAAS,MAAM,EAA0B,EAAE,EAAE,GAAE,KAAiB,GAAG,MAAM,CA4ErG"}

package/dist/cli.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+import { getPricing } from './pricing/index.js';
+import { formatDashboardSummary, getDefaultEventLogPath, startDashboardServer, summarizeDashboard, } from './dashboard.js';
+/**
+ * Parses arguments for `aifw check`.
+ */
+export function parseCheckArgs(args) {
+    const options = new Map();
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (!arg.startsWith('--'))
+            continue;
+        const key = arg.slice(2);
+        const value = args[index + 1];
+        if (!value || value.startsWith('--')) {
+            throw new Error(`Missing value for --${key}`);
+        }
+        options.set(key, value);
+        index += 1;
+    }
+    return {
+        budget: readRequiredNumber(options, 'budget'),
+        model: readRequiredString(options, 'model'),
+        tokens: readRequiredNumber(options, 'tokens'),
+        inputTokens: readOptionalNumber(options, 'input-tokens') ?? 0,
+        maxSteps: Math.max(1, Math.trunc(readOptionalNumber(options, 'max-steps') ?? 1)),
+        inputPricePer1k: readOptionalNumber(options, 'input-price-per-1k'),
+        outputPricePer1k: readOptionalNumber(options, 'output-price-per-1k'),
+    };
+}
+/**
+ * Parses arguments for `aifw dashboard`.
+ */
+export function parseDashboardArgs(args) {
+    const options = new Map();
+    const flags = new Set();
+    for (let index = 0; index < args.length; index++) {
+        const arg = args[index];
+        if (!arg.startsWith('--'))
+            continue;
+        const key = arg.slice(2);
+        if (key === 'once' || key === 'json') {
+            flags.add(key);
+            continue;
+        }
+        const value = args[index + 1];
+        if (!value || value.startsWith('--')) {
+            throw new Error(`Missing value for --${key}`);
+        }
+        options.set(key, value);
+        index += 1;
+    }
+    return {
+        eventLogPath: readOptionalString(options, 'events') ?? getDefaultEventLogPath(),
+        budgetUsd: readOptionalNumber(options, 'budget'),
+        host: readOptionalString(options, 'host'),
+        port: readOptionalNumber(options, 'port'),
+        recentLimit: readOptionalNumber(options, 'recent'),
+        once: flags.has('once'),
+        json: flags.has('json'),
+    };
+}
+/**
+ * Runs the aifw CLI and returns a process exit code.
+ */
+export function runCli(args = process.argv.slice(2), io = defaultIO) {
+    const command = args[0];
+    if (!command || command === '--help' || command === '-h') {
+        io.stdout(helpText());
+        return 0;
+    }
+    if (command !== 'check' && command !== 'dashboard') {
+        io.stderr(`Unknown command: ${command}\n\n${helpText()}`);
+        return 2;
+    }
+    try {
+        if (command === 'dashboard') {
+            const options = parseDashboardArgs(args.slice(1));
+            if (options.once || options.json) {
+                const summary = summarizeDashboard(options);
+                io.stdout(options.json ? JSON.stringify(summary, null, 2) + '\n' : formatDashboardSummary(summary));
+                return 0;
+            }
+            void startDashboardServer(options)
+                .then(({ url }) => {
+                io.stdout(`AI CostGuard dashboard running at ${url}\nReading events from ${options.eventLogPath}\n`);
+            })
+                .catch((error) => {
+                io.stderr(`${error instanceof Error ? error.message : String(error)}\n`);
+                process.exitCode = 2;
+            });
+            return 0;
+        }
+        const options = parseCheckArgs(args.slice(1));
+        const pricing = getPricing(options.model);
+        const hasCustomPricing = options.inputPricePer1k !== undefined || options.outputPricePer1k !== undefined;
+        if (hasCustomPricing && (options.inputPricePer1k === undefined || options.outputPricePer1k === undefined)) {
+            io.stderr('--input-price-per-1k and --output-price-per-1k must be provided together.\n');
+            return 2;
+        }
+        if (!pricing && !hasCustomPricing) {
+            io.stderr(`No pricing found for model "${options.model}". Use a known model or pass --input-price-per-1k and --output-price-per-1k.\n`);
+            return 2;
+        }
+        const inputPer1kTokens = options.inputPricePer1k ?? pricing?.inputPer1kTokens ?? 0;
+        const outputPer1kTokens = options.outputPricePer1k ?? pricing?.outputPer1kTokens ?? 0;
+        const perStepCost = (options.inputTokens / 1000) * inputPer1kTokens + (options.tokens / 1000) * outputPer1kTokens;
+        const projectedCost = perStepCost * options.maxSteps;
+        const ok = projectedCost <= options.budget;
+        io.stdout(JSON.stringify({
+            ok,
+            model: options.model,
+            inputTokensPerStep: options.inputTokens,
+            outputTokensPerStep: options.tokens,
+            maxSteps: options.maxSteps,
+            estimatedCostUsd: roundMoney(projectedCost),
+            budgetUsd: options.budget,
+        }, null, 2) + '\n');
+        return ok ? 0 : 1;
+    }
+    catch (error) {
+        io.stderr(`${error instanceof Error ? error.message : String(error)}\n\n${helpText()}`);
+        return 2;
+    }
+}
+const defaultIO = {
+    stdout: (message) => process.stdout.write(message),
+    stderr: (message) => process.stderr.write(message),
+};
+if (isCliEntry()) {
+    process.exitCode = runCli();
+}
+function readRequiredNumber(options, key) {
+    const value = Number(options.get(key));
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`--${key} must be a non-negative number`);
+    }
+    return value;
+}
+function readOptionalNumber(options, key) {
+    if (!options.has(key))
+        return undefined;
+    return readRequiredNumber(options, key);
+}
+function readRequiredString(options, key) {
+    const value = options.get(key);
+    if (!value?.trim()) {
+        throw new Error(`--${key} is required`);
+    }
+    return value;
+}
+function roundMoney(value) {
+    return Math.round(value * 1_000_000) / 1_000_000;
+}
+function helpText() {
+    return [
+        'Usage:',
+        '  aifw check --budget <usd> --model <model> --tokens <output-tokens> --max-steps <n>',
+        '  aifw dashboard --events .ai-costguard/events.jsonl --budget <usd>',
+        '  ai-costguard dashboard --once --json',
+        '',
+        'Notes:',
+        '  --tokens is per-step output tokens. Use --input-tokens for input token estimates.',
+        '  For custom models, pass --input-price-per-1k and --output-price-per-1k.',
+        '  The dashboard is local-only and reads an opt-in JSONL event log.',
+        '  Exit code 0 means projected cost is within budget; 1 means over budget; 2 means usage/config error.',
+        '',
+    ].join('\n');
+}
+function readOptionalString(options, key) {
+    const value = options.get(key);
+    return value?.trim() ? value.trim() : undefined;
+}
+function isCliEntry() {
+    const entry = process.argv[1] ?? '';
+    return /(^|[/\\])cli\.js$/u.test(entry);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/core/CostGuard.d.ts

@@ -1,7 +1,6 @@
-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 { guard, guardFunction, GuardError, middleware } from './GuardFree.js';
+export type { GuardedClient, GuardEventControls } from './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 './types.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,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"}
+{"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,4 +1,3 @@
-export { guard, GuardError, middleware } from './GuardFree.js';
-export { GuardPro, validateLicense, getProGuard } from './GuardPro.js';
-export { getPricing, registerPricing, listPricing } from '../pricing/index.js';
+export { guard, guardFunction, GuardError, middleware } from './GuardFree.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,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"}
+{"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"}