Rulvar API reference

---

Rulvar API reference / @rulvar/rulvar / ExplorationSummary

Interface: ExplorationSummary

Defined in: packages/core/dist/index.d.ts

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/dist/index.d.ts
deniedRepeats	number	Calls denied by the repeated-signature guard (never dispatched).	packages/core/dist/index.d.ts
deniedToolCap?	number	Calls denied by maxCallsPerTool; present when that limit is configured.	packages/core/dist/index.d.ts
distinctSignatures	number	Distinct (tool name, canonical args) signatures executed.	packages/core/dist/index.d.ts
duplicateResultCalls	number	Successful executions whose result digest was already seen.	packages/core/dist/index.d.ts
repeatedCalls	number	Executions of a signature that had already executed before.	packages/core/dist/index.d.ts
toolCallsUsed	number	Tool executions dispatched by the loop (the loop's own counter).	packages/core/dist/index.d.ts
toolUnitsUsed?	number	Weighted tool units spent; present when toolUnits is configured.	packages/core/dist/index.d.ts