Rulvar API reference / @rulvar/core / ExplorationSummary
Interface: ExplorationSummary
Defined in: packages/core/src/l0/events.ts:229
The structured exploration summary (RV-210): the engine-side tool exploration counters for one agent invocation. Attached to the full AgentResult and to the live agent:end event whenever any exploration guard limit is configured; journaled inside the terminal error payload (and therefore restored on replay) only when the guard itself ended the invocation (abortClass 'exploration').
Properties
| Property | Type | Description | Defined in |
|---|---|---|---|
byTool | Record<string, number> | Executions per tool name. | packages/core/src/l0/events.ts:241 |
deniedRepeats | number | Calls denied by the repeated-signature guard (never dispatched). | packages/core/src/l0/events.ts:239 |
deniedToolCap? | number | Calls denied by maxCallsPerTool; present when that limit is configured. | packages/core/src/l0/events.ts:243 |
distinctSignatures | number | Distinct (tool name, canonical args) signatures executed. | packages/core/src/l0/events.ts:233 |
duplicateResultCalls | number | Successful executions whose result digest was already seen. | packages/core/src/l0/events.ts:237 |
repeatedCalls | number | Executions of a signature that had already executed before. | packages/core/src/l0/events.ts:235 |
toolCallsUsed | number | Tool executions dispatched by the loop (the loop's own counter). | packages/core/src/l0/events.ts:231 |
toolUnitsUsed? | number | Weighted tool units spent; present when toolUnits is configured. | packages/core/src/l0/events.ts:245 |