fabro/docs/public/execution
Bryan Helmkamp b32164b086
Add [run.limits] run budgets: halt runs on token/cost spend
A run can now carry an optional spend budget. New [run.limits] settings
table with max_cost (USD) and max_tokens; when accumulated LLM spend
exceeds either limit, the run halts immediately and fails with the
existing BudgetExhausted failure reason.

- RunBudget (fabro-model): thread-safe accumulator shared across the
  engine, agent sessions, hooks, and the prompt path. Charges per LLM
  response; queues one-shot 80% warnings drained into run notices.
- Enforcement is inline at every usage-recording site: the agent turn
  loop (interrupting like the wall-clock timeout via a new
  InterruptReason::BudgetExhausted), subagent sessions, the one-shot
  prompt path with schema-repair retries, context compaction, web_fetch
  summarization, and prompt/agent hooks (which skip once the budget is
  spent, matching their fail-open posture).
- Budget exhaustion terminates the run as an engine-level error
  (fabro_core::Error::BudgetExhausted, following the StallTimeout
  pattern) so fail edges are not followed, plus a between-stage gate for
  non-LLM stages and a run-start gate that makes a resumed
  budget-failed run fail fast until the limit is raised (spend is
  seeded from the billing projection).
- Exposed on the RunNamespace OpenAPI schema (RunLimitsSettings);
  Rust and TypeScript clients regenerated; docs updated.

Known gaps, by design for now: ACP external agents report no usable
per-response usage (cumulative UsageUpdate capture is a follow-up), and
post-run PR content generation is outside the engine.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-06 14:22:10 -04:00
..
automations.mdx Migrate automations to SQLite 2026-07-22 13:32:35 -04:00
checkpoints.mdx docs: sync product documentation 2026-07-24 11:39:16 -04:00
child-runs.mdx docs: add child runs guide 2026-05-25 15:43:53 -04:00
context.mdx Merge remote-tracking branch 'origin/main' into feat/for-each-item-injection 2026-07-28 20:03:25 -04:00
environments.mdx refactor(config): stop resolving {{ env.* }} in interpolated config 2026-07-27 21:09:35 -04:00
failures.mdx feat: add model-keyed fallback policies 2026-07-30 12:02:41 -04:00
observability.mdx Add runtime for_each item injection 2026-07-27 11:55:55 -04:00
outcomes.mdx Add runtime for_each item injection 2026-07-27 11:55:55 -04:00
run-configuration.mdx Add [run.limits] run budgets: halt runs on token/cost spend 2026-08-06 14:22:10 -04:00