rulvar API reference / @rulvar/core / CostReport
Interface: CostReport
Defined in: packages/core/src/engine/run-handle.ts:24
Full contract: https://docs.rulvar.com/guide/observability.
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
byAgentType | Record<string, number> | - | packages/core/src/engine/run-handle.ts:30 |
byModel | Record<string, number> | Keyed by canonical ModelRef 'adapterId:model'. | packages/core/src/engine/run-handle.ts:27 |
byPhase | Record<string, number> | ctx.phase names; phase is structural for this map. | packages/core/src/engine/run-handle.ts:29 |
byRole | Record<InvocationRole, number> | - | packages/core/src/engine/run-handle.ts:31 |
orchestrator | { forcedFinish: boolean; reserveUsedUsd: number; share: number; spentUsd: number; wakes: number; } | All-zero with forcedFinish false in runs without a dynamic orchestrator. | packages/core/src/engine/run-handle.ts:33 |
orchestrator.forcedFinish | boolean | - | packages/core/src/engine/run-handle.ts:38 |
orchestrator.reserveUsedUsd | number | - | packages/core/src/engine/run-handle.ts:39 |
orchestrator.share | number | spentUsd / max(totalUsd, 0.01): the epsilon-floored H-OrchShare input. | packages/core/src/engine/run-handle.ts:36 |
orchestrator.spentUsd | number | - | packages/core/src/engine/run-handle.ts:34 |
orchestrator.wakes | number | - | packages/core/src/engine/run-handle.ts:37 |
totalUsd | number | - | packages/core/src/engine/run-handle.ts:25 |
unpriced | { model: string; usage: Usage; }[] | Usage on models absent from pricing; never a silent zero. | packages/core/src/engine/run-handle.ts:42 |