budget-gate-check

What problem does it solve?

Centralizes and enforces cost controls for LLM usage by agents to prevent budget overruns and unpredictable fallback behavior.

Core Features & Use Cases

• Pre-call budget gating: ensures a call is allowed only if there is remaining daily budget.
• Cost computation and headroom checks: uses actual usage to compute cost and reserve intraday headroom for trading agent.
• Fallback and safe behavior: integrates with safe fallback when budget is exhausted.
• Usage recording: logs actual tokens used after each call.
• Scope and configuration: applies to addition of new LLM calls, model changes, max_tokens_per_call changes, or scan frequency and market count adjustments.
• Intraday budget reservation: reserves 30% intraday budget for trading agent.

Quick Start

Before every LLM call, invoke the budget gate to verify available daily budget and proceed only if allowed.