Rulvar API reference / @rulvar/rulvar / AgentInvocationRow
Interface: AgentInvocationRow
Defined in: packages/core/dist/index.d.ts
One logical agent span.
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
agentType | string | - | packages/core/dist/index.d.ts |
costBasis | CostBasis | The fold behind costUsd (RV702), from the span's agent:end; an absent field (a pre-RV702 stream, or a span still open) reduces to 'aggregate-estimate', never to a per-call claim it cannot back. | packages/core/dist/index.d.ts |
costUsd | number | - | packages/core/dist/index.d.ts |
hostRejected? | boolean | Present and true when the invocation was aborted by the host's finish rejection (RV3702): the declared finish contract rejected the candidate past its repair bound, so the span died by host hand with its wires fine. From the agent:end stamp; absent everywhere else. | packages/core/dist/index.d.ts |
label? | string | - | packages/core/dist/index.d.ts |
open | boolean | True when the span's agent:end never arrived. | packages/core/dist/index.d.ts |
phases | PhaseRow[] | - | packages/core/dist/index.d.ts |
replayed | boolean | - | packages/core/dist/index.d.ts |
retryCount | number | - | packages/core/dist/index.d.ts |
role? | string | The primary role from agent:start. | packages/core/dist/index.d.ts |
spanId | string | - | packages/core/dist/index.d.ts |
status? | string | From agent:end; absent while the span is open. | packages/core/dist/index.d.ts |
toolBudget? | ToolBudgetSummary | The tool budget pressure snapshot (RV304), carried through from the live agent:end. Absent on replayed rows and unbounded loops. | packages/core/dist/index.d.ts |
usage | Usage | - | packages/core/dist/index.d.ts |
usageApprox | boolean | - | packages/core/dist/index.d.ts |