@ekaone/llm-gate 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eka Prasetia <ekaone3033@gmail.com> (https://prasetia.me)
+
+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,345 @@
+# @ekaone/llm-gate
+
+[![llm-gate banner](https://res.cloudinary.com/ddjsyskef/image/upload/v1774001133/Github/gqyyegcemo7sc2eggson.png)](https://res.cloudinary.com/ddjsyskef/image/upload/v1774001133/Github/gqyyegcemo7sc2eggson.png)
+
+> Lightweight LLM budget & token guard. Prevents **Denial of Wallet** attacks with a zero-dependency circuit-breaker state machine.
+
+---
+
+## Why
+
+AI agents can silently burn through your API credits if they enter infinite loops or receive malicious prompts designed to trigger excessive token consumption. `@ekaone/llm-gate` wraps every LLM call with a stateful circuit breaker that tracks token usage, cost, and request frequency — then trips before the damage is done.
+
+```
+OPEN ──(80% threshold)──► THROTTLED ──(100% limit)──► TRIPPED
+ ▲                                                        │
+ └──────────────────(windowMs elapsed)───────────────────┘
+```
+
+---
+
+## Install
+
+```bash
+npm install @ekaone/llm-gate
+```
+
+```bash
+pnpm install @ekaone/llm-gate
+```
+
+```bash
+yarn install @ekaone/llm-gate
+```
+
+---
+
+## Quick Start
+
+```ts
+import { createGate } from "@ekaone/llm-gate"
+
+const gate = createGate({
+  maxTokens:   50_000,   // trip at 50k tokens per window
+  maxBudget:   0.10,     // trip at $0.10 USD per window
+  maxRequests: 100,      // trip at 100 requests per window
+  windowMs:    60_000,   // 1 minute sliding window
+
+  onThrottled: (status) => console.warn("⚠️  Approaching limit", status.tokens),
+  onTripped:   (status) => console.error("🚫 Gate tripped!", status.reason),
+  onReset:     (status) => console.log("✅  Gate reset, window fresh"),
+})
+
+// After every LLM response — feed usage back into the gate
+gate.record({
+  model:        "claude-sonnet-4-20250514",
+  inputTokens:  312,
+  outputTokens: 89,
+})
+
+// Before the next LLM call — check the gate
+const status = gate.check()
+if (!status.allowed) {
+  console.log(`Blocked. Resets at ${status.resets.toLocaleTimeString()}`)
+}
+
+// Or throw-style for agent pipelines
+gate.guard() // throws BudgetExceededError if TRIPPED
+```
+
+---
+
+## API
+
+### `createGate(options)`
+
+Creates a new gate instance. At least one of `maxTokens`, `maxBudget`, or `maxRequests` is required.
+
+```ts
+const gate = createGate(options: GateOptions): GateInstance
+```
+
+#### `GateOptions`
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `maxTokens` | `number` | — | Max total tokens (input + output) per window |
+| `maxBudget` | `number` | — | Max cost in USD per window |
+| `maxRequests` | `number` | — | Max LLM calls per window |
+| `windowMs` | `number` | `60_000` | Window duration in milliseconds |
+| `throttleAt` | `number` | `0.8` | Fraction of limit that triggers `THROTTLED` (0.0–1.0) |
+| `pricing` | `PricingTable` | built-in | Custom model pricing — merged over defaults |
+| `onThrottled` | `(status) => void` | — | Fires once on entry to `THROTTLED` state |
+| `onTripped` | `(status) => void` | — | Fires once on entry to `TRIPPED` state |
+| `onReset` | `(status) => void` | — | Fires when window resets or `reset()` is called |
+
+---
+
+### `gate.record(usage)`
+
+Feed token usage from an LLM response back into the gate. Call this after every successful LLM response.
+
+```ts
+gate.record({
+  model:        "claude-sonnet-4-20250514",
+  inputTokens:  312,
+  outputTokens: 89,
+})
+```
+
+For convenience, use the built-in adapters to map provider responses directly:
+
+```ts
+import { fromAnthropic, fromOpenAI, fromResponse } from "@ekaone/llm-gate"
+
+// Anthropic
+gate.record(fromAnthropic(anthropicResponse))
+
+// OpenAI
+gate.record(fromOpenAI(openaiResponse))
+
+// Auto-detect provider from response shape
+gate.record(fromResponse(anyResponse))
+```
+
+---
+
+### `gate.check()`
+
+Returns the current `GateStatus` — never throws.
+
+```ts
+const status = gate.check()
+
+// status.state     → "OPEN" | "THROTTLED" | "TRIPPED"
+// status.allowed   → boolean
+// status.reason    → string | null
+// status.tokens    → { used, remaining, limit }
+// status.budget    → { used, remaining, limit }
+// status.requests  → { used, remaining, limit }
+// status.resets    → Date
+```
+
+#### Example status when TRIPPED
+
+```ts
+{
+  state:    "TRIPPED",
+  allowed:  false,
+  reason:   "token_limit_exceeded",
+  tokens:   { used: 51_200, remaining: 0,    limit: 50_000 },
+  budget:   { used: 0.094,  remaining: 0.006, limit: 0.10  },
+  requests: { used: 87,     remaining: 13,    limit: 100   },
+  resets:   Date <2026-03-20T09:01:00Z>
+}
+```
+
+---
+
+### `gate.guard()`
+
+Check and throw `BudgetExceededError` if the gate is `TRIPPED`. Ideal for agent pipelines where you want to bail early.
+
+```ts
+try {
+  gate.guard()
+  const response = await llm.call(prompt)
+  gate.record(fromAnthropic(response))
+} catch (err) {
+  if (err instanceof BudgetExceededError) {
+    console.log(err.reason)    // "token_limit_exceeded"
+    console.log(err.resets)    // Date
+    console.log(err.snapshot)  // full GateStatus at time of trip
+  }
+}
+```
+
+---
+
+### `gate.snapshot()`
+
+Read-only view of current state. Identical to `check()` but semantically signals "I'm just observing."
+
+```ts
+const snap = gate.snapshot()
+```
+
+---
+
+### `gate.reset()`
+
+Manually reset the gate to `OPEN` and clear all counters. Useful for new user sessions or test teardown.
+
+```ts
+gate.reset()
+```
+
+---
+
+## Built-in Adapters
+
+Tree-shakeable — only bundled if imported.
+
+```ts
+import { fromAnthropic } from "@ekaone/llm-gate"  // Anthropic only
+import { fromOpenAI }    from "@ekaone/llm-gate"  // OpenAI only
+import { fromResponse }  from "@ekaone/llm-gate"  // auto-detect
+```
+
+---
+
+## Custom Pricing
+
+The built-in pricing table covers common Anthropic and OpenAI models. Override or extend it via the `pricing` option:
+
+```ts
+const gate = createGate({
+  maxBudget: 1.00,
+  pricing: {
+    "my-fine-tuned-model": {
+      inputPerToken:  0.000005,
+      outputPerToken: 0.000015,
+    },
+  },
+})
+```
+
+Custom entries are **merged** over the defaults — you only need to specify models you want to override.
+
+---
+
+## Real Use Cases
+
+### 1. Autonomous agent loop guard
+
+```ts
+const gate = createGate({
+  maxTokens: 200_000,
+  maxBudget: 0.50,
+  onTripped: (s) => alertOps("Agent loop detected", s),
+})
+
+while (agentHasWork()) {
+  gate.guard()                          // bail if budget blown
+  const res = await agent.step()
+  gate.record(fromAnthropic(res))
+}
+```
+
+### 2. Per-user session budget
+
+```ts
+const sessions = new Map<string, ReturnType<typeof createGate>>()
+
+function getGate(userId: string) {
+  if (!sessions.has(userId)) {
+    sessions.set(userId, createGate({
+      maxTokens: 20_000,
+      windowMs:  24 * 60 * 60 * 1000,  // 24h
+    }))
+  }
+  return sessions.get(userId)!
+}
+
+// In your chat handler
+const gate = getGate(req.userId)
+const status = gate.check()
+if (!status.allowed) {
+  return res.status(429).json({
+    error: "Daily limit reached",
+    resets: status.resets,
+  })
+}
+```
+
+### 3. Multi-step RAG pipeline
+
+```ts
+const gate = createGate({ maxTokens: 10_000, maxRequests: 5 })
+
+const retrieved  = await retrieve(query);         gate.record(fromAnthropic(retrieved))
+const reranked   = await rerank(retrieved);       gate.record(fromAnthropic(reranked))
+const summarized = await summarize(reranked);     gate.record(fromAnthropic(summarized))
+
+gate.guard()  // only answer if still within budget
+const answer = await answer(summarized, query);   gate.record(fromAnthropic(answer))
+```
+
+### 4. Dev/test budget cap
+
+```ts
+// vitest setup
+import { createGate } from "@ekaone/llm-gate"
+
+export const testGate = createGate({
+  maxBudget: 0.05,  // $0.05 max spend per test run
+  onTripped: () => { throw new Error("Test suite exceeded LLM budget!") }
+})
+```
+
+---
+
+## How Token Counting Works
+
+`@ekaone/llm-gate` does **not** tokenize text. It reads the `usage` field that every LLM provider returns in the response — this is the authoritative count from the model itself.
+
+```
+You set maxTokens: 50_000
+         ↓
+LLM call happens  (gate doesn't intercept this)
+         ↓
+API returns usage → { input_tokens: 312, output_tokens: 89 }
+         ↓
+gate.record(...)  → tokensUsed += 312 + 89 = 401
+         ↓
+gate.check()      → 401 < 50_000 → OPEN ✅
+```
+
+This means the gate cannot prevent a single oversized request — it stops the **next** call after the limit is hit. This is a deliberate tradeoff: no tokenizer dependency, works across all providers, zero overhead.
+
+---
+
+## TypeScript
+
+Fully typed. All types are exported:
+
+```ts
+import type {
+  GateOptions,
+  GateInstance,
+  GateStatus,
+  GateMetric,
+  CircuitState,
+  TripReason,
+  ThrottleReason,
+  UsageRecord,
+  ModelPricing,
+  PricingTable,
+} from "@ekaone/llm-gate"
+```
+
+---
+
+## License
+
+MIT © [ekaone](https://github.com/ekaone)

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';var f=class extends Error{constructor(t){super(`LLM gate tripped: ${t.reason??"limit_exceeded"}. Resets at ${t.resets.toISOString()}.`),this.name="BudgetExceededError",this.reason=t.reason,this.resets=t.resets,this.snapshot=t,Object.setPrototypeOf(this,new.target.prototype);}};var R={"claude-opus-4-20250514":{inputPerToken:15e-6,outputPerToken:75e-6},"claude-sonnet-4-20250514":{inputPerToken:3e-6,outputPerToken:15e-6},"claude-haiku-4-5-20251001":{inputPerToken:8e-7,outputPerToken:4e-6},"gpt-4o":{inputPerToken:25e-7,outputPerToken:1e-5},"gpt-4o-mini":{inputPerToken:15e-8,outputPerToken:6e-7},"gpt-4-turbo":{inputPerToken:1e-5,outputPerToken:3e-5},o3:{inputPerToken:1e-5,outputPerToken:4e-5},"o4-mini":{inputPerToken:11e-7,outputPerToken:44e-7}};function k(e,t,s,u){let c=u[e];return c?t*c.inputPerToken+s*c.outputPerToken:0}var S=6e4,G=.8,m=1/0;function P(e,t){return {used:e,remaining:t===1/0?1/0:Math.max(0,t-e),limit:t===1/0?-1:t}}function w(e={}){let t=e.maxTokens??m,s=e.maxBudget??m,u=e.maxRequests??m,c=e.windowMs??S,T=e.throttleAt??G,A={...R,...e.pricing};if(t===m&&s===m&&u===m)throw new Error("[llm-gate] At least one limit must be set: maxTokens, maxBudget, or maxRequests.");let i=0,a=0,d=0,o="OPEN",l=Date.now();function g(){let n=Date.now();if(n-l>=c){let r=o;i=0,a=0,d=0,o="OPEN",l=n,r!=="OPEN"&&e.onReset?.(p());}}function p(){let n=new Date(l+c),r=null;return o==="TRIPPED"?i>=t?r="token_limit_exceeded":a>=s?r="budget_limit_exceeded":r="request_limit_exceeded":o==="THROTTLED"&&(i>=t*T?r="approaching_token_limit":a>=s*T?r="approaching_budget_limit":r="approaching_request_limit"),{state:o,allowed:o!=="TRIPPED",reason:r,tokens:P(i,t),budget:P(a,s),requests:P(d,u),resets:n}}function _(){let n=o;if(i>=t||a>=s||d>=u){o="TRIPPED",n!=="TRIPPED"&&e.onTripped?.(p());return}if(i>=t*T||a>=s*T||d>=u*T){o="THROTTLED",n!=="THROTTLED"&&e.onThrottled?.(p());return}o="OPEN";}function I(n){g();let r=k(n.model,n.inputTokens,n.outputTokens,A);i+=n.inputTokens+n.outputTokens,a+=r,d+=1,_();}function y(){return g(),p()}function O(){g();let n=p();if(n.state==="TRIPPED")throw new f(n)}function E(){return p()}function b(){i=0,a=0,d=0,o="OPEN",l=Date.now(),e.onReset?.(p());}return {record:I,check:y,guard:O,snapshot:E,reset:b}}function x(e){return {model:e.model,inputTokens:e.usage.input_tokens,outputTokens:e.usage.output_tokens}}function h(e){return {model:e.model,inputTokens:e.usage.prompt_tokens,outputTokens:e.usage.completion_tokens}}function D(e){return "input_tokens"in e.usage}function L(e){return D(e)?x(e):h(e)}exports.BudgetExceededError=f;exports.createGate=w;exports.defaultPricing=R;exports.fromAnthropic=x;exports.fromOpenAI=h;exports.fromResponse=L;exports.resolveCost=k;//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/index.ts","../src/pricing/index.ts","../src/gate.ts","../src/adapters/index.ts"],"names":["BudgetExceededError","status","defaultPricing","resolveCost","model","inputTokens","outputTokens","pricing","entry","DEFAULT_WINDOW_MS","DEFAULT_THROTTLE","SENTINEL_LIMIT","makeMetric","used","limit","createGate","options","maxTokens","maxBudget","maxRequests","windowMs","throttleAt","tokensUsed","budgetUsed","requestCount","state","windowStart","checkWindowReset","now","prevState","buildStatus","resets","reason","evaluateState","record","usage","cost","check","guard","snapshot","reset","fromAnthropic","response","fromOpenAI","isAnthropic","r","fromResponse"],"mappings":"aAEO,IAAMA,CAAAA,CAAN,cAAkC,KAAM,CAK7C,WAAA,CAAYC,CAAAA,CAAoB,CAC9B,KAAA,CACE,CAAA,kBAAA,EAAqBA,CAAAA,CAAO,MAAA,EAAU,gBAAgB,CAAA,YAAA,EACzCA,CAAAA,CAAO,MAAA,CAAO,WAAA,EAAa,CAAA,CAAA,CAC1C,CAAA,CACA,IAAA,CAAK,IAAA,CAAO,qBAAA,CACZ,IAAA,CAAK,MAAA,CAASA,CAAAA,CAAO,MAAA,CACrB,IAAA,CAAK,MAAA,CAASA,EAAO,MAAA,CACrB,IAAA,CAAK,QAAA,CAAWA,CAAAA,CAGhB,MAAA,CAAO,cAAA,CAAe,IAAA,CAAM,GAAA,CAAA,MAAA,CAAW,SAAS,EAClD,CACF,ECXO,IAAMC,CAAAA,CAA+B,CAE1C,wBAAA,CAA0B,CACxB,aAAA,CAAe,KAAA,CACf,cAAA,CAAgB,KAClB,CAAA,CACA,0BAAA,CAA4B,CAC1B,aAAA,CAAe,IAAA,CACf,cAAA,CAAgB,KAClB,CAAA,CACA,2BAAA,CAA6B,CAC3B,aAAA,CAAe,KACf,cAAA,CAAgB,IAClB,CAAA,CAGA,QAAA,CAAU,CACR,aAAA,CAAe,KAAA,CACf,cAAA,CAAgB,IAClB,CAAA,CACA,aAAA,CAAe,CACb,aAAA,CAAe,KAAA,CACf,cAAA,CAAgB,IAClB,CAAA,CACA,aAAA,CAAe,CACb,aAAA,CAAe,IAAA,CACf,cAAA,CAAgB,IAClB,CAAA,CACA,EAAA,CAAI,CACF,aAAA,CAAe,IAAA,CACf,cAAA,CAAgB,IAClB,CAAA,CACA,SAAA,CAAW,CACT,aAAA,CAAe,KAAA,CACf,cAAA,CAAgB,KAClB,CACF,EAMO,SAASC,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACAC,CAAAA,CACQ,CACR,IAAMC,CAAAA,CAAQD,CAAAA,CAAQH,CAAK,CAAA,CAC3B,OAAKI,CAAAA,CAEHH,CAAAA,CAAcG,CAAAA,CAAM,aAAA,CAAgBF,CAAAA,CAAeE,CAAAA,CAAM,cAAA,CAFxC,CAIrB,CCjDA,IAAMC,CAAAA,CAAoB,GAAA,CACpBC,CAAAA,CAAmB,GACnBC,CAAAA,CAAiB,CAAA,CAAA,CAAA,CAEvB,SAASC,CAAAA,CAAWC,CAAAA,CAAcC,CAAAA,CAA2B,CAC3D,OAAO,CACL,IAAA,CAAAD,CAAAA,CACA,SAAA,CAAWC,CAAAA,GAAU,CAAA,CAAA,CAAA,CAAW,CAAA,CAAA,CAAA,CAAW,IAAA,CAAK,GAAA,CAAI,CAAA,CAAGA,CAAAA,CAAQD,CAAI,CAAA,CACnE,KAAA,CAAOC,CAAAA,GAAU,CAAA,CAAA,CAAA,CAAW,EAAA,CAAKA,CACnC,CACF,CAkBO,SAASC,CAAAA,CAAWC,CAAAA,CAAuB,GAAkB,CAElE,IAAMC,CAAAA,CAAYD,CAAAA,CAAQ,SAAA,EAAaL,CAAAA,CACjCO,CAAAA,CAAYF,CAAAA,CAAQ,SAAA,EAAaL,CAAAA,CACjCQ,CAAAA,CAAcH,CAAAA,CAAQ,WAAA,EAAeL,CAAAA,CACrCS,CAAAA,CAAWJ,CAAAA,CAAQ,QAAA,EAAYP,CAAAA,CAC/BY,CAAAA,CAAaL,CAAAA,CAAQ,UAAA,EAAcN,CAAAA,CACnCH,CAAAA,CAAU,CAAE,GAAGL,CAAAA,CAAgB,GAAGc,CAAAA,CAAQ,OAAQ,CAAA,CAExD,GACEC,CAAAA,GAAcN,GACdO,CAAAA,GAAcP,CAAAA,EACdQ,CAAAA,GAAgBR,CAAAA,CAEhB,MAAM,IAAI,KAAA,CACR,kFACF,CAAA,CAIF,IAAIW,CAAAA,CAAa,CAAA,CACbC,CAAAA,CAAa,CAAA,CACbC,CAAAA,CAAe,CAAA,CACfC,CAAAA,CAAsB,MAAA,CACtBC,CAAAA,CAAc,IAAA,CAAK,GAAA,EAAI,CAG3B,SAASC,CAAAA,EAAyB,CAChC,IAAMC,CAAAA,CAAM,IAAA,CAAK,GAAA,EAAI,CACrB,GAAIA,CAAAA,CAAMF,GAAeN,CAAAA,CAAU,CACjC,IAAMS,CAAAA,CAAYJ,CAAAA,CAClBH,CAAAA,CAAa,CAAA,CACbC,CAAAA,CAAa,CAAA,CACbC,CAAAA,CAAe,CAAA,CACfC,CAAAA,CAAQ,MAAA,CACRC,CAAAA,CAAcE,CAAAA,CAEVC,CAAAA,GAAc,QAChBb,CAAAA,CAAQ,OAAA,GAAUc,CAAAA,EAAa,EAEnC,CACF,CAGA,SAASA,CAAAA,EAA0B,CACjC,IAAMC,CAAAA,CAAS,IAAI,IAAA,CAAKL,CAAAA,CAAcN,CAAQ,EAE1CY,CAAAA,CAAsC,IAAA,CAE1C,OAAIP,CAAAA,GAAU,SAAA,CACRH,CAAAA,EAAcL,CAAAA,CAAWe,CAAAA,CAAS,sBAAA,CAC7BT,CAAAA,EAAcL,CAAAA,CAAWc,CAAAA,CAAS,uBAAA,CACtCA,CAAAA,CAAS,wBAAA,CACLP,CAAAA,GAAU,WAAA,GACfH,CAAAA,EAAcL,CAAAA,CAAYI,CAAAA,CAC5BW,CAAAA,CAAS,yBAAA,CACFT,CAAAA,EAAcL,CAAAA,CAAYG,CAAAA,CACjCW,CAAAA,CAAS,0BAAA,CACNA,CAAAA,CAAS,2BAAA,CAAA,CAGT,CACL,KAAA,CAAAP,CAAAA,CACA,QAASA,CAAAA,GAAU,SAAA,CACnB,MAAA,CAAAO,CAAAA,CACA,MAAA,CAAQpB,CAAAA,CAAWU,CAAAA,CAAYL,CAAS,CAAA,CACxC,MAAA,CAAQL,CAAAA,CAAWW,CAAAA,CAAYL,CAAS,CAAA,CACxC,QAAA,CAAUN,CAAAA,CAAWY,CAAAA,CAAcL,CAAW,CAAA,CAC9C,MAAA,CAAAY,CACF,CACF,CAGA,SAASE,CAAAA,EAAsB,CAC7B,IAAMJ,CAAAA,CAAYJ,CAAAA,CAGlB,GACEH,CAAAA,EAAcL,CAAAA,EACdM,GAAcL,CAAAA,EACdM,CAAAA,EAAgBL,CAAAA,CAChB,CACAM,CAAAA,CAAQ,SAAA,CACJI,CAAAA,GAAc,SAAA,EAChBb,CAAAA,CAAQ,SAAA,GAAYc,CAAAA,EAAa,CAAA,CAEnC,MACF,CAGA,GACER,CAAAA,EAAcL,CAAAA,CAAYI,CAAAA,EAC1BE,CAAAA,EAAcL,CAAAA,CAAYG,CAAAA,EAC1BG,CAAAA,EAAgBL,CAAAA,CAAcE,CAAAA,CAC9B,CACAI,CAAAA,CAAQ,WAAA,CACJI,CAAAA,GAAc,WAAA,EAChBb,CAAAA,CAAQ,WAAA,GAAcc,GAAa,CAAA,CAErC,MACF,CAEAL,CAAAA,CAAQ,OACV,CAIA,SAASS,CAAAA,CAAOC,CAAAA,CAA0B,CACxCR,CAAAA,EAAiB,CAEjB,IAAMS,CAAAA,CAAOjC,CAAAA,CACXgC,CAAAA,CAAM,KAAA,CACNA,CAAAA,CAAM,WAAA,CACNA,CAAAA,CAAM,YAAA,CACN5B,CACF,CAAA,CAEAe,CAAAA,EAAca,CAAAA,CAAM,WAAA,CAAcA,CAAAA,CAAM,YAAA,CACxCZ,CAAAA,EAAca,CAAAA,CACdZ,CAAAA,EAAgB,EAEhBS,CAAAA,GACF,CAEA,SAASI,CAAAA,EAAoB,CAC3B,OAAAV,CAAAA,EAAiB,CACVG,CAAAA,EACT,CAEA,SAASQ,CAAAA,EAAc,CACrBX,CAAAA,EAAiB,CACjB,IAAM1B,CAAAA,CAAS6B,CAAAA,EAAY,CAC3B,GAAI7B,CAAAA,CAAO,KAAA,GAAU,SAAA,CACnB,MAAM,IAAID,CAAAA,CAAoBC,CAAM,CAExC,CAEA,SAASsC,GAAuB,CAC9B,OAAOT,CAAAA,EACT,CAEA,SAASU,CAAAA,EAAc,CACrBlB,CAAAA,CAAa,CAAA,CACbC,CAAAA,CAAa,CAAA,CACbC,CAAAA,CAAe,CAAA,CACfC,CAAAA,CAAQ,MAAA,CACRC,CAAAA,CAAc,IAAA,CAAK,GAAA,EAAI,CACvBV,CAAAA,CAAQ,OAAA,GAAUc,CAAAA,EAAa,EACjC,CAEA,OAAO,CAAE,MAAA,CAAAI,CAAAA,CAAQ,KAAA,CAAAG,CAAAA,CAAO,MAAAC,CAAAA,CAAO,QAAA,CAAAC,CAAAA,CAAU,KAAA,CAAAC,CAAM,CACjD,CCnLO,SAASC,CAAAA,CAAcC,CAAAA,CAA0C,CACtE,OAAO,CACL,KAAA,CAAOA,CAAAA,CAAS,KAAA,CAChB,WAAA,CAAaA,CAAAA,CAAS,KAAA,CAAM,YAAA,CAC5B,YAAA,CAAcA,CAAAA,CAAS,KAAA,CAAM,aAC/B,CACF,CAaO,SAASC,CAAAA,CAAWD,CAAAA,CAAuC,CAChE,OAAO,CACL,MAAOA,CAAAA,CAAS,KAAA,CAChB,WAAA,CAAaA,CAAAA,CAAS,KAAA,CAAM,aAAA,CAC5B,YAAA,CAAcA,CAAAA,CAAS,KAAA,CAAM,iBAC/B,CACF,CAKA,SAASE,CAAAA,CAAYC,CAAAA,CAA2C,CAC9D,OAAO,cAAA,GAAmBA,CAAAA,CAAwB,KACpD,CAMO,SAASC,CAAAA,CAAaJ,CAAAA,CAAuC,CAClE,OAAIE,CAAAA,CAAYF,CAAQ,CAAA,CAAUD,CAAAA,CAAcC,CAAQ,CAAA,CACjDC,CAAAA,CAAWD,CAA0B,CAC9C","file":"index.cjs","sourcesContent":["import type { GateStatus, TripReason } from \"../types/index.js\"\n\nexport class BudgetExceededError extends Error {\n  readonly reason: TripReason\n  readonly resets: Date\n  readonly snapshot: GateStatus\n\n  constructor(status: GateStatus) {\n    super(\n      `LLM gate tripped: ${status.reason ?? \"limit_exceeded\"}. ` +\n      `Resets at ${status.resets.toISOString()}.`\n    )\n    this.name = \"BudgetExceededError\"\n    this.reason = status.reason as TripReason\n    this.resets = status.resets\n    this.snapshot = status\n\n    // Maintain proper prototype chain in transpiled environments\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n","import type { PricingTable } from \"../types/index.js\";\n\n/**\n * Default pricing table for common models.\n * Prices are per token in USD.\n * Users can override via GateOptions.pricing.\n *\n * Last updated: 2026-03\n */\nexport const defaultPricing: PricingTable = {\n  // Anthropic\n  \"claude-opus-4-20250514\": {\n    inputPerToken: 0.000015,\n    outputPerToken: 0.000075,\n  },\n  \"claude-sonnet-4-20250514\": {\n    inputPerToken: 0.000003,\n    outputPerToken: 0.000015,\n  },\n  \"claude-haiku-4-5-20251001\": {\n    inputPerToken: 0.0000008,\n    outputPerToken: 0.000004,\n  },\n\n  // OpenAI\n  \"gpt-4o\": {\n    inputPerToken: 0.0000025,\n    outputPerToken: 0.00001,\n  },\n  \"gpt-4o-mini\": {\n    inputPerToken: 0.00000015,\n    outputPerToken: 0.0000006,\n  },\n  \"gpt-4-turbo\": {\n    inputPerToken: 0.00001,\n    outputPerToken: 0.00003,\n  },\n  o3: {\n    inputPerToken: 0.00001,\n    outputPerToken: 0.00004,\n  },\n  \"o4-mini\": {\n    inputPerToken: 0.0000011,\n    outputPerToken: 0.0000044,\n  },\n};\n\n/**\n * Resolve cost for a given model and token counts.\n * Falls back to 0 if model is not found in the table.\n */\nexport function resolveCost(\n  model: string,\n  inputTokens: number,\n  outputTokens: number,\n  pricing: PricingTable,\n): number {\n  const entry = pricing[model];\n  if (!entry) return 0;\n  return (\n    inputTokens * entry.inputPerToken + outputTokens * entry.outputPerToken\n  );\n}\n","import { BudgetExceededError } from \"./errors/index.js\";\nimport { defaultPricing, resolveCost } from \"./pricing/index.js\";\nimport type {\n  CircuitState,\n  GateInstance,\n  GateMetric,\n  GateOptions,\n  GateStatus,\n  ThrottleReason,\n  TripReason,\n  UsageRecord,\n} from \"./types/index.js\";\n\nconst DEFAULT_WINDOW_MS = 60_000; // 1 minute\nconst DEFAULT_THROTTLE = 0.8; // 80% of limit triggers THROTTLED\nconst SENTINEL_LIMIT = Infinity; // when a dimension is not configured\n\nfunction makeMetric(used: number, limit: number): GateMetric {\n  return {\n    used,\n    remaining: limit === Infinity ? Infinity : Math.max(0, limit - used),\n    limit: limit === Infinity ? -1 : limit,\n  };\n}\n\n/**\n * createGate — lightweight LLM budget & token guard.\n *\n * @example\n * ```ts\n * const gate = createGate({\n *   maxTokens:   5000,\n *   maxBudget:   0.10,\n *   maxRequests: 100,\n *   windowMs:    60_000,\n *   onThrottled: (s) => console.warn(\"Throttled\", s.tokens),\n *   onTripped:   (s) => console.error(\"Tripped!\", s.reason),\n *   onReset:     (s) => console.log(\"Gate reset\"),\n * })\n * ```\n */\nexport function createGate(options: GateOptions = {}): GateInstance {\n  // Config\n  const maxTokens = options.maxTokens ?? SENTINEL_LIMIT;\n  const maxBudget = options.maxBudget ?? SENTINEL_LIMIT;\n  const maxRequests = options.maxRequests ?? SENTINEL_LIMIT;\n  const windowMs = options.windowMs ?? DEFAULT_WINDOW_MS;\n  const throttleAt = options.throttleAt ?? DEFAULT_THROTTLE;\n  const pricing = { ...defaultPricing, ...options.pricing };\n\n  if (\n    maxTokens === SENTINEL_LIMIT &&\n    maxBudget === SENTINEL_LIMIT &&\n    maxRequests === SENTINEL_LIMIT\n  ) {\n    throw new Error(\n      \"[llm-gate] At least one limit must be set: maxTokens, maxBudget, or maxRequests.\",\n    );\n  }\n\n  // Internal State\n  let tokensUsed = 0;\n  let budgetUsed = 0;\n  let requestCount = 0;\n  let state: CircuitState = \"OPEN\";\n  let windowStart = Date.now();\n\n  // Window Management\n  function checkWindowReset(): void {\n    const now = Date.now();\n    if (now - windowStart >= windowMs) {\n      const prevState = state;\n      tokensUsed = 0;\n      budgetUsed = 0;\n      requestCount = 0;\n      state = \"OPEN\";\n      windowStart = now;\n\n      if (prevState !== \"OPEN\") {\n        options.onReset?.(buildStatus());\n      }\n    }\n  }\n\n  // Status Builder\n  function buildStatus(): GateStatus {\n    const resets = new Date(windowStart + windowMs);\n\n    let reason: TripReason | ThrottleReason = null;\n\n    if (state === \"TRIPPED\") {\n      if (tokensUsed >= maxTokens) reason = \"token_limit_exceeded\";\n      else if (budgetUsed >= maxBudget) reason = \"budget_limit_exceeded\";\n      else reason = \"request_limit_exceeded\";\n    } else if (state === \"THROTTLED\") {\n      if (tokensUsed >= maxTokens * throttleAt)\n        reason = \"approaching_token_limit\";\n      else if (budgetUsed >= maxBudget * throttleAt)\n        reason = \"approaching_budget_limit\";\n      else reason = \"approaching_request_limit\";\n    }\n\n    return {\n      state,\n      allowed: state !== \"TRIPPED\",\n      reason,\n      tokens: makeMetric(tokensUsed, maxTokens),\n      budget: makeMetric(budgetUsed, maxBudget),\n      requests: makeMetric(requestCount, maxRequests),\n      resets,\n    };\n  }\n\n  // State Machine\n  function evaluateState(): void {\n    const prevState = state;\n\n    // Check TRIPPED first — hard limits\n    if (\n      tokensUsed >= maxTokens ||\n      budgetUsed >= maxBudget ||\n      requestCount >= maxRequests\n    ) {\n      state = \"TRIPPED\";\n      if (prevState !== \"TRIPPED\") {\n        options.onTripped?.(buildStatus());\n      }\n      return;\n    }\n\n    // Check THROTTLED — soft warning threshold\n    if (\n      tokensUsed >= maxTokens * throttleAt ||\n      budgetUsed >= maxBudget * throttleAt ||\n      requestCount >= maxRequests * throttleAt\n    ) {\n      state = \"THROTTLED\";\n      if (prevState !== \"THROTTLED\") {\n        options.onThrottled?.(buildStatus());\n      }\n      return;\n    }\n\n    state = \"OPEN\";\n  }\n\n  // Public API\n\n  function record(usage: UsageRecord): void {\n    checkWindowReset();\n\n    const cost = resolveCost(\n      usage.model,\n      usage.inputTokens,\n      usage.outputTokens,\n      pricing,\n    );\n\n    tokensUsed += usage.inputTokens + usage.outputTokens;\n    budgetUsed += cost;\n    requestCount += 1;\n\n    evaluateState();\n  }\n\n  function check(): GateStatus {\n    checkWindowReset();\n    return buildStatus();\n  }\n\n  function guard(): void {\n    checkWindowReset();\n    const status = buildStatus();\n    if (status.state === \"TRIPPED\") {\n      throw new BudgetExceededError(status);\n    }\n  }\n\n  function snapshot(): GateStatus {\n    return buildStatus();\n  }\n\n  function reset(): void {\n    tokensUsed = 0;\n    budgetUsed = 0;\n    requestCount = 0;\n    state = \"OPEN\";\n    windowStart = Date.now();\n    options.onReset?.(buildStatus());\n  }\n\n  return { record, check, guard, snapshot, reset };\n}\n","import type { UsageRecord } from \"../types/index.js\";\n\n// Anthropic\nexport interface AnthropicUsage {\n  input_tokens: number;\n  output_tokens: number;\n}\n\nexport interface AnthropicResponse {\n  model: string;\n  usage: AnthropicUsage;\n}\n\nexport function fromAnthropic(response: AnthropicResponse): UsageRecord {\n  return {\n    model: response.model,\n    inputTokens: response.usage.input_tokens,\n    outputTokens: response.usage.output_tokens,\n  };\n}\n\n// OpenAI\nexport interface OpenAIUsage {\n  prompt_tokens: number;\n  completion_tokens: number;\n}\n\nexport interface OpenAIResponse {\n  model: string;\n  usage: OpenAIUsage;\n}\n\nexport function fromOpenAI(response: OpenAIResponse): UsageRecord {\n  return {\n    model: response.model,\n    inputTokens: response.usage.prompt_tokens,\n    outputTokens: response.usage.completion_tokens,\n  };\n}\n\n// Auto-detect\ntype AnyLLMResponse = AnthropicResponse | OpenAIResponse;\n\nfunction isAnthropic(r: AnyLLMResponse): r is AnthropicResponse {\n  return \"input_tokens\" in (r as AnthropicResponse).usage;\n}\n\n/**\n * Auto-detect provider from response shape and normalize to UsageRecord.\n * Supports Anthropic and OpenAI response formats.\n */\nexport function fromResponse(response: AnyLLMResponse): UsageRecord {\n  if (isAnthropic(response)) return fromAnthropic(response);\n  return fromOpenAI(response as OpenAIResponse);\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,116 @@
+type CircuitState = "OPEN" | "THROTTLED" | "TRIPPED";
+type TripReason = "token_limit_exceeded" | "budget_limit_exceeded" | "request_limit_exceeded" | null;
+type ThrottleReason = "approaching_token_limit" | "approaching_budget_limit" | "approaching_request_limit" | null;
+interface GateMetric {
+    used: number;
+    remaining: number;
+    limit: number;
+}
+interface GateStatus {
+    state: CircuitState;
+    allowed: boolean;
+    reason: TripReason | ThrottleReason;
+    tokens: GateMetric;
+    budget: GateMetric;
+    requests: GateMetric;
+    resets: Date;
+}
+interface UsageRecord {
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+}
+interface ModelPricing {
+    inputPerToken: number;
+    outputPerToken: number;
+}
+type PricingTable = Record<string, ModelPricing>;
+interface GateOptions {
+    maxTokens?: number;
+    maxBudget?: number;
+    maxRequests?: number;
+    windowMs?: number;
+    throttleAt?: number;
+    pricing?: PricingTable;
+    onThrottled?: (status: GateStatus) => void;
+    onTripped?: (status: GateStatus) => void;
+    onReset?: (status: GateStatus) => void;
+}
+interface GateInstance {
+    /** Record token usage from an LLM response */
+    record: (usage: UsageRecord) => void;
+    /** Check current gate status — never throws */
+    check: () => GateStatus;
+    /** Check and throw BudgetExceededError if TRIPPED */
+    guard: () => void;
+    /** Read-only snapshot of current state */
+    snapshot: () => GateStatus;
+    /** Manually reset gate to OPEN state */
+    reset: () => void;
+}
+
+/**
+ * createGate — lightweight LLM budget & token guard.
+ *
+ * @example
+ * ```ts
+ * const gate = createGate({
+ *   maxTokens:   5000,
+ *   maxBudget:   0.10,
+ *   maxRequests: 100,
+ *   windowMs:    60_000,
+ *   onThrottled: (s) => console.warn("Throttled", s.tokens),
+ *   onTripped:   (s) => console.error("Tripped!", s.reason),
+ *   onReset:     (s) => console.log("Gate reset"),
+ * })
+ * ```
+ */
+declare function createGate(options?: GateOptions): GateInstance;
+
+declare class BudgetExceededError extends Error {
+    readonly reason: TripReason;
+    readonly resets: Date;
+    readonly snapshot: GateStatus;
+    constructor(status: GateStatus);
+}
+
+interface AnthropicUsage {
+    input_tokens: number;
+    output_tokens: number;
+}
+interface AnthropicResponse {
+    model: string;
+    usage: AnthropicUsage;
+}
+declare function fromAnthropic(response: AnthropicResponse): UsageRecord;
+interface OpenAIUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+}
+interface OpenAIResponse {
+    model: string;
+    usage: OpenAIUsage;
+}
+declare function fromOpenAI(response: OpenAIResponse): UsageRecord;
+type AnyLLMResponse = AnthropicResponse | OpenAIResponse;
+/**
+ * Auto-detect provider from response shape and normalize to UsageRecord.
+ * Supports Anthropic and OpenAI response formats.
+ */
+declare function fromResponse(response: AnyLLMResponse): UsageRecord;
+
+/**
+ * Default pricing table for common models.
+ * Prices are per token in USD.
+ * Users can override via GateOptions.pricing.
+ *
+ * Last updated: 2026-03
+ */
+declare const defaultPricing: PricingTable;
+/**
+ * Resolve cost for a given model and token counts.
+ * Falls back to 0 if model is not found in the table.
+ */
+declare function resolveCost(model: string, inputTokens: number, outputTokens: number, pricing: PricingTable): number;
+
+export { type AnthropicResponse, BudgetExceededError, type CircuitState, type GateInstance, type GateMetric, type GateOptions, type GateStatus, type ModelPricing, type OpenAIResponse, type PricingTable, type ThrottleReason, type TripReason, type UsageRecord, createGate, defaultPricing, fromAnthropic, fromOpenAI, fromResponse, resolveCost };

package/dist/index.d.ts

@@ -0,0 +1,116 @@
+type CircuitState = "OPEN" | "THROTTLED" | "TRIPPED";
+type TripReason = "token_limit_exceeded" | "budget_limit_exceeded" | "request_limit_exceeded" | null;
+type ThrottleReason = "approaching_token_limit" | "approaching_budget_limit" | "approaching_request_limit" | null;
+interface GateMetric {
+    used: number;
+    remaining: number;
+    limit: number;
+}
+interface GateStatus {
+    state: CircuitState;
+    allowed: boolean;
+    reason: TripReason | ThrottleReason;
+    tokens: GateMetric;
+    budget: GateMetric;
+    requests: GateMetric;
+    resets: Date;
+}
+interface UsageRecord {
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+}
+interface ModelPricing {
+    inputPerToken: number;
+    outputPerToken: number;
+}
+type PricingTable = Record<string, ModelPricing>;
+interface GateOptions {
+    maxTokens?: number;
+    maxBudget?: number;
+    maxRequests?: number;
+    windowMs?: number;
+    throttleAt?: number;
+    pricing?: PricingTable;
+    onThrottled?: (status: GateStatus) => void;
+    onTripped?: (status: GateStatus) => void;
+    onReset?: (status: GateStatus) => void;
+}
+interface GateInstance {
+    /** Record token usage from an LLM response */
+    record: (usage: UsageRecord) => void;
+    /** Check current gate status — never throws */
+    check: () => GateStatus;
+    /** Check and throw BudgetExceededError if TRIPPED */
+    guard: () => void;
+    /** Read-only snapshot of current state */
+    snapshot: () => GateStatus;
+    /** Manually reset gate to OPEN state */
+    reset: () => void;
+}
+
+/**
+ * createGate — lightweight LLM budget & token guard.
+ *
+ * @example
+ * ```ts
+ * const gate = createGate({
+ *   maxTokens:   5000,
+ *   maxBudget:   0.10,
+ *   maxRequests: 100,
+ *   windowMs:    60_000,
+ *   onThrottled: (s) => console.warn("Throttled", s.tokens),
+ *   onTripped:   (s) => console.error("Tripped!", s.reason),
+ *   onReset:     (s) => console.log("Gate reset"),
+ * })
+ * ```
+ */
+declare function createGate(options?: GateOptions): GateInstance;
+
+declare class BudgetExceededError extends Error {
+    readonly reason: TripReason;
+    readonly resets: Date;
+    readonly snapshot: GateStatus;
+    constructor(status: GateStatus);
+}
+
+interface AnthropicUsage {
+    input_tokens: number;
+    output_tokens: number;
+}
+interface AnthropicResponse {
+    model: string;
+    usage: AnthropicUsage;
+}
+declare function fromAnthropic(response: AnthropicResponse): UsageRecord;
+interface OpenAIUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+}
+interface OpenAIResponse {
+    model: string;
+    usage: OpenAIUsage;
+}
+declare function fromOpenAI(response: OpenAIResponse): UsageRecord;
+type AnyLLMResponse = AnthropicResponse | OpenAIResponse;
+/**
+ * Auto-detect provider from response shape and normalize to UsageRecord.
+ * Supports Anthropic and OpenAI response formats.
+ */
+declare function fromResponse(response: AnyLLMResponse): UsageRecord;
+
+/**
+ * Default pricing table for common models.
+ * Prices are per token in USD.
+ * Users can override via GateOptions.pricing.
+ *
+ * Last updated: 2026-03
+ */
+declare const defaultPricing: PricingTable;
+/**
+ * Resolve cost for a given model and token counts.
+ * Falls back to 0 if model is not found in the table.
+ */
+declare function resolveCost(model: string, inputTokens: number, outputTokens: number, pricing: PricingTable): number;
+
+export { type AnthropicResponse, BudgetExceededError, type CircuitState, type GateInstance, type GateMetric, type GateOptions, type GateStatus, type ModelPricing, type OpenAIResponse, type PricingTable, type ThrottleReason, type TripReason, type UsageRecord, createGate, defaultPricing, fromAnthropic, fromOpenAI, fromResponse, resolveCost };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+var f=class extends Error{constructor(t){super(`LLM gate tripped: ${t.reason??"limit_exceeded"}. Resets at ${t.resets.toISOString()}.`),this.name="BudgetExceededError",this.reason=t.reason,this.resets=t.resets,this.snapshot=t,Object.setPrototypeOf(this,new.target.prototype);}};var R={"claude-opus-4-20250514":{inputPerToken:15e-6,outputPerToken:75e-6},"claude-sonnet-4-20250514":{inputPerToken:3e-6,outputPerToken:15e-6},"claude-haiku-4-5-20251001":{inputPerToken:8e-7,outputPerToken:4e-6},"gpt-4o":{inputPerToken:25e-7,outputPerToken:1e-5},"gpt-4o-mini":{inputPerToken:15e-8,outputPerToken:6e-7},"gpt-4-turbo":{inputPerToken:1e-5,outputPerToken:3e-5},o3:{inputPerToken:1e-5,outputPerToken:4e-5},"o4-mini":{inputPerToken:11e-7,outputPerToken:44e-7}};function k(e,t,s,u){let c=u[e];return c?t*c.inputPerToken+s*c.outputPerToken:0}var S=6e4,G=.8,m=1/0;function P(e,t){return {used:e,remaining:t===1/0?1/0:Math.max(0,t-e),limit:t===1/0?-1:t}}function w(e={}){let t=e.maxTokens??m,s=e.maxBudget??m,u=e.maxRequests??m,c=e.windowMs??S,T=e.throttleAt??G,A={...R,...e.pricing};if(t===m&&s===m&&u===m)throw new Error("[llm-gate] At least one limit must be set: maxTokens, maxBudget, or maxRequests.");let i=0,a=0,d=0,o="OPEN",l=Date.now();function g(){let n=Date.now();if(n-l>=c){let r=o;i=0,a=0,d=0,o="OPEN",l=n,r!=="OPEN"&&e.onReset?.(p());}}function p(){let n=new Date(l+c),r=null;return o==="TRIPPED"?i>=t?r="token_limit_exceeded":a>=s?r="budget_limit_exceeded":r="request_limit_exceeded":o==="THROTTLED"&&(i>=t*T?r="approaching_token_limit":a>=s*T?r="approaching_budget_limit":r="approaching_request_limit"),{state:o,allowed:o!=="TRIPPED",reason:r,tokens:P(i,t),budget:P(a,s),requests:P(d,u),resets:n}}function _(){let n=o;if(i>=t||a>=s||d>=u){o="TRIPPED",n!=="TRIPPED"&&e.onTripped?.(p());return}if(i>=t*T||a>=s*T||d>=u*T){o="THROTTLED",n!=="THROTTLED"&&e.onThrottled?.(p());return}o="OPEN";}function I(n){g();let r=k(n.model,n.inputTokens,n.outputTokens,A);i+=n.inputTokens+n.outputTokens,a+=r,d+=1,_();}function y(){return g(),p()}function O(){g();let n=p();if(n.state==="TRIPPED")throw new f(n)}function E(){return p()}function b(){i=0,a=0,d=0,o="OPEN",l=Date.now(),e.onReset?.(p());}return {record:I,check:y,guard:O,snapshot:E,reset:b}}function x(e){return {model:e.model,inputTokens:e.usage.input_tokens,outputTokens:e.usage.output_tokens}}function h(e){return {model:e.model,inputTokens:e.usage.prompt_tokens,outputTokens:e.usage.completion_tokens}}function D(e){return "input_tokens"in e.usage}function L(e){return D(e)?x(e):h(e)}export{f as BudgetExceededError,w as createGate,R as defaultPricing,x as fromAnthropic,h as fromOpenAI,L as fromResponse,k as resolveCost};//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/index.ts","../src/pricing/index.ts","../src/gate.ts","../src/adapters/index.ts"],"names":["BudgetExceededError","status","defaultPricing","resolveCost","model","inputTokens","outputTokens","pricing","entry","DEFAULT_WINDOW_MS","DEFAULT_THROTTLE","SENTINEL_LIMIT","makeMetric","used","limit","createGate","options","maxTokens","maxBudget","maxRequests","windowMs","throttleAt","tokensUsed","budgetUsed","requestCount","state","windowStart","checkWindowReset","now","prevState","buildStatus","resets","reason","evaluateState","record","usage","cost","check","guard","snapshot","reset","fromAnthropic","response","fromOpenAI","isAnthropic","r","fromResponse"],"mappings":"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","file":"index.mjs","sourcesContent":["import type { GateStatus, TripReason } from \"../types/index.js\"\n\nexport class BudgetExceededError extends Error {\n  readonly reason: TripReason\n  readonly resets: Date\n  readonly snapshot: GateStatus\n\n  constructor(status: GateStatus) {\n    super(\n      `LLM gate tripped: ${status.reason ?? \"limit_exceeded\"}. ` +\n      `Resets at ${status.resets.toISOString()}.`\n    )\n    this.name = \"BudgetExceededError\"\n    this.reason = status.reason as TripReason\n    this.resets = status.resets\n    this.snapshot = status\n\n    // Maintain proper prototype chain in transpiled environments\n    Object.setPrototypeOf(this, new.target.prototype)\n  }\n}\n","import type { PricingTable } from \"../types/index.js\";\n\n/**\n * Default pricing table for common models.\n * Prices are per token in USD.\n * Users can override via GateOptions.pricing.\n *\n * Last updated: 2026-03\n */\nexport const defaultPricing: PricingTable = {\n  // Anthropic\n  \"claude-opus-4-20250514\": {\n    inputPerToken: 0.000015,\n    outputPerToken: 0.000075,\n  },\n  \"claude-sonnet-4-20250514\": {\n    inputPerToken: 0.000003,\n    outputPerToken: 0.000015,\n  },\n  \"claude-haiku-4-5-20251001\": {\n    inputPerToken: 0.0000008,\n    outputPerToken: 0.000004,\n  },\n\n  // OpenAI\n  \"gpt-4o\": {\n    inputPerToken: 0.0000025,\n    outputPerToken: 0.00001,\n  },\n  \"gpt-4o-mini\": {\n    inputPerToken: 0.00000015,\n    outputPerToken: 0.0000006,\n  },\n  \"gpt-4-turbo\": {\n    inputPerToken: 0.00001,\n    outputPerToken: 0.00003,\n  },\n  o3: {\n    inputPerToken: 0.00001,\n    outputPerToken: 0.00004,\n  },\n  \"o4-mini\": {\n    inputPerToken: 0.0000011,\n    outputPerToken: 0.0000044,\n  },\n};\n\n/**\n * Resolve cost for a given model and token counts.\n * Falls back to 0 if model is not found in the table.\n */\nexport function resolveCost(\n  model: string,\n  inputTokens: number,\n  outputTokens: number,\n  pricing: PricingTable,\n): number {\n  const entry = pricing[model];\n  if (!entry) return 0;\n  return (\n    inputTokens * entry.inputPerToken + outputTokens * entry.outputPerToken\n  );\n}\n","import { BudgetExceededError } from \"./errors/index.js\";\nimport { defaultPricing, resolveCost } from \"./pricing/index.js\";\nimport type {\n  CircuitState,\n  GateInstance,\n  GateMetric,\n  GateOptions,\n  GateStatus,\n  ThrottleReason,\n  TripReason,\n  UsageRecord,\n} from \"./types/index.js\";\n\nconst DEFAULT_WINDOW_MS = 60_000; // 1 minute\nconst DEFAULT_THROTTLE = 0.8; // 80% of limit triggers THROTTLED\nconst SENTINEL_LIMIT = Infinity; // when a dimension is not configured\n\nfunction makeMetric(used: number, limit: number): GateMetric {\n  return {\n    used,\n    remaining: limit === Infinity ? Infinity : Math.max(0, limit - used),\n    limit: limit === Infinity ? -1 : limit,\n  };\n}\n\n/**\n * createGate — lightweight LLM budget & token guard.\n *\n * @example\n * ```ts\n * const gate = createGate({\n *   maxTokens:   5000,\n *   maxBudget:   0.10,\n *   maxRequests: 100,\n *   windowMs:    60_000,\n *   onThrottled: (s) => console.warn(\"Throttled\", s.tokens),\n *   onTripped:   (s) => console.error(\"Tripped!\", s.reason),\n *   onReset:     (s) => console.log(\"Gate reset\"),\n * })\n * ```\n */\nexport function createGate(options: GateOptions = {}): GateInstance {\n  // Config\n  const maxTokens = options.maxTokens ?? SENTINEL_LIMIT;\n  const maxBudget = options.maxBudget ?? SENTINEL_LIMIT;\n  const maxRequests = options.maxRequests ?? SENTINEL_LIMIT;\n  const windowMs = options.windowMs ?? DEFAULT_WINDOW_MS;\n  const throttleAt = options.throttleAt ?? DEFAULT_THROTTLE;\n  const pricing = { ...defaultPricing, ...options.pricing };\n\n  if (\n    maxTokens === SENTINEL_LIMIT &&\n    maxBudget === SENTINEL_LIMIT &&\n    maxRequests === SENTINEL_LIMIT\n  ) {\n    throw new Error(\n      \"[llm-gate] At least one limit must be set: maxTokens, maxBudget, or maxRequests.\",\n    );\n  }\n\n  // Internal State\n  let tokensUsed = 0;\n  let budgetUsed = 0;\n  let requestCount = 0;\n  let state: CircuitState = \"OPEN\";\n  let windowStart = Date.now();\n\n  // Window Management\n  function checkWindowReset(): void {\n    const now = Date.now();\n    if (now - windowStart >= windowMs) {\n      const prevState = state;\n      tokensUsed = 0;\n      budgetUsed = 0;\n      requestCount = 0;\n      state = \"OPEN\";\n      windowStart = now;\n\n      if (prevState !== \"OPEN\") {\n        options.onReset?.(buildStatus());\n      }\n    }\n  }\n\n  // Status Builder\n  function buildStatus(): GateStatus {\n    const resets = new Date(windowStart + windowMs);\n\n    let reason: TripReason | ThrottleReason = null;\n\n    if (state === \"TRIPPED\") {\n      if (tokensUsed >= maxTokens) reason = \"token_limit_exceeded\";\n      else if (budgetUsed >= maxBudget) reason = \"budget_limit_exceeded\";\n      else reason = \"request_limit_exceeded\";\n    } else if (state === \"THROTTLED\") {\n      if (tokensUsed >= maxTokens * throttleAt)\n        reason = \"approaching_token_limit\";\n      else if (budgetUsed >= maxBudget * throttleAt)\n        reason = \"approaching_budget_limit\";\n      else reason = \"approaching_request_limit\";\n    }\n\n    return {\n      state,\n      allowed: state !== \"TRIPPED\",\n      reason,\n      tokens: makeMetric(tokensUsed, maxTokens),\n      budget: makeMetric(budgetUsed, maxBudget),\n      requests: makeMetric(requestCount, maxRequests),\n      resets,\n    };\n  }\n\n  // State Machine\n  function evaluateState(): void {\n    const prevState = state;\n\n    // Check TRIPPED first — hard limits\n    if (\n      tokensUsed >= maxTokens ||\n      budgetUsed >= maxBudget ||\n      requestCount >= maxRequests\n    ) {\n      state = \"TRIPPED\";\n      if (prevState !== \"TRIPPED\") {\n        options.onTripped?.(buildStatus());\n      }\n      return;\n    }\n\n    // Check THROTTLED — soft warning threshold\n    if (\n      tokensUsed >= maxTokens * throttleAt ||\n      budgetUsed >= maxBudget * throttleAt ||\n      requestCount >= maxRequests * throttleAt\n    ) {\n      state = \"THROTTLED\";\n      if (prevState !== \"THROTTLED\") {\n        options.onThrottled?.(buildStatus());\n      }\n      return;\n    }\n\n    state = \"OPEN\";\n  }\n\n  // Public API\n\n  function record(usage: UsageRecord): void {\n    checkWindowReset();\n\n    const cost = resolveCost(\n      usage.model,\n      usage.inputTokens,\n      usage.outputTokens,\n      pricing,\n    );\n\n    tokensUsed += usage.inputTokens + usage.outputTokens;\n    budgetUsed += cost;\n    requestCount += 1;\n\n    evaluateState();\n  }\n\n  function check(): GateStatus {\n    checkWindowReset();\n    return buildStatus();\n  }\n\n  function guard(): void {\n    checkWindowReset();\n    const status = buildStatus();\n    if (status.state === \"TRIPPED\") {\n      throw new BudgetExceededError(status);\n    }\n  }\n\n  function snapshot(): GateStatus {\n    return buildStatus();\n  }\n\n  function reset(): void {\n    tokensUsed = 0;\n    budgetUsed = 0;\n    requestCount = 0;\n    state = \"OPEN\";\n    windowStart = Date.now();\n    options.onReset?.(buildStatus());\n  }\n\n  return { record, check, guard, snapshot, reset };\n}\n","import type { UsageRecord } from \"../types/index.js\";\n\n// Anthropic\nexport interface AnthropicUsage {\n  input_tokens: number;\n  output_tokens: number;\n}\n\nexport interface AnthropicResponse {\n  model: string;\n  usage: AnthropicUsage;\n}\n\nexport function fromAnthropic(response: AnthropicResponse): UsageRecord {\n  return {\n    model: response.model,\n    inputTokens: response.usage.input_tokens,\n    outputTokens: response.usage.output_tokens,\n  };\n}\n\n// OpenAI\nexport interface OpenAIUsage {\n  prompt_tokens: number;\n  completion_tokens: number;\n}\n\nexport interface OpenAIResponse {\n  model: string;\n  usage: OpenAIUsage;\n}\n\nexport function fromOpenAI(response: OpenAIResponse): UsageRecord {\n  return {\n    model: response.model,\n    inputTokens: response.usage.prompt_tokens,\n    outputTokens: response.usage.completion_tokens,\n  };\n}\n\n// Auto-detect\ntype AnyLLMResponse = AnthropicResponse | OpenAIResponse;\n\nfunction isAnthropic(r: AnyLLMResponse): r is AnthropicResponse {\n  return \"input_tokens\" in (r as AnthropicResponse).usage;\n}\n\n/**\n * Auto-detect provider from response shape and normalize to UsageRecord.\n * Supports Anthropic and OpenAI response formats.\n */\nexport function fromResponse(response: AnyLLMResponse): UsageRecord {\n  if (isAnthropic(response)) return fromAnthropic(response);\n  return fromOpenAI(response as OpenAIResponse);\n}\n"]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@ekaone/llm-gate",
+  "version": "0.0.1",
+  "description": "Lightweight LLM budget & token guard. Prevents Denial of Wallet attacks with a circuit-breaker state machine.",
+  "keywords": [
+    "llm",
+    "token",
+    "budget",
+    "guard",
+    "circuit-breaker",
+    "ai",
+    "anthropic",
+    "openai",
+    "rate-limit",
+    "agent"
+  ],
+  "author": {
+    "name": "Eka Prasetia",
+    "email": "ekaone3033@gmail.com",
+    "url": "https://prasetia.me"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ekaone/llm-gate.git"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/ui": "^4.1.0",
+    "rimraf": "^6.1.3",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage"
+  }
+}