BudgetGuard

Prevent rogue agent cascades with client-side spend and rate limits. Evaluated locally with zero network latency.

Agent hint

Use for max_cost_per_minute, max_cost_per_session, on_budget_exceeded throw/warn/webhook.

In scope

  • budget_guard / budgetGuard config
  • Per-wrap() overrides
  • AurexBudgetExceeded

Out of scope

  • Provider retry/fallback — see Reliability docs
  • Backend ingest rate limits — see Rate Limits
Not provider resilience. BudgetGuard blocks overspend before calls. Provider-call retry and fallbacks live under Reliability & Loss Recovery.
PythonNode.jsTypeDescription
max_cost_per_minutemaxCostPerMinutefloatMax USD spend per rolling 60s.
max_cost_per_sessionmaxCostPerSessionfloatMax USD per workflow_id.
max_requests_per_minutemaxRequestsPerMinuteintegerRequest count cap per minute.
max_context_tokensmaxContextTokensintegerEstimated input token cap.
on_budget_exceededonBudgetExceededstringthrow | warn | webhook
webhook_urlwebhookUrlstringWebhook destination when configured.
dry_rundryRunbooleanEvaluate without blocking.

See also