agent-cost-guardrails 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cortex
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,163 @@
+# agent-cost-guardrails
+
+[![npm version](https://img.shields.io/npm/v/agent-cost-guardrails)](https://www.npmjs.com/package/agent-cost-guardrails)
+[![PyPI version](https://img.shields.io/pypi/v/agent-cost-guardrails)](https://pypi.org/project/agent-cost-guardrails/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+Budget limits and cost guardrails for AI agents. Prevents runaway API spend with hard budget enforcement, circuit breakers, and per-agent cost tracking.
+
+**Zero infrastructure required** — no gateway, no proxy, no external service. Pure JavaScript/TypeScript middleware that hooks into your agent at the process level.
+
+Also available for Python: `pip install agent-cost-guardrails`
+
+## Features
+
+- Hard budget limits with `BudgetExceededError` on overspend
+- Per-call token limits and tokens-per-minute rate limiting
+- Circuit breaker that trips after N consecutive violations
+- Alert callbacks at configurable thresholds (50%, 80%, 100%)
+- Cost breakdown by model and agent
+- Bundled pricing for 30+ models (OpenAI, Anthropic, Google, Mistral, DeepSeek, Meta)
+- Custom pricing overrides for any model
+- Full TypeScript support
+
+## Installation
+
+```bash
+npm install agent-cost-guardrails
+```
+
+## Quick Start
+
+### Context Manager Style
+
+```typescript
+import { BudgetGuard } from 'agent-cost-guardrails';
+
+const guard = new BudgetGuard({ maxUsd: 5.00 });
+
+// Before each LLM call
+guard.preCallCheck(estimatedTokens);
+
+// After each LLM call - record actual usage
+const cost = guard.postCallRecord('gpt-4o', inputTokens, outputTokens);
+
+console.log(guard.costReport());
+```
+
+### Async Wrapper
+
+```typescript
+import { BudgetGuard } from 'agent-cost-guardrails';
+
+const guard = new BudgetGuard({ maxUsd: 5.00 });
+const result = await guard.run(async (g) => {
+  g.preCallCheck();
+  const response = await callLLM();
+  g.postCallRecord('gpt-4o', response.usage.prompt_tokens, response.usage.completion_tokens);
+  return response;
+});
+
+console.log(guard.costReport());
+```
+
+### Functional Style
+
+```typescript
+import { withBudget } from 'agent-cost-guardrails';
+
+const report = withBudget({ maxUsd: 5.00 }, (guard) => {
+  guard.preCallCheck();
+  guard.postCallRecord('gpt-4o', 1000, 500);
+  return guard.costReport();
+});
+```
+
+## Alert Callbacks
+
+```typescript
+import { BudgetGuard } from 'agent-cost-guardrails';
+
+const guard = new BudgetGuard({
+  maxUsd: 10.00,
+  alertThresholds: [0.5, 0.8, 1.0],
+  onAlert: (threshold, currentCost, maxBudget) => {
+    console.warn(`ALERT: ${threshold * 100}% budget used ($${currentCost.toFixed(4)}/$${maxBudget.toFixed(2)})`);
+  },
+});
+```
+
+## Custom Pricing
+
+```typescript
+import { setCustomPricing } from 'agent-cost-guardrails';
+
+setCustomPricing({
+  'my-fine-tuned-model': {
+    input_per_mtok: 5.0,   // $5.00 per 1M input tokens
+    output_per_mtok: 15.0, // $15.00 per 1M output tokens
+  }
+});
+```
+
+## Cost Report
+
+```typescript
+const report = guard.costReport();
+// {
+//   totalCostUsd: 0.0325,
+//   totalInputTokens: 5000,
+//   totalOutputTokens: 2000,
+//   totalCalls: 3,
+//   budgetUsd: 10.0,
+//   remainingUsd: 9.9675,
+//   costByModel: { 'gpt-4o': 0.0325 },
+//   costByAgent: { 'agent-1': 0.02, 'agent-2': 0.0125 },
+//   tokensByModel: { 'gpt-4o': { input: 5000, output: 2000 } }
+// }
+```
+
+## Error Handling
+
+```typescript
+import {
+  BudgetGuard,
+  BudgetExceededError,
+  CircuitBreakerTrippedError,
+  RateLimitExceededError,
+} from 'agent-cost-guardrails';
+
+const guard = new BudgetGuard({ maxUsd: 1.0, circuitBreakerMaxViolations: 3 });
+
+try {
+  guard.preCallCheck(estimatedTokens);
+  // ... call LLM ...
+  guard.postCallRecord('gpt-4o', inputTokens, outputTokens);
+} catch (e) {
+  if (e instanceof BudgetExceededError) {
+    console.error(`Budget exceeded: $${e.spent.toFixed(4)} / $${e.budget}`);
+  } else if (e instanceof CircuitBreakerTrippedError) {
+    console.error(`Circuit breaker tripped (${e.violations} violations)`);
+    guard.reset(); // Reset to restore
+  } else if (e instanceof RateLimitExceededError) {
+    console.error(`Rate limit: ${e.tokensPerMin} tokens/min (limit: ${e.limit})`);
+  }
+}
+```
+
+## Supported Models (Bundled Pricing)
+
+| Provider | Models |
+|----------|--------|
+| **OpenAI** | gpt-4o, gpt-4o-mini, gpt-4-turbo, gpt-4, gpt-3.5-turbo, o1, o1-mini, o1-pro, o3-mini, gpt-4.1, gpt-4.1-mini, gpt-4.1-nano |
+| **Anthropic** | claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5-20251001, claude-3-5-sonnet-20241022, claude-3-5-haiku-20241022, claude-3-opus, claude-3-sonnet, claude-3-haiku |
+| **Google** | gemini-2.0-flash, gemini-2.0-pro, gemini-1.5-pro, gemini-1.5-flash |
+| **Mistral** | mistral-large-latest, mistral-small-latest |
+| **DeepSeek** | deepseek-chat, deepseek-reasoner |
+| **Meta** | llama-3.1-405b, llama-3.1-70b, llama-3.1-8b |
+
+Unknown models return `0` cost (won't crash). Use `setCustomPricing()` for unlisted models.
+
+## License
+
+MIT

package/dist/core.d.ts

@@ -0,0 +1,81 @@
+import { CustomPricing } from './pricing';
+export type AlertCallback = (threshold: number, currentCost: number, maxBudget: number) => void;
+export interface BudgetConfig {
+    maxUsd: number;
+    maxTokensPerCall?: number;
+    maxTokensPerMinute?: number;
+    alertThresholds: number[];
+    circuitBreakerMaxViolations: number;
+    onAlert?: AlertCallback;
+    customPricing?: CustomPricing;
+}
+export interface CostReport {
+    totalCostUsd: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCalls: number;
+    budgetUsd: number;
+    remainingUsd: number;
+    costByModel: Record<string, number>;
+    costByAgent: Record<string, number>;
+    tokensByModel: Record<string, {
+        input: number;
+        output: number;
+    }>;
+}
+export declare class CostTracker {
+    private config;
+    private totalCost;
+    private totalInputTokens;
+    private totalOutputTokens;
+    private calls;
+    private costByModel;
+    private costByAgent;
+    private tokensByModel;
+    private tokenLog;
+    private alertedThresholds;
+    constructor(config: BudgetConfig);
+    get currentCost(): number;
+    get currentCalls(): number;
+    get remainingBudget(): number;
+    checkBudget(): void;
+    checkRateLimit(tokens: number): void;
+    record(model: string, inputTokens: number, outputTokens: number, agentId?: string): number;
+    private checkAlerts;
+    costReport(): CostReport;
+    reset(): void;
+}
+export declare class CircuitBreaker {
+    private maxViolations;
+    private violationCount;
+    private tripped;
+    constructor(maxViolations?: number);
+    get isTripped(): boolean;
+    get violations(): number;
+    recordViolation(): void;
+    recordSuccess(): void;
+    check(): void;
+    reset(): void;
+}
+export interface BudgetGuardOptions {
+    maxUsd?: number;
+    maxTokensPerCall?: number;
+    maxTokensPerMinute?: number;
+    alertThresholds?: number[];
+    circuitBreakerMaxViolations?: number;
+    onAlert?: AlertCallback;
+    customPricing?: CustomPricing;
+}
+export declare class BudgetGuard {
+    config: BudgetConfig;
+    tracker: CostTracker;
+    circuitBreaker: CircuitBreaker;
+    constructor(options?: BudgetGuardOptions);
+    preCallCheck(estimatedTokens?: number): void;
+    postCallRecord(model: string, inputTokens: number, outputTokens: number, agentId?: string): number;
+    costReport(): CostReport;
+    reset(): void;
+    run<T>(fn: (guard: BudgetGuard) => Promise<T>): Promise<T>;
+}
+export declare function withBudget<T>(options: BudgetGuardOptions, fn: (guard: BudgetGuard) => T): T;
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

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

package/dist/core.js

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BudgetGuard = exports.CircuitBreaker = exports.CostTracker = void 0;
+exports.withBudget = withBudget;
+const errors_1 = require("./errors");
+const pricing_1 = require("./pricing");
+class CostTracker {
+    constructor(config) {
+        this.totalCost = 0;
+        this.totalInputTokens = 0;
+        this.totalOutputTokens = 0;
+        this.calls = 0;
+        this.costByModel = {};
+        this.costByAgent = {};
+        this.tokensByModel = {};
+        this.tokenLog = []; // [timestamp_ms, tokens]
+        this.alertedThresholds = new Set();
+        this.config = config;
+    }
+    get currentCost() {
+        return this.totalCost;
+    }
+    get currentCalls() {
+        return this.calls;
+    }
+    get remainingBudget() {
+        return Math.max(0, this.config.maxUsd - this.totalCost);
+    }
+    checkBudget() {
+        if (this.totalCost >= this.config.maxUsd) {
+            throw new errors_1.BudgetExceededError(`Budget exceeded: $${this.totalCost.toFixed(4)} >= $${this.config.maxUsd.toFixed(2)}`, this.totalCost, this.config.maxUsd);
+        }
+    }
+    checkRateLimit(tokens) {
+        if (!this.config.maxTokensPerMinute)
+            return;
+        const now = Date.now();
+        const cutoff = now - 60000;
+        this.tokenLog = this.tokenLog.filter(([t]) => t > cutoff);
+        const recentTokens = this.tokenLog.reduce((sum, [, c]) => sum + c, 0) + tokens;
+        if (recentTokens > this.config.maxTokensPerMinute) {
+            throw new errors_1.RateLimitExceededError(`Rate limit: ${recentTokens} tokens/min exceeds ${this.config.maxTokensPerMinute}`, recentTokens, this.config.maxTokensPerMinute);
+        }
+    }
+    record(model, inputTokens, outputTokens, agentId = 'default') {
+        var _a, _b;
+        const cost = (0, pricing_1.calculateCost)(model, inputTokens, outputTokens, this.config.customPricing);
+        this.totalCost += cost;
+        this.totalInputTokens += inputTokens;
+        this.totalOutputTokens += outputTokens;
+        this.calls += 1;
+        this.costByModel[model] = ((_a = this.costByModel[model]) !== null && _a !== void 0 ? _a : 0) + cost;
+        this.costByAgent[agentId] = ((_b = this.costByAgent[agentId]) !== null && _b !== void 0 ? _b : 0) + cost;
+        if (!this.tokensByModel[model])
+            this.tokensByModel[model] = { input: 0, output: 0 };
+        this.tokensByModel[model].input += inputTokens;
+        this.tokensByModel[model].output += outputTokens;
+        this.tokenLog.push([Date.now(), inputTokens + outputTokens]);
+        this.checkAlerts(this.totalCost, this.config.maxUsd);
+        return cost;
+    }
+    checkAlerts(currentCost, maxUsd) {
+        if (!this.config.onAlert)
+            return;
+        const ratio = maxUsd > 0 ? currentCost / maxUsd : 0;
+        for (const threshold of this.config.alertThresholds) {
+            if (ratio >= threshold && !this.alertedThresholds.has(threshold)) {
+                this.alertedThresholds.add(threshold);
+                this.config.onAlert(threshold, currentCost, maxUsd);
+            }
+        }
+    }
+    costReport() {
+        return {
+            totalCostUsd: parseFloat(this.totalCost.toFixed(6)),
+            totalInputTokens: this.totalInputTokens,
+            totalOutputTokens: this.totalOutputTokens,
+            totalCalls: this.calls,
+            budgetUsd: this.config.maxUsd,
+            remainingUsd: parseFloat(Math.max(0, this.config.maxUsd - this.totalCost).toFixed(6)),
+            costByModel: { ...this.costByModel },
+            costByAgent: { ...this.costByAgent },
+            tokensByModel: Object.fromEntries(Object.entries(this.tokensByModel).map(([k, v]) => [k, { ...v }])),
+        };
+    }
+    reset() {
+        this.totalCost = 0;
+        this.totalInputTokens = 0;
+        this.totalOutputTokens = 0;
+        this.calls = 0;
+        this.costByModel = {};
+        this.costByAgent = {};
+        this.tokensByModel = {};
+        this.tokenLog = [];
+        this.alertedThresholds.clear();
+    }
+}
+exports.CostTracker = CostTracker;
+class CircuitBreaker {
+    constructor(maxViolations = 3) {
+        this.violationCount = 0;
+        this.tripped = false;
+        this.maxViolations = maxViolations;
+    }
+    get isTripped() {
+        return this.tripped;
+    }
+    get violations() {
+        return this.violationCount;
+    }
+    recordViolation() {
+        this.violationCount += 1;
+        if (this.violationCount >= this.maxViolations) {
+            this.tripped = true;
+        }
+    }
+    recordSuccess() {
+        this.violationCount = 0;
+    }
+    check() {
+        if (this.tripped) {
+            throw new errors_1.CircuitBreakerTrippedError(`Circuit breaker tripped after ${this.violationCount} consecutive violations. Call reset() to restore.`, this.violationCount);
+        }
+    }
+    reset() {
+        this.violationCount = 0;
+        this.tripped = false;
+    }
+}
+exports.CircuitBreaker = CircuitBreaker;
+class BudgetGuard {
+    constructor(options = {}) {
+        var _a, _b, _c;
+        this.config = {
+            maxUsd: (_a = options.maxUsd) !== null && _a !== void 0 ? _a : 10.0,
+            maxTokensPerCall: options.maxTokensPerCall,
+            maxTokensPerMinute: options.maxTokensPerMinute,
+            alertThresholds: (_b = options.alertThresholds) !== null && _b !== void 0 ? _b : [0.5, 0.8, 1.0],
+            circuitBreakerMaxViolations: (_c = options.circuitBreakerMaxViolations) !== null && _c !== void 0 ? _c : 3,
+            onAlert: options.onAlert,
+            customPricing: options.customPricing,
+        };
+        this.tracker = new CostTracker(this.config);
+        this.circuitBreaker = new CircuitBreaker(this.config.circuitBreakerMaxViolations);
+    }
+    preCallCheck(estimatedTokens) {
+        this.circuitBreaker.check();
+        this.tracker.checkBudget();
+        if (estimatedTokens !== undefined &&
+            this.config.maxTokensPerCall !== undefined &&
+            estimatedTokens > this.config.maxTokensPerCall) {
+            this.circuitBreaker.recordViolation();
+            throw new errors_1.BudgetExceededError(`Call token estimate ${estimatedTokens} exceeds per-call limit ${this.config.maxTokensPerCall}`, this.tracker.currentCost, this.config.maxUsd);
+        }
+        if (estimatedTokens !== undefined) {
+            this.tracker.checkRateLimit(estimatedTokens);
+        }
+    }
+    postCallRecord(model, inputTokens, outputTokens, agentId = 'default') {
+        const cost = this.tracker.record(model, inputTokens, outputTokens, agentId);
+        if (this.tracker.currentCost >= this.config.maxUsd) {
+            this.circuitBreaker.recordViolation();
+        }
+        else {
+            this.circuitBreaker.recordSuccess();
+        }
+        return cost;
+    }
+    costReport() {
+        return this.tracker.costReport();
+    }
+    reset() {
+        this.tracker.reset();
+        this.circuitBreaker.reset();
+    }
+    async run(fn) {
+        return fn(this);
+    }
+}
+exports.BudgetGuard = BudgetGuard;
+function withBudget(options, fn) {
+    const guard = new BudgetGuard(options);
+    return fn(guard);
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+export declare class GuardrailError extends Error {
+    constructor(message: string);
+}
+export declare class BudgetExceededError extends GuardrailError {
+    spent: number;
+    budget: number;
+    constructor(message: string, spent?: number, budget?: number);
+}
+export declare class CircuitBreakerTrippedError extends GuardrailError {
+    violations: number;
+    constructor(message: string, violations?: number);
+}
+export declare class RateLimitExceededError extends GuardrailError {
+    tokensPerMin: number;
+    limit: number;
+    constructor(message: string, tokensPerMin?: number, limit?: number);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAK5B;AAED,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;gBAEH,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,EAAE,MAAM,SAAI;CAOnD;AAED,qBAAa,0BAA2B,SAAQ,cAAc;IAC5D,UAAU,EAAE,MAAM,CAAC;gBAEP,OAAO,EAAE,MAAM,EAAE,UAAU,SAAI;CAM5C;AAED,qBAAa,sBAAuB,SAAQ,cAAc;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;gBAEF,OAAO,EAAE,MAAM,EAAE,YAAY,SAAI,EAAE,KAAK,SAAI;CAOzD"}

package/dist/errors.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RateLimitExceededError = exports.CircuitBreakerTrippedError = exports.BudgetExceededError = exports.GuardrailError = void 0;
+class GuardrailError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'GuardrailError';
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.GuardrailError = GuardrailError;
+class BudgetExceededError extends GuardrailError {
+    constructor(message, spent = 0, budget = 0) {
+        super(message);
+        this.name = 'BudgetExceededError';
+        this.spent = spent;
+        this.budget = budget;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.BudgetExceededError = BudgetExceededError;
+class CircuitBreakerTrippedError extends GuardrailError {
+    constructor(message, violations = 0) {
+        super(message);
+        this.name = 'CircuitBreakerTrippedError';
+        this.violations = violations;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.CircuitBreakerTrippedError = CircuitBreakerTrippedError;
+class RateLimitExceededError extends GuardrailError {
+    constructor(message, tokensPerMin = 0, limit = 0) {
+        super(message);
+        this.name = 'RateLimitExceededError';
+        this.tokensPerMin = tokensPerMin;
+        this.limit = limit;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.RateLimitExceededError = RateLimitExceededError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,cAAe,SAAQ,KAAK;IACvC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAND,wCAMC;AAED,MAAa,mBAAoB,SAAQ,cAAc;IAIrD,YAAY,OAAe,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,CAAC;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAXD,kDAWC;AAED,MAAa,0BAA2B,SAAQ,cAAc;IAG5D,YAAY,OAAe,EAAE,UAAU,GAAG,CAAC;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AATD,gEASC;AAED,MAAa,sBAAuB,SAAQ,cAAc;IAIxD,YAAY,OAAe,EAAE,YAAY,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAXD,wDAWC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { BudgetGuard, CostTracker, CircuitBreaker, withBudget } from './core';
+export type { BudgetConfig, BudgetGuardOptions, CostReport, AlertCallback } from './core';
+export { BudgetExceededError, CircuitBreakerTrippedError, RateLimitExceededError, GuardrailError } from './errors';
+export { getModelPrice, setCustomPricing, clearCustomPricing, calculateCost } from './pricing';
+export type { ModelPrice, CustomPricing } from './pricing';
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACnH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/F,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE3D,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = exports.calculateCost = exports.clearCustomPricing = exports.setCustomPricing = exports.getModelPrice = exports.GuardrailError = exports.RateLimitExceededError = exports.CircuitBreakerTrippedError = exports.BudgetExceededError = exports.withBudget = exports.CircuitBreaker = exports.CostTracker = exports.BudgetGuard = void 0;
+var core_1 = require("./core");
+Object.defineProperty(exports, "BudgetGuard", { enumerable: true, get: function () { return core_1.BudgetGuard; } });
+Object.defineProperty(exports, "CostTracker", { enumerable: true, get: function () { return core_1.CostTracker; } });
+Object.defineProperty(exports, "CircuitBreaker", { enumerable: true, get: function () { return core_1.CircuitBreaker; } });
+Object.defineProperty(exports, "withBudget", { enumerable: true, get: function () { return core_1.withBudget; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "BudgetExceededError", { enumerable: true, get: function () { return errors_1.BudgetExceededError; } });
+Object.defineProperty(exports, "CircuitBreakerTrippedError", { enumerable: true, get: function () { return errors_1.CircuitBreakerTrippedError; } });
+Object.defineProperty(exports, "RateLimitExceededError", { enumerable: true, get: function () { return errors_1.RateLimitExceededError; } });
+Object.defineProperty(exports, "GuardrailError", { enumerable: true, get: function () { return errors_1.GuardrailError; } });
+var pricing_1 = require("./pricing");
+Object.defineProperty(exports, "getModelPrice", { enumerable: true, get: function () { return pricing_1.getModelPrice; } });
+Object.defineProperty(exports, "setCustomPricing", { enumerable: true, get: function () { return pricing_1.setCustomPricing; } });
+Object.defineProperty(exports, "clearCustomPricing", { enumerable: true, get: function () { return pricing_1.clearCustomPricing; } });
+Object.defineProperty(exports, "calculateCost", { enumerable: true, get: function () { return pricing_1.calculateCost; } });
+exports.VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+BAA8E;AAArE,mGAAA,WAAW,OAAA;AAAE,mGAAA,WAAW,OAAA;AAAE,sGAAA,cAAc,OAAA;AAAE,kGAAA,UAAU,OAAA;AAE7D,mCAAmH;AAA1G,6GAAA,mBAAmB,OAAA;AAAE,oHAAA,0BAA0B,OAAA;AAAE,gHAAA,sBAAsB,OAAA;AAAE,wGAAA,cAAc,OAAA;AAChG,qCAA+F;AAAtF,wGAAA,aAAa,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,wGAAA,aAAa,OAAA;AAG9D,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/dist/pricing.d.ts

@@ -0,0 +1,13 @@
+export interface ModelPrice {
+    inputPerMtok: number;
+    outputPerMtok: number;
+}
+export type CustomPricing = Record<string, {
+    input_per_mtok: number;
+    output_per_mtok: number;
+}>;
+export declare function setCustomPricing(prices: CustomPricing): void;
+export declare function clearCustomPricing(): void;
+export declare function getModelPrice(model: string): ModelPrice | null;
+export declare function calculateCost(model: string, inputTokens: number, outputTokens: number, custom?: CustomPricing): number;
+//# sourceMappingURL=pricing.d.ts.map

package/dist/pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pricing.d.ts","sourceRoot":"","sources":["../src/pricing.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AA8ChG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAO5D;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAS9D;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,aAAa,GACrB,MAAM,CASR"}

package/dist/pricing.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setCustomPricing = setCustomPricing;
+exports.clearCustomPricing = clearCustomPricing;
+exports.getModelPrice = getModelPrice;
+exports.calculateCost = calculateCost;
+// Bundled pricing table — covers major models.
+// Prices are per 1M tokens in USD.
+const PRICING = {
+    // OpenAI
+    'gpt-4o': { inputPerMtok: 2.50, outputPerMtok: 10.00 },
+    'gpt-4o-mini': { inputPerMtok: 0.15, outputPerMtok: 0.60 },
+    'gpt-4-turbo': { inputPerMtok: 10.00, outputPerMtok: 30.00 },
+    'gpt-4': { inputPerMtok: 30.00, outputPerMtok: 60.00 },
+    'gpt-3.5-turbo': { inputPerMtok: 0.50, outputPerMtok: 1.50 },
+    'o1': { inputPerMtok: 15.00, outputPerMtok: 60.00 },
+    'o1-mini': { inputPerMtok: 3.00, outputPerMtok: 12.00 },
+    'o1-pro': { inputPerMtok: 150.00, outputPerMtok: 600.00 },
+    'o3-mini': { inputPerMtok: 1.10, outputPerMtok: 4.40 },
+    'gpt-4.1': { inputPerMtok: 2.00, outputPerMtok: 8.00 },
+    'gpt-4.1-mini': { inputPerMtok: 0.40, outputPerMtok: 1.60 },
+    'gpt-4.1-nano': { inputPerMtok: 0.10, outputPerMtok: 0.40 },
+    // Anthropic
+    'claude-opus-4-6': { inputPerMtok: 15.00, outputPerMtok: 75.00 },
+    'claude-sonnet-4-6': { inputPerMtok: 3.00, outputPerMtok: 15.00 },
+    'claude-haiku-4-5-20251001': { inputPerMtok: 0.80, outputPerMtok: 4.00 },
+    'claude-3-5-sonnet-20241022': { inputPerMtok: 3.00, outputPerMtok: 15.00 },
+    'claude-3-5-haiku-20241022': { inputPerMtok: 0.80, outputPerMtok: 4.00 },
+    'claude-3-opus-20240229': { inputPerMtok: 15.00, outputPerMtok: 75.00 },
+    'claude-3-sonnet-20240229': { inputPerMtok: 3.00, outputPerMtok: 15.00 },
+    'claude-3-haiku-20240307': { inputPerMtok: 0.25, outputPerMtok: 1.25 },
+    // Google
+    'gemini-2.0-flash': { inputPerMtok: 0.10, outputPerMtok: 0.40 },
+    'gemini-2.0-pro': { inputPerMtok: 1.25, outputPerMtok: 10.00 },
+    'gemini-1.5-pro': { inputPerMtok: 1.25, outputPerMtok: 5.00 },
+    'gemini-1.5-flash': { inputPerMtok: 0.075, outputPerMtok: 0.30 },
+    // Mistral
+    'mistral-large-latest': { inputPerMtok: 2.00, outputPerMtok: 6.00 },
+    'mistral-small-latest': { inputPerMtok: 0.10, outputPerMtok: 0.30 },
+    // DeepSeek
+    'deepseek-chat': { inputPerMtok: 0.27, outputPerMtok: 1.10 },
+    'deepseek-reasoner': { inputPerMtok: 0.55, outputPerMtok: 2.19 },
+    // Meta (via providers)
+    'llama-3.1-405b': { inputPerMtok: 3.00, outputPerMtok: 3.00 },
+    'llama-3.1-70b': { inputPerMtok: 0.88, outputPerMtok: 0.88 },
+    'llama-3.1-8b': { inputPerMtok: 0.18, outputPerMtok: 0.18 },
+};
+let customPricing = {};
+function setCustomPricing(prices) {
+    for (const [model, rates] of Object.entries(prices)) {
+        customPricing[model] = {
+            inputPerMtok: rates.input_per_mtok,
+            outputPerMtok: rates.output_per_mtok,
+        };
+    }
+}
+function clearCustomPricing() {
+    customPricing = {};
+}
+function getModelPrice(model) {
+    if (customPricing[model])
+        return customPricing[model];
+    if (PRICING[model])
+        return PRICING[model];
+    // Prefix matching (e.g., "gpt-4o-2024-05-13" -> "gpt-4o")
+    const keys = Object.keys(PRICING).sort((a, b) => b.length - a.length);
+    for (const key of keys) {
+        if (model.startsWith(key))
+            return PRICING[key];
+    }
+    return null;
+}
+function calculateCost(model, inputTokens, outputTokens, custom) {
+    let price = null;
+    if (custom && custom[model]) {
+        price = { inputPerMtok: custom[model].input_per_mtok, outputPerMtok: custom[model].output_per_mtok };
+    }
+    else {
+        price = getModelPrice(model);
+    }
+    if (!price)
+        return 0;
+    return (inputTokens * price.inputPerMtok / 1000000) + (outputTokens * price.outputPerMtok / 1000000);
+}
+//# sourceMappingURL=pricing.js.map

package/dist/pricing.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "agent-cost-guardrails",
+  "version": "0.1.0",
+  "description": "Budget limits and cost guardrails for AI agents. Prevents runaway API spend with hard budget enforcement, circuit breakers, and per-agent cost tracking.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --experimental-vm-modules node_modules/.bin/jest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "cost",
+    "budget",
+    "guardrails",
+    "llm",
+    "openai",
+    "anthropic",
+    "langchain",
+    "langgraph",
+    "token-limit",
+    "circuit-breaker"
+  ],
+  "author": "sapph1re",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sapph1re/agent-cost-guardrails.git"
+  },
+  "homepage": "https://github.com/sapph1re/agent-cost-guardrails",
+  "bugs": {
+    "url": "https://github.com/sapph1re/agent-cost-guardrails/issues"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "^5.9.3"
+  },
+  "jest": {
+    "preset": "ts-jest",
+    "testEnvironment": "node",
+    "testMatch": [
+      "**/tests/**/*.test.ts"
+    ]
+  }
+}