Rulvar API reference / @rulvar/core / BudgetReserve
Interface: BudgetReserve
Defined in: packages/core/src/orchestrator/admission.ts:56
Layer-1 reservation embedded in the carrying decision entry.
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
childCeilingUsd? | number | The child sub-account ceiling; absent when the parent is uncapped. | packages/core/src/orchestrator/admission.ts:59 |
clampedBy? | "explicit-budget" | "fraction-ceiling" | Set when the derived reserve was clamped DOWN to the child's ceiling: 'explicit-budget' by a declared budgetUsd, 'fraction-ceiling' by the childBudgetFraction allowance an ORIGIN WITH a materialized allowance account enforces (ctx.workflow). The spawn-tool path never carries 'fraction-ceiling': its dispatch enforces no fraction account, and journaling that clamp is exactly the parity rerun's 0.50-versus-0.70 lie (RV2004). | packages/core/src/orchestrator/admission.ts:76 |
reserveUsd | number | - | packages/core/src/orchestrator/admission.ts:57 |
source? | "estCost" | "default" | The reserve derivation (RV2004): where reserveUsd came from, so a journal reader never reverse-engineers the arithmetic. 'estCost' is the declared estimate (spawn opts or the agentType profile), 'default' the engine flat reserve. | packages/core/src/orchestrator/admission.ts:66 |