Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/rulvar / BudgetReserve

Interface: BudgetReserve

Defined in: packages/core/dist/index.d.ts

Layer-1 reservation embedded in the carrying decision entry.

Properties

PropertyTypeDescriptionDefined in
childCeilingUsd?numberThe child sub-account ceiling; absent when the parent is uncapped.packages/core/dist/index.d.ts
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/dist/index.d.ts
reserveUsdnumber-packages/core/dist/index.d.ts
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/dist/index.d.ts