Money and turns
A cost pause preserves work
A call which exceeds its reservation still receives acceptance checks. Passing work stays accepted. The engine closes admission for more paid work and pauses the run before the next item. Status shows blocked with a cost reason.
e11 runs status <run>
e11 runs resume <run> --raise-ceiling 80Raise-ceiling sets a new total ceiling of 80 USD in this example. The command records the approving principal and resumes the existing run. Other policy changes require e11 runs successor. A successor seals a fresh plan and repeats work already done, so use a ceiling increase for a money pause.
Turns belong to an invocation
A worker invocation receives 400 turns by default. At its turn or budget allowance, the engine resumes the same session as a continuation of the same attempt. Modified and untracked files stay in the worktree. Each continuation receives its own reservation, settlement, and evidence. Acceptance judges the attempt once against its starting point.
The default allows three continuations per attempt. Exhausting those continuations blocks the item for an operator decision. Inspect the evidence, then use e11 runs retry <run> --work-item <id> when another attempt is appropriate.
How the ceiling is calculated
The current default ceiling equals planned items multiplied by one call’s allowance, with 25 percent headroom for continuations and retries. Two items with a 10 USD allowance produce a 25 USD default ceiling. An explicit --max-cost-usd replaces this calculation.
Each call reserves its allowance or the remaining ceiling, whichever is smaller. The run pauses when less than one tenth of the allowance remains. Read the printed calculation for your run.
Check your price list
Commit .foundry/pricing.json with your project. Doctor compares your rates with the CLI’s published table and reports differences in either direction. The engine calculates settlement from usage and pinned rates. The runtime reports its own charge separately. These values use different accounting inputs, so compare both figures when reviewing spend.