Skip to content

Rulvar API reference


Rulvar API reference / @rulvar/core / AgentInvocationRow

Interface: AgentInvocationRow

Defined in: packages/core/src/l0/telemetry-reduce.ts:47

One logical agent span.

Properties

PropertyTypeDescriptionDefined in
agentTypestring-packages/core/src/l0/telemetry-reduce.ts:49
costBasisCostBasisThe 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/src/l0/telemetry-reduce.ts:62
costUsdnumber-packages/core/src/l0/telemetry-reduce.ts:56
hostRejected?booleanPresent 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/src/l0/telemetry-reduce.ts:80
label?string-packages/core/src/l0/telemetry-reduce.ts:50
openbooleanTrue when the span's agent:end never arrived.packages/core/src/l0/telemetry-reduce.ts:72
phasesPhaseRow[]-packages/core/src/l0/telemetry-reduce.ts:81
replayedboolean-packages/core/src/l0/telemetry-reduce.ts:70
retryCountnumber-packages/core/src/l0/telemetry-reduce.ts:64
role?stringThe primary role from agent:start.packages/core/src/l0/telemetry-reduce.ts:52
spanIdstring-packages/core/src/l0/telemetry-reduce.ts:48
status?stringFrom agent:end; absent while the span is open.packages/core/src/l0/telemetry-reduce.ts:54
toolBudget?ToolBudgetSummaryThe tool budget pressure snapshot (RV304), carried through from the live agent:end. Absent on replayed rows and unbounded loops.packages/core/src/l0/telemetry-reduce.ts:69
usageUsage-packages/core/src/l0/telemetry-reduce.ts:55
usageApproxboolean-packages/core/src/l0/telemetry-reduce.ts:63