Rulvar API reference / @rulvar/rulvar / CostAttributionFacts
Interface: CostAttributionFacts
Defined in: packages/core/dist/index.d.ts
Cost-attribution facts a live run knows at settlement and a pure journal fold cannot re-derive: the innermost phase name at the call site, the agent profile, the primary invocation role, the budget account the call debited, and whether the dispatch spent the orchestrator finalize reserve. Policy, never identity, exactly like usageByModel: none of it enters the content key, and entries written before the field shipped fold under the documented fallback buckets (empty phase, 'unknown' agent type, role 'loop').
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
agentType? | string | - | packages/core/dist/index.d.ts |
budgetAccount? | string | - | packages/core/dist/index.d.ts |
finalizeReserve? | boolean | - | packages/core/dist/index.d.ts |
label? | string | The dispatch label, when the caller gave one (RV2803): what tells two spans of ONE role apart, which the event stream has always carried and the journal never did. Absent on every unlabelled dispatch and on every journal written before it shipped, so a reading that needs it reports absence rather than guessing. Policy, never identity. | packages/core/dist/index.d.ts |
phase? | string | - | packages/core/dist/index.d.ts |
repairTrigger? | "claim" | "citation" | "coverage" | "combined" | What dispatched a semantic repair round (RV4105): 'claim' (the RV3307 contradiction round), 'citation' (the RV4004 entailment round), 'coverage' (the RV4202 round armed by a non-'full' final grade alone), or 'combined' (one bounded round carrying more than one defect class, RV4202), stamped at dispatch beside phase: 'repair', so the repair ledger attributes the round without cross-reading metas. Absent on every other dispatch and on journals written before it shipped (absence means NOT RECORDED, RV1209). Policy, never identity. | packages/core/dist/index.d.ts |
role? | InvocationRole | - | packages/core/dist/index.d.ts |