DocsChangelog

BudgetGuard

Set spending and rate limits that are enforced automatically, in-process. 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
Separate from provider reliability. BudgetGuard enforces spending limits before calls are sent. Provider-call retry and fallbacks are configured under Reliability.
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

Command Palette

Search for a command to run...