Module utility 

Utility-guided tool dispatch gate (arXiv:2603.19896).

Computes a scalar utility score for each candidate tool call before execution. Calls below the configured threshold are skipped (fail-closed on scoring errors).

Structs

UtilityContext

Context required to compute utility — provided by the agent loop.

UtilityScore

Computed utility components for a candidate tool call.

UtilityScorer

Computes utility scores for tool calls before dispatch.

Enums

UtilityAction

Recommended action from the utility policy (arXiv:2603.19896, §4.2).

Functions

has_explicit_tool_request

Returns true when a user message explicitly requests tool invocation.